Класс FileSystemProvider

protected FileSystemProvider()

public static List<FileSystemProvider> installedProviders()

Возвращает:

Немодифицируемый список установленных провайдеров файловых систем. Список содержит как минимум один элемент — провайдер файловой системы по умолчанию

Вызывает:

ServiceConfigurationError — При возникновении ошибки во время загрузки поставщика службы

public abstract String getScheme()

Возвращает:

Схему URI

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

Параметры:

uri — ссылка URI

env — карта свойств, специфичных для провайдера, для настройки файловой системы; может быть пустой

Возвращает:

Новую файловую систему

Вызывает:

IllegalArgumentException — Если не выполнены предварительные условия для параметра uri, параметр env не содержит свойств, необходимых провайдеру, или значение свойства недопустимо

IOException — При возникновении ошибки ввода-вывода во время создания файловой системы

FileSystemAlreadyExistsException — Если файловая система уже создана

public abstract FileSystem getFileSystem(URI uri)

Параметры:

uri — ссылка URI

Возвращает:

Файловую систему

Вызывает:

IllegalArgumentException — Если не выполнены предварительные условия для параметра uri

FileSystemNotFoundException — Если файловая система не существует

public abstract Path getPath(URI uri)

Параметры:

uri — URI для преобразования

Возвращает:

Полученный объект Path

Вызывает:

IllegalArgumentException — Если схема URI не идентифицирует этот провайдер или не выполнены другие предварительные условия для параметра uri

FileSystemNotFoundException — Файловая система, идентифицируемая URI, не существует и не может быть создана автоматически

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

Параметры:

path — путь к файлу

env — карта свойств, специфичных для провайдера, для настройки файловой системы; может быть пустой

Возвращает:

Новую файловую систему

Вызывает:

UnsupportedOperationException — Если этот провайдер не поддерживает доступ к содержимому в качестве файловой системы или не распознает тип заданного файла

IllegalArgumentException — Если параметр env не содержит свойств, необходимых провайдеру, или значение свойства недопустимо

IOException — При возникновении ошибки ввода-вывода

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

Параметры:

path — путь к файлу, который нужно открыть

options — параметры, указывающие, как открыть файл

Возвращает:

новый поток ввода

Вызывает:

IllegalArgumentException — если задана недопустимая комбинация параметров

UnsupportedOperationException — если задан неподдерживаемый параметр

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

path — путь к файлу, который нужно открыть или создать

options — параметры, указывающие, как открыть файл

Возвращает:

новый поток вывода

Вызывает:

IllegalArgumentException — если options содержит недопустимую комбинацию параметров

UnsupportedOperationException — если задан неподдерживаемый параметр

IOException — при возникновении ошибки ввода-вывода

FileAlreadyExistsException — Если файл с таким именем уже существует и задан параметр CREATE_NEW (необязательное конкретное исключение)

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

Параметры:

path — путь к файлу, который нужно открыть или создать

options — параметры, указывающие, как открыть файл

attrs — необязательный список атрибутов файла, которые нужно задать атомарно при создании файла

Возвращает:

новый файловый канал

Вызывает:

IllegalArgumentException — Если набор содержит недопустимую комбинацию параметров

UnsupportedOperationException — Если этот провайдер не поддерживает создание файловых каналов либо задан неподдерживаемый параметр открытия или атрибут файла

FileAlreadyExistsException — Если файл с таким именем уже существует, задан параметр CREATE_NEW и файл открывается для записи (необязательное конкретное исключение)

IOException — При возникновении ошибки ввода-вывода

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

Параметры:

path — путь к файлу, который нужно открыть или создать

options — параметры, указывающие, как открыть файл

executor — пул потоков или null для связи канала с пулом потоков по умолчанию

attrs — необязательный список атрибутов файла, которые нужно задать атомарно при создании файла

Возвращает:

новый асинхронный файловый канал

Вызывает:

IllegalArgumentException — Если набор содержит недопустимую комбинацию параметров

UnsupportedOperationException — Если этот провайдер не поддерживает создание асинхронных файловых каналов либо задан неподдерживаемый параметр открытия или атрибут файла

FileAlreadyExistsException — Если файл с таким именем уже существует, задан параметр CREATE_NEW и файл открывается для записи (необязательное конкретное исключение)

