Пакет 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, если не указано иное.

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

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

Необязательные специализированные исключения

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