compact1, compact2, compact3

java.nio.file

Класс FileSystems

java.lang. Объект

java.nio.file. FileSystems

public final class FileSystems
extends Object

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

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

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

Этот class также определяет методы фабрики, которые позволяют 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

Методы, наследованные от class 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 class.

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

Если системное свойство java.nio.file.spi.DefaultFileSystemProvider определяется тогда, это берется, чтобы быть списком один или более полностью определенными именами конкретных классов провайдера, идентифицированных схемой URI "file". Где свойство является списком больше чем одного имени тогда, имена разделяются запятой. Каждый class загружается, используя систему загрузчик class, и инстанцируется, вызывая одного конструктора параметра, тип формального параметра которого FileSystemProvider. Провайдеры загружаются и инстанцируются в порядке, они перечисляются в свойстве. Если этот процесс сбои или схема провайдера не равен "file" тогда неустановленная ошибка бросается. Схемы URI обычно сравниваются без отношения, чтобы случиться, но для провайдера значения по умолчанию, схема обязана быть "file". Первый провайдер class инстанцируют, вызывая это со ссылкой на провайдера системного значения по умолчанию. Второй провайдер class инстанцируют, вызывая это со ссылкой на первый экземпляр провайдера. Третий провайдер class инстанцируют, вызывая это со ссылкой на второй экземпляр и так далее. Последний провайдер, который инстанцируют, становится провайдером значения по умолчанию; 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 тогда, попытка предпринимается, чтобы определить местоположение провайдера, используя данный загрузчик class. Если провайдер, поддерживающий схему URI, располагается тогда newFileSystem(URI,Map) вызывается, чтобы создать новую файловую систему.

Параметры:

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

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

loader - загрузчик class, чтобы определить местоположение провайдера или 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 тогда попытка предпринимается, чтобы определить местоположение провайдера, используя данный загрузчик class. Если провайдер возвращает файловую систему тогда, поиск завершается, и файловая система возвращается.

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

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