Класс FileSystemProvider

protected FileSystemProvider()

Инициализирует новый экземпляр этого класса.

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

public static List<FileSystemProvider> installedProviders()

Возвращает список установленных файловых системных провайдеров.

Первый вызов этого метода приводит к инициализации провайдера по умолчанию (если он еще не инициализирован) и загружает все остальные установленные провайдеры, как описано в классе FileSystems.

public abstract String getScheme()

Возвращает схему URI, которая идентифицирует этот провайдер.

public abstract FileSystem newFileSystem(URI uri, Map<String,?> env) throws IOException

Создает новый объект FileSystem, идентифицируемый URI. Этот метод вызывается методом FileSystems.newFileSystem(URI,Map) для открытия новой файловой системы, идентифицируемой URI.

Параметр uri представляет собой абсолютный иерархический URI со схемой, равной (без учета регистра) схеме, поддерживаемой этим провайдером. Точный формат URI сильно зависит от провайдера. Параметр env представляет собой карту свойств, специфичных для провайдера, для настройки файловой системы.

Этот метод выбрасывает FileSystemAlreadyExistsException, если файловая система уже существует, потому что она была ранее создана вызовом этого метода. После того, как файловая система closed, зависит от провайдера, разрешает ли он создание новой файловой системы с тем же URI, что и файловая система, которую он ранее создал.

public abstract FileSystem getFileSystem(URI uri)

Возвращает существующую FileSystem, созданную этим провайдером.

Этот метод возвращает ссылку на FileSystem, которая была создана путем вызова метода newFileSystem(URI,Map). Файловые системы, созданные методом newFileSystem(Path,Map), не возвращаются этим методом. Файловая система идентифицируется по ее URI. Ее точный формат сильно зависит от провайдера. В случае провайдера по умолчанию компонент пути URI является "/", а компоненты авторитета, запроса и фрагмента не определены (неопределенные компоненты представлены как null).

После того, как файловая система, созданная этим провайдером, closed, зависит от провайдера, возвращает ли этот метод ссылку на закрытую файловую систему или выбрасывает FileSystemNotFoundException. Если провайдер разрешает создание новой файловой системы с тем же URI, что и файловая система, которую он ранее создал, этот метод выбрасывает исключение, если вызывается после закрытия файловой системы (и до создания нового экземпляра методом newFileSystem).

Если установлен менеджер безопасности, то реализация провайдера может потребовать проверки разрешения перед возвращением ссылки на существующую файловую систему. В случае файловой системы default проверка разрешения не требуется.

public abstract Path getPath(URI uri)

Возвращает объект Path, преобразуя заданный URI. Полученный Path связан с FileSystem, которая уже существует или создается автоматически.

Точный формат URI зависит от провайдера файловой системы. В случае провайдера по умолчанию схема URI равна "file", заданный URI имеет непустой компонент пути, и неопределенные компоненты запроса и фрагмента. Полученный Path связан с файловой системой по умолчанию default FileSystem.

Если установлен менеджер безопасности, то реализация провайдера может потребовать проверки разрешения. В случае файловой системы default проверка разрешения не требуется.

public FileSystem newFileSystem(Path path, Map<String,?> env) throws IOException

Создает новую FileSystem для доступа к содержимому файла как к файловой системе.

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

Если этот провайдер не поддерживает создание таких файловых систем или если провайдер не распознает тип файла заданного файла, то он выбрасывает UnsupportedOperationException. По умолчанию этот метод выбрасывает UnsupportedOperationException.

public InputStream newInputStream(Path path, OpenOption... options) throws IOException

Открывает файл, возвращая поток ввода для чтения из файла. Этот метод работает точно так же, как указано в методе Files.newInputStream(java.nio.file.Path, java.nio.file.OpenOption...).

Реализация по умолчанию этого метода открывает канал к файлу, как если бы вызывался метод newByteChannel(java.nio.file.Path, java.util.Set<? extends java.nio.file.OpenOption>, java.nio.file.attribute.FileAttribute<?>...), и создает поток, который читает байты из канала. Этот метод следует переопределять при необходимости.

