Класс 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