compact1, compact2, compact3

java.nio.file.spi

Класс FileSystemProvider

java.lang. Объект

java.nio.file.spi. FileSystemProvider

public abstract class FileSystemProvider
extends Object

Поставщик услуг class для файловых систем. Методы, определенные Files class будет обычно делегировать к экземпляру этого class.

Провайдер файловой системы является конкретной реализацией этого class, который реализует абстрактные методы, определенные этим class. Провайдер идентифицируется a URI scheme. Провайдер значения по умолчанию идентифицируется схемой URI "файл". Это создает FileSystem это обеспечивает доступ к файловым системам, доступным для виртуальной машины Java. FileSystems class определяет, как провайдеры файловой системы располагаются и загружаются. Провайдер значения по умолчанию обычно является провайдером системного значения по умолчанию, но может быть переопределен если системное свойство java.nio.file.spi.DefaultFileSystemProvider устанавливается. В этом случае у провайдера есть один конструктор параметра, тип формального параметра которого FileSystemProvider. У всех других провайдеров есть нулевой конструктор параметра, который инициализирует провайдера.

Провайдер является фабрикой для один или больше FileSystem экземпляры. Каждая файловая система идентифицируется a URI где схема URI соответствует провайдера scheme. Файловая система значения по умолчанию, например, идентифицируется URI "file:///". Основанная на памяти файловая система, например, может быть идентифицирована URI такой как "memory:///?name=logfs". newFileSystem метод может использоваться, чтобы создать файловую систему, и getFileSystem метод может использоваться, чтобы получить ссылку на существующую файловую систему, создаваемую провайдером. Где провайдер является фабрикой для единственной файловой системы тогда, это - провайдер, зависимый, если файловая система создается, когда провайдер инициализируется, или позже когда newFileSystem метод вызывается. В случае провайдера значения по умолчанию, FileSystem создается, когда провайдер инициализируется.

Все методы в этом class безопасны для использования многократными параллельными потоками.

С тех пор:

1.7

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	FileSystemProvider() Инициализирует новый экземпляр этого class.

Сводка метода

Модификатор и Тип	Метод и Описание
abstract void	checkAccess(Path path, AccessMode... modes) Проверяет существование, и дополнительно доступность, файла.
abstract void	copy(Path source, Path target, CopyOption... options) Скопируйте файл в конечный файл.
abstract void	createDirectory(Path dir, FileAttribute<?>... attrs) Создает новый каталог.
void	createLink(Path link, Path existing) Создает новую ссылку (запись в каталоге) для существующего файла.
void	createSymbolicLink(Path link, Path target, FileAttribute<?>... attrs) Создает символьную ссылку на цель.
abstract void	delete(Path path) Удаляет файл.
boolean	deleteIfExists(Path path) Удаляет файл, если он существует.
abstract <V extends FileAttributeView> V	getFileAttributeView(Path path, Class<V> type, LinkOption... options) Возвращает представление атрибута файла данного типа.
abstract FileStore	getFileStore(Path path) Возвраты FileStore представление хранилища файлов, где файл располагается.
abstract FileSystem	getFileSystem(URI uri) Возвращает существующее FileSystem создаваемый этим провайдером.
abstract Path	getPath(URI uri) Возвратите a Path объект, преобразовывая данный URI.
abstract String	getScheme() Возвращает схему URI, которая идентифицирует этого провайдера.
static List<FileSystemProvider>	installedProviders() Возвращает список установленных провайдеров файловой системы.
abstract boolean	isHidden(Path path) Говорит, считают ли файл скрытым.
abstract boolean	isSameFile(Path path, Path path2) Тесты, если два пути определяют местоположение того же самого файла.
abstract void	move(Path source, Path target, CopyOption... options) Переместите или переименуйте файл к конечному файлу.
AsynchronousFileChannel	newAsynchronousFileChannel(Path path, Set<? extends OpenOption> options, ExecutorService executor, FileAttribute<?>... attrs) Открывает или создает файл для чтения и/или записи, возвращая асинхронный канал файла, чтобы получить доступ к файлу.
abstract SeekableByteChannel	newByteChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) Открывает или создает файл, возвращая seekable канал байта, чтобы получить доступ к файлу.
abstract DirectoryStream<Path>	newDirectoryStream(Path dir, DirectoryStream.Filter<? super Path> filter) Открывает каталог, возвращаясь a DirectoryStream выполнить итерации по записям в каталоге.
FileChannel	newFileChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) Открывает или создает файл для чтения и/или записи, возвращая канал файла, чтобы получить доступ к файлу.
FileSystem	newFileSystem(Path path, Map<String,?> env) Создает новое FileSystem получить доступ к содержанию файла как файловая система.
abstract FileSystem	newFileSystem(URI uri, Map<String,?> env) Создает новое FileSystem объект идентифицируется URI.
InputStream	newInputStream(Path path, OpenOption... options) Открывает файл, возвращая входной поток, чтобы читать из файла.
OutputStream	newOutputStream(Path path, OpenOption... options) Открывает или создает файл, возвращая поток вывода, который может использоваться, чтобы записать байты в файл.
abstract <A extends BasicFileAttributes> A	readAttributes(Path path, Class<A> type, LinkOption... options) Читает атрибуты файла как объемную работу.
abstract Map<String,Object>	readAttributes(Path path, String attributes, LinkOption... options) Чтения ряд атрибутов файла как объемная работа.
Путь	readSymbolicLink(Path link) Читает цель символьной ссылки.
abstract void	setAttribute(Path path, String attribute, Object value, LinkOption... options) Устанавливает значение атрибута файла.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