public OutputStream newOutputStream(Path path, OpenOption... options) throws IOException

Открывает или создаёт файл, возвращая поток вывода, который может быть использован для записи байтов в файл. Этот метод работает точно так же, как и метод Files.newOutputStream(java.nio.file.Path, java.nio.file.OpenOption...).

По умолчанию этот метод открывает канал к файлу, как если бы был вызван метод newByteChannel(java.nio.file.Path, java.util.Set<? extends java.nio.file.OpenOption>, java.nio.file.attribute.FileAttribute<?>...), и создаёт поток, который записывает байты в канал. Этот метод следует переопределять, если необходимо.

public FileChannel newFileChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) throws IOException

Открывает или создаёт файл для чтения и/или записи, возвращая файловый канал для доступа к файлу. Этот метод работает точно так же, как и метод FileChannel.open. Поставщик, не поддерживающий все необходимые функции для создания файлового канала, выбрасывает UnsupportedOperationException. Поставщик по умолчанию должен поддерживать создание файловых каналов. При отсутствии переопределения, метод по умолчанию выбрасывает UnsupportedOperationException.

public AsynchronousFileChannel newAsynchronousFileChannel(Path path, Set<? extends OpenOption> options, ExecutorService executor, FileAttribute<?>... attrs) throws IOException

Открывает или создаёт файл для чтения и/или записи, возвращая асинхронный файловый канал для доступа к файлу. Этот метод работает точно так же, как и метод AsynchronousFileChannel.open. Поставщик, не поддерживающий все необходимые функции для создания асинхронного файлового канала, выбрасывает UnsupportedOperationException. Поставщик по умолчанию должен поддерживать создание асинхронных файловых каналов. При отсутствии переопределения, метод по умолчанию выбрасывает UnsupportedOperationException.

public abstract SeekableByteChannel newByteChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) throws IOException

Открывает или создаёт файл, возвращая доступный для поиска байтовый канал для доступа к файлу. Этот метод работает точно так же, как и метод Files.newByteChannel(Path,Set,FileAttribute[]).

public abstract DirectoryStream<Path> newDirectoryStream(Path dir, DirectoryStream.Filter<? super Path> filter) throws IOException

Открывает каталог, возвращая объект для итерации по записям в каталоге. Этот метод работает точно так же, как и метод Files.newDirectoryStream(java.nio.file.Path, java.nio.file.DirectoryStream.Filter).

public abstract void createDirectory(Path dir, FileAttribute<?>... attrs) throws IOException

Создаёт новый каталог. Этот метод работает точно так же, как и метод Files.createDirectory(java.nio.file.Path, java.nio.file.attribute.FileAttribute<?>...).

public void createSymbolicLink(Path link, Path target, FileAttribute<?>... attrs) throws IOException

Создаёт символическую ссылку на целевой объект. Этот метод работает точно так же, как и метод Files.createSymbolicLink(java.nio.file.Path, java.nio.file.Path, java.nio.file.attribute.FileAttribute<?>...).

По умолчанию этот метод выбрасывает UnsupportedOperationException.

public void createLink(Path link, Path existing) throws IOException

Создаёт новую ссылку (запись в каталоге) для существующего файла. Этот метод работает точно так же, как и метод Files.createLink(java.nio.file.Path, java.nio.file.Path).

По умолчанию этот метод выбрасывает UnsupportedOperationException.

public abstract void delete(Path path) throws IOException

Удаляет файл. Этот метод работает точно так же, как и метод Files.delete(java.nio.file.Path).

public boolean deleteIfExists(Path path) throws IOException

Удаляет файл, если он существует. Этот метод работает точно так же, как и метод Files.deleteIfExists(java.nio.file.Path).

Реализация по умолчанию просто вызывает delete(java.nio.file.Path), игнорируя NoSuchFileException, если файл не существует. Она может быть переопределена при необходимости.

