Пакет java.nio.file

Определяет интерфейсы и классы для доступа к файлам, атрибутам файлов и файловым системам в виртуальной машине Java.

Пакет java.nio.file определяет классы для доступа к файлам и файловым системам. API для доступа к атрибутам файлов и файловых систем определен в пакете java.nio.file.attribute. Пакет java.nio.file.spi используется реализаторами поставщиков сервисов, желающими расширить платформенный поставщик по умолчанию или создать другие реализации поставщиков.

Символические ссылки

Многие операционные системы и файловые системы поддерживают символические ссылки. Символическая ссылка — это специальный файл, который служит ссылкой на другой файл. В основном, символические ссылки прозрачны для приложений, и операции со символическими ссылками автоматически перенаправляются на целевой файл ссылки. Исключением являются случаи удаления или переименования/перемещения символической ссылки, в которых случае ссылка удаляется или удаляется, а не целевой файл ссылки. Этот пакет включает поддержку символических ссылок, где реализации обеспечивают эти семантики. Файловые системы могут поддерживать другие типы, которые семантически близки, но поддержка других типов ссылок не включена в этот пакет.

Взаимодействие

Класс File определяет метод toPath для построения Path путем преобразования абстрактного пути, представленного объектом java.io.File. Полученный Path может использоваться для работы с тем же файлом, что и объект File. Спецификация Path предоставляет дополнительную информацию о взаимодействии взаимодействии между объектами Path и java.io.File.

Видимость

Представление файлов и файловой системы, предоставляемое классами в этом пакете, гарантированно согласуется с другими представлениями, предоставляемыми другими экземплярами в той же виртуальной машине Java. Однако представление может или не может согласовываться с представлением файловой системы, видимым другими одновременно работающими программами из-за кэширования, выполняемого базовой операционной системой, и задержек, вызванных протоколами сетевых файловых систем. Это верно независимо от языка, на котором написаны эти другие программы, и от того, работают ли они на одном компьютере или на другом. Точный характер таких несоответствий зависит от системы и поэтому не определен.

Целостность синхронизированного ввода-вывода файлов

Опции SYNC и DSYNC используются при открытии файла, чтобы потребовать, чтобы обновления файла были синхронно записаны на базовое устройство хранения. В случае с поставщиком по умолчанию и если файл находится на локальном устройстве хранения, а канал seekable подключен к файлу, открытому с одной из этих опций, то вызов метода write гарантированно вернет только тогда, когда все изменения, внесенные в файл этим вызовом, были записаны на устройство. Эти опции полезны для обеспечения того, что критическая информация не потеряется в случае сбоя системы. Если файл не находится на локальном устройстве, то такая гарантия не предоставляется. Возможно ли эта гарантия с другими реализациями provider зависит от конкретного поставщика.

Общие исключения

Если не указано иное, передача аргумента null конструктору или методу любого класса или интерфейса в этом пакете приведет к выбросу исключения NullPointerException. Кроме того, вызов метода с массивом или коллекцией, содержащей элемент null, приведет к выбросу исключения NullPointerException, если не указано иное.

Если не указано иное, методы, которые пытаются получить доступ к файловой системе, будут выбрасывать ClosedFileSystemException при вызове на объектах, связанных с FileSystem, который был закрыт closed. Кроме того, любые методы, которые пытаются получить доступ для записи в файловую систему, будут выбрасывать ReadOnlyFileSystemException при вызове на объекте, связанном с FileSystem, предоставляющем только чтение.

Если не указано иное, вызов метода любого класса или интерфейса в этом пакете, созданного одним provider, с параметром, являющимся объектом, созданным другим поставщиком, приведет к выбросу исключения ProviderMismatchException.

Дополнительные специфические исключения

Большинство методов, определенных классами в этом пакете, которые обращаются к файловой системе, указывают, что при возникновении ошибки ввода-вывода должно быть выброшено исключение IOException. В некоторых случаях эти методы определяют специфические исключения ввода-вывода для распространенных случаев. Эти исключения, указанные как дополнительные специфические исключения, выбрасываются реализацией, когда она может определить конкретную ошибку. Если конкретная ошибка не может быть определена, то выбрасывается более общее исключение IOException.