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

С:

1.7

END_OF_DOCUMENT_MARKER