Пакет java.nio.file

Определяет интерфейсы и классы для виртуальной машины Java, чтобы получить доступ к файлам, атрибутам файла, и файловым системам.

См.: Описание

Интерфейсная Сводка

Интерфейс	Описание
CopyOption	Объект, который конфигурирует, как скопировать или переместить файл.
DirectoryStream <T>	Объект выполнить итерации по записям в каталоге.
DirectoryStream. Фильтр <T>	Интерфейс, который реализуется объектами, которые решают, должна ли запись каталога быть принята или фильтроваться.
FileVisitor <T>	Посетитель файлов.
OpenOption	Объект, который конфигурирует, как открыть или создать файл.
Путь	Объект, который может использоваться, чтобы определить местоположение файла в файловой системе.
PathMatcher	Интерфейс, который реализуется объектами, которые выполняют операции соответствия на путях.
SecureDirectoryStream <T>	A DirectoryStream это определяет операции на файлах, которые располагаются относительно открытого каталога.
Смотрибельный	Объект, который может быть зарегистрирован в службе часов так, чтобы это могло наблюдаться за изменениями и событиями.
WatchEvent <T>	Событие или повторное событие для объекта, который регистрируется в a WatchService.
WatchEvent. Вид <T>	Вид события, в целях идентификации.
WatchEvent. Модификатор	Модификатор события, который квалифицирует как a Watchable регистрируется в a WatchService.
WatchKey	Маркер, представляющий регистрацию a watchable объект с a WatchService.
WatchService	Служба часов, которая наблюдает зарегистрированные объекты за изменениями и событиями.

Сводка класса

Класс	Описание
Файлы	Этот класс состоит исключительно из статических методов, которые работают на файлах, каталогах, или других типах файлов.
FileStore	Хранение для файлов.
FileSystem	Обеспечивает интерфейс для файловой системы и фабрика для объектов получить доступ к файлам и другим объектам в файловой системе.
FileSystems	Методы фабрики для файловых систем.
LinkPermission	Permission класс для операций создания ссылки.
Пути	Этот класс состоит исключительно из статических методов тот возврат a Path преобразовывая строку пути или URI.
SimpleFileVisitor <T>	Простой посетитель файлов с поведением по умолчанию, чтобы посетить все файлы и повторно бросить ошибки ввода-вывода.
StandardWatchEventKinds	Определяет стандартные виды события.

Перечислимая Сводка

Перечисление	Описание
AccessMode	Определяет режимы доступа, используемые, чтобы протестировать доступность файла.
FileVisitOption	Определяет опции обхода дерева файла.
FileVisitResult	Тип результата a FileVisitor.
LinkOption	Определяет опции относительно того, как обрабатываются символьные ссылки.
StandardCopyOption	Определяет стандартные опции копии.
StandardOpenOption	Определяет стандартные открытые опции.

Сводка исключения

Исключение	Описание
AccessDeniedException	Проверенное исключение, выданное, когда работа файловой системы отрицается, обычно из-за разрешения файла или другой проверки прав доступа.
AtomicMoveNotSupportedException	Проверенное исключение, выданное, когда файл не может быть перемещен как атомарная работа файловой системы.
ClosedDirectoryStreamException	Исключение непроверенное, выданное, когда попытка предпринимается, чтобы вызвать работу на поток каталога, который закрывается.
ClosedFileSystemException	Исключение непроверенное, выданное, когда попытка предпринимается, чтобы вызвать работу на файл и файловую систему, закрывается.
ClosedWatchServiceException	Исключение непроверенное, выданное, когда попытка предпринимается, чтобы вызвать работу на службу часов, которая закрывается.
DirectoryIteratorException	Исключение на этапе выполнения, брошенное, если с ошибкой ввода-вывода встречаются, выполняя итерации по записям в каталоге.
DirectoryNotEmptyException	Проверенное исключение, выданное, когда работа файловой системы перестала работать, потому что каталог не пуст.
FileAlreadyExistsException	Проверенное исключение, выданное, когда попытка предпринимается, чтобы создать файл или каталог и файл того имени уже, существует.
FileSystemAlreadyExistsException	Исключение на этапе выполнения, брошенное, когда попытка предпринимается, чтобы создать файловую систему, которая уже существует.
FileSystemException	Брошенный, когда работа файловой системы перестала работать на одном или двух файлах.
FileSystemLoopException	Проверенное исключение, выданное, когда с циклом файловой системы, или циклом, встречаются.
FileSystemNotFoundException	Исключение на этапе выполнения, брошенное, когда файловая система не может быть найдена.
InvalidPathException	Исключение непроверенное, выданное, когда строка пути не может быть преобразована в a Path потому что строка пути содержит недопустимые символы, или строка пути недопустима для другой файловой системы определенные причины.
NoSuchFileException	Проверенное исключение, выданное, когда попытка предпринимается, чтобы получить доступ к файлу, который не существует.
NotDirectoryException	Проверенное исключение, выданное, когда работа файловой системы, предназначенная для каталога, перестала работать, потому что файл не является каталогом.
NotLinkException	Проверенное исключение, выданное, когда работа файловой системы перестала работать, потому что файл не является символьной ссылкой.
ProviderMismatchException	Исключение непроверенное, выданное, когда попытка предпринимается, чтобы вызвать метод на объект, создаваемый одним провайдером файловой системы с параметром, создаваемым различным провайдером файловой системы.
ProviderNotFoundException	Исключение на этапе выполнения, брошенное, когда провайдер необходимого типа не может быть найден.
ReadOnlyFileSystemException	Исключение непроверенное, выданное, когда попытка предпринимается, чтобы обновить объект, связанный с a read-only FileSystem.