FileSystemProvider

protected FileSystemProvider()

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

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

Броски:

SecurityException - Если менеджер безопасности был установлен, и он отрицает RuntimePermission("fileSystemProvider")

Деталь метода

installedProviders

public static List<FileSystemProvider> installedProviders()

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

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

Возвраты:

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

Броски:

ServiceConfigurationError - Когда ошибка происходит, загружая поставщика услуг

getScheme

public abstract String getScheme()

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

Возвраты:

Схема URI

newFileSystem

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 как файловая система, это ранее создало.

Параметры:

uri - Ссылка URI

env - Карта провайдера определенные свойства, чтобы сконфигурировать файловую систему; может быть пустым

Возвраты:

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

Броски:

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

IOException - Ошибка ввода-вывода происходит, создавая файловую систему

SecurityException - Если менеджер безопасности устанавливается, и он отрицает неуказанное разрешение, требуемое реализацией провайдера файловой системы

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

getFileSystem

public abstract FileSystem getFileSystem(URI uri)

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

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

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

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

Параметры:

uri - Ссылка URI

Возвраты:

Файловая система

Броски:

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

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

SecurityException - Если менеджер безопасности устанавливается, и он отрицает неуказанное разрешение.

getPath

public abstract Path getPath(URI uri)

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

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

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

Параметры:

uri - URI, чтобы преобразовать

Броски:

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

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

SecurityException - Если менеджер безопасности устанавливается, и он отрицает неуказанное разрешение.

newFileSystem

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

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

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

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

Параметры:

path - Путь к файлу

env - Карта провайдера определенные свойства, чтобы сконфигурировать файловую систему; может быть пустым

Возвраты:

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

Броски:

UnsupportedOperationException - Если этот провайдер не поддерживает доступ к содержанию как файловая система, или это не распознает тип файла данного файла

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

IOException - Если ошибка ввода-вывода происходит

SecurityException - Если менеджер безопасности устанавливается, и он отрицает неуказанное разрешение.

newInputStream

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<?>...) метод и конструкции поток, который читает байты из канала. Этот метод должен быть переопределен где необходимо.

Параметры:

path - путь к файлу, чтобы открыться

options - опции, определяющие, как файл открывается

Возвраты:

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

Броски:

IllegalArgumentException - если недопустимая комбинация опций определяется

