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