Класс 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 равен "/", а компоненты authority, query и fragment не определены (неопределённые компоненты представлены как null).

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

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

public abstract Path getPath(URI uri)

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

Точный вид URI зависит от поставщика файловой системы. В случае поставщика по умолчанию схема URI равна "file", а у заданного URI есть ненулевой компонент пути, а компоненты query и fragment не определены. Полученный 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...).

public boolean exists(Path path, LinkOption... options)

Проверяет, существует ли файл. Этот метод работает точно так же, как и метод Files.exists(Path, LinkOption...).

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

Читает атрибуты файла как операцию сжатия, если файл существует.

Параметр type — тип требуемых атрибутов, и этот метод возвращает экземпляр этого типа, если он поддерживается. Все реализации поддерживают базовый набор атрибутов файла, поэтому вызов этого метода с параметром type типа BasicFileAttributes.class не выбросит UnsupportedOperationException.

Массив options может использоваться для указания обработки символических ссылок в случае, если файл является символической ссылкой. По умолчанию символические ссылки отслеживаются, и считываются атрибуты файла конечного объекта ссылки. Если опция NOFOLLOW_LINKS присутствует, то символические ссылки не отслеживаются.

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