java.nio.file

Класс FileSystems

java.lang. Объект

java.nio.file. FileSystems

public final class FileSystems
extends Object

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

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

Первый вызов installedProviders метод, посредством вызова любого из newFileSystem методы, определенные этим классом, определяют местоположение и загружают всех установленных провайдеров файловой системы. Установленные провайдеры загружаются, используя поставщика услуг, загружающего средство, определенное ServiceLoader класс. Установленные провайдеры загружаются, используя системный загрузчик класса. Если системный загрузчик класса не может быть найден тогда, загрузчик класса расширения используется; если нет никакого загрузчика класса расширения тогда, загрузчик класса начальной загрузки используется. Провайдеры обычно устанавливаются, размещая их в файле JAR на пути класса приложений или в каталоге расширения, файл JAR содержит названный конфигурационный файл провайдера java.nio.file.spi.FileSystemProvider в каталоге ресурса META-INF/services, и списки файлов один или более полностью определенные имена конкретного подкласса FileSystemProvider у этого есть нулевой конструктор параметра. Упорядочивание, которое устанавливало провайдеров, располагается, определенная реализация. Если провайдер инстанцируют и getScheme возвращает ту же самую схему URI провайдера, который ранее инстанцировали тогда, последний раз инстанцированная копия отбрасывается. Схемы URI сравниваются без отношения, чтобы случиться. Во время конструкции провайдер может безопасно получить доступ к файлам, связанным с провайдером по умолчанию, но заботиться потребности, которые будут взяты, чтобы избежать круговой загрузки других установленных провайдеров. Если круговая загрузка установленных провайдеров обнаруживается тогда, неустановленная ошибка бросается.

Этот класс также определяет методы фабрики, которые позволяют a ClassLoader быть определенным, определяя местоположение провайдера. Как с установленными провайдерами, классы провайдера идентифицируются, помещая конфигурационный файл провайдера в каталоге ресурса META-INF/services.

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

С тех пор:

1.7

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

Методы

Модификатор и Тип	Метод и Описание
static FileSystem	getDefault() Возвращает значение по умолчанию FileSystem.
static FileSystem	getFileSystem(URI uri) Возвращает ссылку на существующее FileSystem.
static FileSystem	newFileSystem(Path path, ClassLoader loader) Создает новое FileSystem получить доступ к содержанию файла как файловая система.
static FileSystem	newFileSystem(URI uri, Map<String,?> env) Создает новую файловую систему, которая идентифицируется a URI
static FileSystem	newFileSystem(URI uri, Map<String,?> env, ClassLoader loader) Создает новую файловую систему, которая идентифицируется a URI

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

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

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

getDefault

public static FileSystem getDefault()

Возвращает значение по умолчанию FileSystem. Файловая система по умолчанию создает объекты, которые обеспечивают доступ к файловым системам, доступным для виртуальной машины Java. Рабочий каталог файловой системы является текущим пользовательским каталогом, названным системным свойством user.dir. Это учитывает функциональную совместимость с java.io.File класс.

Первый вызов любого из методов, определенных этим классом, определяет местоположение значения по умолчанию provider объект. Где системное свойство java.nio.file.spi.DefaultFileSystemProvider не определяется тогда, провайдер по умолчанию является провайдером системного значения по умолчанию, который вызывается, чтобы создать файловую систему по умолчанию.

Если системное свойство java.nio.file.spi.DefaultFileSystemProvider определяется тогда, это берется, чтобы быть списком один или более полностью определенными именами конкретных классов провайдера, идентифицированных схемой URI "file". Где свойство является списком больше чем одного имени тогда, имена разделяются запятой. Каждый класс загружается, используя системный загрузчик класса, и инстанцируется, вызывая одного конструктора параметра, тип формального параметра которого FileSystemProvider. Провайдеры загружаются и инстанцируются в порядке, они перечисляются в свойстве. Если этот процесс сбои или схема провайдера не равен "file" тогда неустановленная ошибка бросается. Схемы URI обычно сравниваются без отношения, чтобы случиться, но для провайдера по умолчанию, схема обязана быть "file". Первый класс провайдера инстанцируют, вызывая это со ссылкой на провайдера системного значения по умолчанию. Второй класс провайдера инстанцируют, вызывая это со ссылкой на первый экземпляр провайдера. Третий класс провайдера инстанцируют, вызывая это со ссылкой на второй экземпляр и так далее. Последний провайдер, который инстанцируют, становится провайдером по умолчанию; getFileSystem метод вызывается с URI "file:///" получить ссылку на файловую систему по умолчанию.

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

Возвраты:

файловая система по умолчанию

getFileSystem

public static FileSystem getFileSystem(URI uri)

Возвращает ссылку на существующее FileSystem.

Этот метод выполняет итерации по installed провайдеры, чтобы определить местоположение провайдера, который идентифицируется URI scheme из данного URI. Схемы URI сравниваются без отношения, чтобы случиться. Точная форма URI является чрезвычайно зависимым провайдером. Если найдено, провайдер getFileSystem метод вызывается, чтобы получить ссылку на FileSystem.

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

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

Броски:

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

FileSystemNotFoundException - если файловая система, идентифицированная URI, не существует

ProviderNotFoundException - если провайдер, поддерживающий схему URI, не устанавливается

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

newFileSystem

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

Создает новую файловую систему, которая идентифицируется a URI

Этот метод выполняет итерации по installed провайдеры, чтобы определить местоположение провайдера, который идентифицируется URI scheme из данного URI. Схемы URI сравниваются без отношения, чтобы случиться. Точная форма URI является чрезвычайно зависимым провайдером. Если найдено, провайдер newFileSystem(URI,Map) метод вызывается, чтобы создать новую файловую систему.

Как только файловая система closed это зависимо от провайдера, если провайдер позволяет новой файловой системе создаваться с тем же самым URI как файловая система, это ранее создало.

Пример использования: Предположите, что есть провайдер, идентифицированный схемой "memory" установленный:

   Map<String,String> env = new HashMap<>();
   env.put("capacity", "16G");
   env.put("blockSize", "4k");
   FileSystem fs = FileSystems.newFileSystem(URI.create("memory:///?name=logfs"), env);
 

Параметры:

uri - URI, идентифицирующий файловую систему

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

Возвраты:

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

Броски:

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

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

ProviderNotFoundException - если провайдер, поддерживающий схему URI, не устанавливается

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

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

newFileSystem

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

Создает новую файловую систему, которая идентифицируется a URI

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

Параметры:

uri - URI, идентифицирующий файловую систему

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

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

Возвраты:

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

Броски:

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

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

ProviderNotFoundException - если провайдер, поддерживающий схему URI, не находится

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

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

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

newFileSystem

public static FileSystem newFileSystem(Path path,
                       ClassLoader loader)
                                throws IOException

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

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

Этот метод выполняет итерации по installed провайдеры. Это вызывает, поочередно, каждого провайдера newFileSystem(Path,Map) метод с пустой картой. Если провайдер возвращает файловую систему тогда, итерация завершается, и файловая система возвращается. Если ни один из установленных провайдеров не возвращает a FileSystem тогда попытка предпринимается, чтобы определить местоположение провайдера, используя данный загрузчик класса. Если провайдер возвращает файловую систему тогда, поиск завершается, и файловая система возвращается.

Параметры:

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

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

Возвраты:

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

Броски:

ProviderNotFoundException - если провайдер, поддерживающий этот тип файла, не может быть расположен

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

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

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