Пакет 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.