UnsupportedOperationException - если неподдерживаемая опция определяется

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к файлу.

newOutputStream

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<?>...) метод и конструкции поток, который пишет байты в канал. Этот метод должен быть переопределен где необходимо.

Параметры:

path - путь к файлу, чтобы открыться или создать

options - опции, определяющие, как файл открывается

Возвраты:

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

Броски:

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

UnsupportedOperationException - если неподдерживаемая опция определяется

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkWrite метод вызывается, чтобы проверить доступ для записи к файлу. checkDelete метод вызывается, чтобы проверить, удаляют доступ, если файл открывается с DELETE_ON_CLOSE опция.

newFileChannel

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

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

Параметры:

path - путь файла, чтобы открыться или создать

options - опции, определяющие, как файл открывается

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

Возвраты:

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

Броски:

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

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

IOException - Если ошибка ввода-вывода происходит

SecurityException - В случае файловой системы значения по умолчанию, SecurityManager.checkRead(String) метод вызывается, чтобы проверить доступ для чтения, если файл открывается для того, чтобы читать. SecurityManager.checkWrite(String) метод вызывается, чтобы проверить доступ для записи, если файл открывается для того, чтобы записать

newAsynchronousFileChannel

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

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

Параметры:

path - путь файла, чтобы открыться или создать

options - опции, определяющие, как файл открывается

executor - пул потоков или null связать канал с пулом потоков значения по умолчанию

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

Возвраты:

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

Броски:

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

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

IOException - Если ошибка ввода-вывода происходит

SecurityException - В случае файловой системы значения по умолчанию, SecurityManager.checkRead(String) метод вызывается, чтобы проверить доступ для чтения, если файл открывается для того, чтобы читать. SecurityManager.checkWrite(String) метод вызывается, чтобы проверить доступ для записи, если файл открывается для того, чтобы записать

newByteChannel

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

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

Параметры:

path - путь к файлу, чтобы открыться или создать

options - опции, определяющие, как файл открывается

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

Возвраты:

новый seekable канал байта

Броски:

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

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

FileAlreadyExistsException - если файл того имени уже существует и CREATE_NEW опция определяется (дополнительное определенное исключение)

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к пути, если файл открывается для того, чтобы читать. checkWrite метод вызывается, чтобы проверить доступ для записи к пути, если файл открывается для того, чтобы записать. checkDelete метод вызывается, чтобы проверить, удаляют доступ, если файл открывается с DELETE_ON_CLOSE опция.

newDirectoryStream

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

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

Параметры:

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

filter - потоковый фильтр каталога

Возвраты:

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

Броски:

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к каталогу.

createDirectory

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

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

Параметры:

dir - каталог, чтобы создать

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

Броски:

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

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

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

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkWrite метод вызывается, чтобы проверить доступ для записи к новому каталогу.

createSymbolicLink

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.

Параметры:

link - путь символьной ссылки, чтобы создать

target - цель символьной ссылки

attrs - массив атрибутов, чтобы установить атомарно, создавая символьную ссылку

Броски:

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

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, он отрицает LinkPermission("symbolic") или checkWrite метод отрицает доступ для записи к пути символьной ссылки.

createLink

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

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

Реализация по умолчанию этого метода броски UnsupportedOperationException.

Параметры:

link - ссылка (запись в каталоге), чтобы создать

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

Броски:

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

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, он отрицает LinkPermission("hard") или checkWrite метод отрицает доступ для записи или к ссылке или к существующему файлу.

удалить

public abstract void delete(Path path)
                     throws IOException

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

Параметры:

path - путь к файлу, чтобы удалить

Броски:

NoSuchFileException - если файл не существует (дополнительное определенное исключение)

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, SecurityManager.checkDelete(String) метод вызывается, чтобы проверить, удаляют доступ к файлу

deleteIfExists

public boolean deleteIfExists(Path path)
                       throws IOException

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

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

Параметры:

path - путь к файлу, чтобы удалить

