Класс FileSystems

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

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

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

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

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

Методы

getDefault

public static FileSystem getDefault()

Возвращает:

стандартную файловую систему

getFileSystem

public static FileSystem getFileSystem(URI uri)

Параметры:

uri - URI для поиска файловой системы

Возвращает:

ссылку на файловую систему

Исключения:

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

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

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

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

newFileSystem

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

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

Параметры:

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

Параметры:

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

loader - загрузчик классов для поиска поставщика или null для поиска только установленных поставщиков

Возвращает:

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

Исключения:

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

ServiceConfigurationError - при ошибке загрузки поставщика услуг

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

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