public Path readSymbolicLink(Path link) throws IOException

Читает целевой объект символической ссылки. Этот метод работает точно так же, как и метод Files.readSymbolicLink(java.nio.file.Path).

По умолчанию этот метод выбрасывает UnsupportedOperationException.

public abstract void copy(Path source, Path target, CopyOption... options) throws IOException

Копирует файл в целевой файл. Этот метод работает точно так же, как и метод Files.copy(Path,Path,CopyOption[]), за исключением того, что и исходный, и целевой пути должны быть связаны с этим поставщиком.

public abstract void move(Path source, Path target, CopyOption... options) throws IOException

Перемещает или переименовывает файл в целевой файл. Этот метод работает точно так же, как и метод Files.move(java.nio.file.Path, java.nio.file.Path, java.nio.file.CopyOption...), за исключением того, что и исходный, и целевой пути должны быть связаны с этим поставщиком.

public abstract boolean isSameFile(Path path, Path path2) throws IOException

Проверяет, указывают ли два пути на один и тот же файл. Этот метод работает точно так же, как и метод Files.isSameFile(java.nio.file.Path, java.nio.file.Path).

public abstract boolean isHidden(Path path) throws IOException

Определяет, является ли файл скрытым. Этот метод работает точно так же, как и метод Files.isHidden(java.nio.file.Path).

Этот метод вызывается методом isHidden.

public abstract FileStore getFileStore(Path path) throws IOException

Возвращает FileStore, представляющий хранилище файлов, в котором расположен файл. Этот метод работает точно так же, как и метод Files.getFileStore(java.nio.file.Path).

public abstract void checkAccess(Path path, AccessMode... modes) throws IOException

Проверяет существование и, по желанию, доступность файла.

Этот метод может использоваться методами isReadable, isWritable и isExecutable для проверки доступности файла.

Этот метод проверяет существование файла и наличие у виртуальной машины Java соответствующих привилегий, которые позволили бы ей получить доступ к файлу в соответствии со всеми режимами доступа, указанными в параметре modes следующим образом:

Режимы доступа

Значение	Описание
READ	Проверяет, что файл существует, и что виртуальная машина Java имеет разрешение на чтение файла.
WRITE	Проверяет, что файл существует, и что виртуальная машина Java имеет разрешение на запись в файл,
EXECUTE	Проверяет, что файл существует, и что виртуальная машина Java имеет разрешение на execute файл. Семантика может отличаться при проверке доступа к каталогу. Например, в системах UNIX проверка доступа для EXECUTE проверяет, имеет ли виртуальная машина Java разрешение на поиск в каталоге для доступа к файлам или подкаталогам.

Если параметр modes имеет нулевую длину, то проверяется существование файла.

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

public abstract <V extends FileAttributeView> V getFileAttributeView(Path path, Class<V> type, LinkOption... options)

Возвращает представление атрибутов файла заданного типа. Этот метод работает точно так же, как и метод Files.getFileAttributeView(java.nio.file.Path, java.lang.Class<V>, java.nio.file.LinkOption...).

public abstract <A extends BasicFileAttributes> A readAttributes(Path path, Class<A> type, LinkOption... options) throws IOException

Считывает атрибуты файла как единую операцию. Этот метод работает точно так же, как и метод Files.readAttributes(Path,Class,LinkOption[]).

public abstract Map<String,Object> readAttributes(Path path, String attributes, LinkOption... options) throws IOException

Считывает набор атрибутов файла как единую операцию. Этот метод работает точно так же, как и метод Files.readAttributes(Path,String,LinkOption[]).

public abstract void setAttribute(Path path, String attribute, Object value, LinkOption... options) throws IOException

Устанавливает значение атрибута файла. Этот метод работает точно так же, как и метод Files.setAttribute(java.nio.file.Path, java.lang.String, java.lang.Object, java.nio.file.LinkOption...).