Пакет java.nio.file Описание

Определяет интерфейсы и классы для виртуальной машины Java, чтобы получить доступ к файлам, атрибутам файла, и файловым системам.

java.nio.file пакет определяет классы файлов доступа и файловых систем. API, чтобы получить доступ к атрибутам файловой и файловой системы определяется в java.nio.file.attribute пакет. java.nio.file.spi пакет используется конструкторами поставщика услуг, желающими расширить провайдера значения по умолчанию платформы, или создать другие реализации провайдера.

Символьные ссылки

Много операционных систем и файловых систем поддерживают для символьных ссылок. Символьная ссылка является специальным файлом, который служит ссылкой на другой файл. По большей части символьные ссылки прозрачны к приложениям, и операции на символьных ссылках автоматически перенаправляются к цели ссылки. Исключения к этому - то, когда символьная ссылка удаляется или переименовала/переместилась, когда ссылка удаляется или удаляется, а не цель ссылки. Этот пакет включает поддержку символьных ссылок, где реализации обеспечивают их семантика. Файловые системы могут поддерживать другие типы, которые семантически близки, но поддержка этих других типов ссылок не включается в этот пакет.

Функциональная совместимость

File класс определяет toPath метод, чтобы создать a Path преобразовывая абстрактный путь, представленный java.io.File объект. Получающееся Path может использоваться, чтобы работать на том же самом файле как File объект. Path спецификация обеспечивает дополнительную информацию о функциональной совместимости между Path и java.io.File объекты.

Видимость

Представление файлов и файловой системы, обеспеченной классами в этом пакете, как гарантируют, будет непротиворечивым с другими представлениями, обеспеченными другими экземплярами в той же самой виртуальной машине Java. Представление может или, возможно, не, однако, является непротиворечивым с представлением файловой системы как замечено другими одновременно рабочими программами из-за кэширования выполняемого базовой операционной системой и задержками, вызванными протоколами сетевой файловой системы. Это - истина независимо от языка, на котором эти другие программы пишутся, и работают ли они на той же самой машине или на некоторой другой машине. Точный характер любых таких несогласованностей является системно-зависимым и является поэтому неуказанным.

Синхронизируемая Целостность Файла ввода-вывода

SYNC и DSYNC опции используются, открывая файл, чтобы потребовать, чтобы обновления к файлу были записаны синхронно базовому устройству хранения данных. В случае провайдера по умолчанию, и файл находится на локальном устройстве хранения данных, и seekable канал соединяется с файлом, который был открыт с одной из этих опций, затем вызов write метод, как только гарантируют, возвратится, когда все изменения, произведенные в файле тем вызовом, были записаны устройству. Эти опции полезны для обеспечения, что критическая информация не теряется в случае системного катастрофического отказа. Если файл не находится на локальном устройстве тогда, никакая такая гарантия не делается. Возможна ли эта гарантия с другим provider реализации являются определенным провайдером.

Общие Исключения

Если не указано иное, передача a null параметр конструктору или методу любого класса или интерфейса в этом пакете вызовет a NullPointerException быть брошенным. Дополнительно, вызывая метод с набором, содержащим a null элемент вызовет a NullPointerException, если иначе не определено.

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

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

Дополнительные Определенные Исключения

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

С тех пор:

1.7