Класс FileSystems

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:///" для получения ссылки на стандартную файловую систему.

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

public static FileSystem getFileSystem(URI uri)

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

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

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

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

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

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

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

После закрытия файловой системы с помощью closed поведение зависит от поставщика: если поставщик позволяет создавать новую файловую систему с тем же URI, что и предыдущая, то он может по своему усмотрению действовать.

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

  FileSystem fs = FileSystems.newFileSystem(URI.create("memory:///?name=logfs"),
                                            Map.of("capacity", "16G", "blockSize", "4k"));
 

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

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

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

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

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

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

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

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

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

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

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

public static FileSystem newFileSystem(Path path) throws IOException

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

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

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

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

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

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

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