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