Возвраты:

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

Броски:

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, SecurityManager.checkDelete(String) метод вызывается, чтобы проверить, удаляют доступ к файлу

readSymbolicLink

public Path readSymbolicLink(Path link)
                      throws IOException

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

Реализация по умолчанию этого метода броски UnsupportedOperationException.

Параметры:

link - путь к символьной ссылке

Броски:

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

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, он проверяет это FilePermission был предоставлен с"readlink"действие, чтобы считать ссылку.

копия

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

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

Параметры:

source - путь к файлу, чтобы скопировать

target - путь к конечному файлу

options - опции, определяющие, как копия должна быть сделана

Броски:

UnsupportedOperationException - если массив содержит опцию копии, которая не поддерживается

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

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к исходному файлу, checkWrite вызывается, чтобы проверить доступ для записи к конечному файлу. Если символьная ссылка копируется, менеджер безопасности вызывается, чтобы проверить LinkPermission("symbolic").

переместиться

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...) метод за исключением того, что оба исходные и целевые пути должны быть связаны с этим провайдером.

Параметры:

source - путь к файлу, чтобы переместиться

target - путь к конечному файлу

options - опции, определяющие, как перемещение должно быть сделано

Броски:

UnsupportedOperationException - если массив содержит опцию копии, которая не поддерживается

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

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

AtomicMoveNotSupportedException - если массив опций содержит ATOMIC_MOVE опция, но файл не может быть перемещена как атомарная работа файловой системы.

IOException - если ошибка ввода-вывода происходит

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

isSameFile

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

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

Параметры:

path - один путь к файлу

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

Возвраты:

true если, и только если, эти два пути определяют местоположение того же самого файла

Броски:

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к обоим файлам.

isHidden

public abstract boolean isHidden(Path path)
                          throws IOException

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

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

Параметры:

path - путь к файлу, чтобы протестировать

Возвраты:

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

Броски:

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к файлу.

getFileStore

public abstract FileStore getFileStore(Path path)
                                throws IOException

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

Параметры:

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

Возвраты:

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

Броски:

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к файлу, и кроме того это проверяет RuntimePermission ("getFileStoreAttributes")

checkAccess

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 параметр имеет нуль длины, тогда существование файла проверяется.

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

Параметры:

path - путь к файлу, чтобы проверить

modes - Режимы доступа, чтобы проверить; может иметь нулевые элементы

Броски:

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

NoSuchFileException - если файл не существует (дополнительное определенное исключение)

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию, и менеджера безопасности устанавливается, checkRead вызывается, проверяя доступ для чтения к файлу или только существование файла, checkWrite вызывается, проверяя доступ для записи к файлу, и checkExec вызывается, проверяя доступ на выполнение.

getFileAttributeView

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...) метод.

Параметры:

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

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

options - опции, указывающие, как обрабатываются символьные ссылки

Возвраты:

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

readAttributes

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

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

Параметры:

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

type - Class из атрибутов файла, требуемых читать

options - опции, указывающие, как обрабатываются символьные ссылки

Возвраты:

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

Броски:

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

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера значения по умолчанию менеджер безопасности устанавливается, checkRead метод вызывается, чтобы проверить доступ для чтения к файлу

readAttributes

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

Чтения ряд атрибутов файла как объемная работа. Этот метод работает точно способом, определенным Files.readAttributes(Path,String,LinkOption[]) метод.

Параметры:

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

attributes - атрибуты, чтобы читать

options - опции, указывающие, как обрабатываются символьные ссылки

Возвраты:

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

Броски:

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

IllegalArgumentException - если никакие атрибуты не определяются или определяются, нераспознанные атрибуты

IOException - Если ошибка ввода-вывода происходит

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

setAttribute

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...) метод.

Параметры:

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

attribute - атрибут, чтобы установить

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

options - опции, указывающие, как обрабатываются символьные ссылки

Броски:

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

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

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

IOException - Если ошибка ввода-вывода происходит

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