IOException — При возникновении ошибки ввода-вывода

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

Параметры:

path — путь к файлу, который нужно открыть или создать

options — параметры, указывающие, как открыть файл

attrs — необязательный список атрибутов файла, которые нужно задать атомарно при создании файла

Возвращает:

новый канал с произвольным доступом к байтам

Вызывает:

IllegalArgumentException — если набор содержит недопустимую комбинацию параметров

UnsupportedOperationException — если задан неподдерживаемый параметр открытия или массив содержит атрибуты, которые нельзя задать атомарно при создании файла

FileAlreadyExistsException — Если файл с таким именем уже существует, задан параметр CREATE_NEW и файл открывается для записи (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

dir — путь к каталогу

filter — фильтр потока каталога

Возвращает:

новый открытый объект DirectoryStream

Вызывает:

NotDirectoryException — если файл иначе не удалось открыть, поскольку он не является каталогом (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

dir — каталог, который нужно создать

attrs — необязательный список атрибутов файла, которые нужно задать атомарно при создании каталога

Вызывает:

UnsupportedOperationException — если массив содержит атрибут, который нельзя задать атомарно при создании каталога

FileAlreadyExistsException — если каталог иначе не удалось создать, поскольку файл с таким именем уже существует (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода или если родительский каталог не существует

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

Параметры:

link — путь символической ссылки, которую нужно создать

target — целевой объект символической ссылки

attrs — массив атрибутов, которые нужно задать атомарно при создании символической ссылки

Вызывает:

UnsupportedOperationException — если реализация не поддерживает символические ссылки или массив содержит атрибут, который нельзя задать атомарно при создании символической ссылки

FileAlreadyExistsException — если файл с таким именем уже существует (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

link — ссылка (запись каталога), которую нужно создать

existing — путь к существующему файлу

Вызывает:

UnsupportedOperationException — если реализация не поддерживает добавление существующего файла в каталог

FileAlreadyExistsException — если запись иначе не удалось создать, поскольку файл с таким именем уже существует (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

public abstract void delete(Path path) throws IOException

Параметры:

path — путь к файлу, который нужно удалить

Вызывает:

NoSuchFileException — если файл не существует (необязательное конкретное исключение)

DirectoryNotEmptyException — если файл является каталогом и его иначе не удалось удалить, поскольку каталог не пуст (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

public boolean deleteIfExists(Path path) throws IOException

Параметры:

path — путь к файлу, который нужно удалить

Возвращает:

true, если файл был удален этим методом; false, если файл не удалось удалить, поскольку он не существовал

Вызывает:

DirectoryNotEmptyException — если файл является каталогом и его иначе не удалось удалить, поскольку каталог не пуст (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

public Path readSymbolicLink(Path link) throws IOException

Параметры:

link — путь к символической ссылке

Возвращает:

Цель символической ссылки

Вызывает:

UnsupportedOperationException — если реализация не поддерживает символические ссылки

NotLinkException — если цель иначе не удалось прочитать, поскольку файл не является символической ссылкой (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

source — путь к файлу, который нужно скопировать

target — путь к целевому файлу

options — параметры, определяющие способ копирования

Вызывает:

UnsupportedOperationException — если массив содержит неподдерживаемый параметр копирования

FileAlreadyExistsException — если целевой файл существует, но его нельзя заменить, поскольку не задан параметр REPLACE_EXISTING (необязательное конкретное исключение)

DirectoryNotEmptyException — если задан параметр REPLACE_EXISTING, но файл нельзя заменить, поскольку он является непустым каталогом (необязательное конкретное исключение)

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

source — путь к файлу, который нужно переместить

target — путь к целевому файлу

options — параметры, определяющие способ перемещения

Вызывает:

UnsupportedOperationException — если массив содержит неподдерживаемый параметр копирования

FileAlreadyExistsException — если целевой файл существует, но его нельзя заменить, поскольку не задан параметр REPLACE_EXISTING (необязательное конкретное исключение)

DirectoryNotEmptyException — если задан параметр REPLACE_EXISTING, но файл нельзя заменить, поскольку он является непустым каталогом (необязательное конкретное исключение)

AtomicMoveNotSupportedException — если массив параметров содержит параметр ATOMIC_MOVE, но файл нельзя переместить как атомарную операцию файловой системы.

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

path — один из путей к файлу

path2 — другой путь

Возвращает:

true, если и только если оба пути указывают на один и тот же файл

Вызывает:

IOException — при возникновении ошибки ввода-вывода

public abstract boolean isHidden(Path path) throws IOException

Параметры:

path — путь к файлу для проверки

Возвращает:

true, если файл считается скрытым

Вызывает:

IOException — при возникновении ошибки ввода-вывода

public abstract FileStore getFileStore(Path path) throws IOException

Параметры:

path — путь к файлу

Возвращает:

хранилище файлов, в котором находится файл

Вызывает:

IOException — при возникновении ошибки ввода-вывода

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

Параметры:

path — путь к файлу, доступ к которому проверяется

modes — проверяемые режимы доступа; может содержать ноль элементов

Исключения:

UnsupportedOperationException — реализация должна поддерживать проверку доступа READ, WRITE и EXECUTE. Это исключение предусмотрено для того, чтобы перечисление Access можно было расширить в будущих выпусках.

NoSuchFileException — если файл не существует (необязательное специализированное исключение)

AccessDeniedException — если в запрошенном доступе будет отказано или доступ невозможно определить из-за недостаточных разрешений виртуальной машины Java либо по другим причинам. (необязательное специализированное исключение)

IOException — если возникает ошибка ввода-вывода

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

Параметры типа:

V — тип FileAttributeView

Параметры:

path — путь к файлу

type — объект Class, соответствующий представлению атрибутов файла

options — параметры, определяющие способ обработки символических ссылок

Возвращает:

представление атрибутов файла указанного типа или null, если тип представления атрибутов недоступен

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

Параметры типа:

A — тип BasicFileAttributes

Параметры:

path — путь к файлу

type — Class атрибутов файла, которые требуется считать

options — параметры, определяющие способ обработки символических ссылок

Возвращает:

атрибуты файла

Исключения:

UnsupportedOperationException — если атрибуты указанного типа не поддерживаются

IOException — если возникает ошибка ввода-вывода

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

Параметры:

path — путь к файлу

attributes — считываемые атрибуты

options — параметры, определяющие способ обработки символических ссылок

Возвращает:

карта возвращенных атрибутов; может быть пустой. Ключи карты — имена атрибутов, значения — значения атрибутов

Исключения:

UnsupportedOperationException — если представление атрибутов недоступно

IllegalArgumentException — если атрибуты не указаны или указан нераспознанный атрибут

IOException — если возникает ошибка ввода-вывода

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

Параметры:

path — путь к файлу

attribute — задаваемый атрибут

value — значение атрибута

options — параметры, определяющие способ обработки символических ссылок

Исключения:

UnsupportedOperationException — если представление атрибутов недоступно

IllegalArgumentException — если имя атрибута не указано или не распознано либо значение атрибута имеет правильный тип, но недопустимое значение

ClassCastException — если значение атрибута имеет неожидаемый тип или представляет собой коллекцию, содержащую элементы неожидаемого типа

IOException — если возникает ошибка ввода-вывода

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

Требования к реализации:

Реализация этого метода по умолчанию вызывает метод checkAccess(Path, AccessMode...), если переход по символическим ссылкам разрешен. Если указан параметр NOFOLLOW_LINKS, переход по символическим ссылкам не выполняется и вызывается метод readAttributes(Path, Class, LinkOption...) для определения существования файла.

Параметры:

path — путь к проверяемому файлу

options — параметры, определяющие способ обработки символических ссылок

Возвращает:

true, если файл существует; false, если файл не существует или невозможно определить, существует ли он.

С момента:

20

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

Требования к реализации:

Реализация этого метода по умолчанию вызывает метод readAttributes(Path, Class, LinkOption...) для считывания атрибутов файла.

Параметры типа:

A — тип BasicFileAttributes

Параметры:

path — путь к файлу

type — Class атрибутов файла, которые требуется считать

options — параметры, определяющие способ обработки символических ссылок

Возвращает:

атрибуты файла или null, если файл не существует

Исключения:

UnsupportedOperationException — если атрибуты указанного типа не поддерживаются

IOException — если возникает ошибка ввода-вывода

С момента:

20