Класс FileSystem

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

Закрытие файловой системы закроет все открытые channels, directory-streams, watch-service и другие закрываемые объекты, связанные с этой файловой системой. Файловая система default закрыть нельзя.

Файловые системы, созданные поставщиком по умолчанию, всегда открыты.

Разделитель имен используется для разделения имен в строке пути. Реализация может поддерживать несколько разделителей имен, в этом случае этот метод возвращает реализацию-специфичный стандартный разделитель имен. Этот разделитель используется при создании строк путей, вызывая метод toString().

В случае с поставщиком по умолчанию этот метод возвращает тот же разделитель, что и File.separator.

Файловая система предоставляет доступ к файловому хранилищу, которое может состоять из ряда различных файловых иерархий, каждая со своим корневым каталогом верхнего уровня. Каждый элемент в возвращаемом итераторе соответствует корневому каталогу отдельной файловой иерархии. Порядок элементов не определен. Файловые иерархии могут изменяться в течение жизненного цикла виртуальной машины Java. Например, в некоторых реализациях вставка съемных носителей может привести к созданию новой файловой иерархии со своим собственным корневым каталогом. Нет гарантии, что к корневому каталогу можно получить доступ.

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

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

    for (FileStore store: FileSystems.getDefault().getFileStores()) {
        long total = store.getTotalSpace() / 1024;
        long used = (store.getTotalSpace() - store.getUnallocatedSpace()) / 1024;
        long avail = store.getUsableSpace() / 1024;
        System.out.format("%-20s %12d %12d %12d%n", store, total, used, avail);
    }

Представление атрибутов файла BasicFileAttributeView должно поддерживаться, поэтому набор содержит по крайней мере один элемент «basic».

Метод supportsFileAttributeView(String) можно использовать для проверки, поддерживает ли базовое FileStore атрибуты файла, определяемые представлением атрибутов файла.

Разбор и преобразование в объект пути по своей сути зависят от реализации. В самом простом случае строка пути отклоняется, и выбрасывается исключение InvalidPathException, если строка пути содержит символы, которые не могут быть преобразованы в символы, являющиеся допустимыми для файлового хранилища. Например, в системах UNIX символ NUL (\u0000) не может быть в пути. Реализация может отклонить строки пути, содержащие имена, длина которых превышает длину, разрешенную любым файловым хранилищем, и в случае, если реализация поддерживает сложный синтаксис пути, она может отклонить строки пути, которые неправильно сформированы.

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

Этот метод выбрасывает InvalidPathException, когда строка пути не может быть преобразована в путь. В тех случаях, где это возможно и применимо, исключение создается со значением index, указывающим первую позицию в параметре path, которая привела к отклонению строки пути.

 syntax:pattern
 

Реализация FileSystem поддерживает синтаксисы "glob" и "regex" и может поддерживать другие. Значение компонента синтаксиса сравнивается без учёта регистра.

Если синтаксис равен "glob", то представление пути сопоставляется с помощью ограниченного языка шаблонов, напоминающего регулярные выражения, но с более простым синтаксисом. Например:

Следующие правила используются для интерпретации шаблонов:

• Символ * сопоставляет ноль или более characters компонента имени name без пересечения границ каталогов.

• Символ ** сопоставляет ноль или более characters, пересекая границы каталогов.

• Символ ? сопоставляет ровно один символ компонента имени.

• Символ обратной косой черты (\) используется для экранирования символов, которые в противном случае интерпретируются как специальные символы. Выражение \\ сопоставляет одну обратную косую черту, а "\{" сопоставляет левую фигурную скобку, например.

• Символы [ ] — это выражение в квадратных скобках, которое сопоставляет один символ компонента имени из набора символов. Например, [abc] сопоставляет "a", "b" или "c". Тире (-) может использоваться для указания диапазона, поэтому [a-z] задаёт диапазон, который сопоставляет символы от "a" до "z" (включительно). Эти формы могут быть смешаны, поэтому [abce-g] сопоставляет "a", "b", "c", "e", "f" или "g". Если символ после [ — это !, то он используется для отрицания, поэтому [!a-c] сопоставляет любой символ, кроме "a", "b" или "c".

  Внутри выражения в квадратных скобках символы *, ? и \ сопоставляют сами себя. Символ (-) сопоставляет сам себя, если он является первым символом в скобках или первым символом после !, если отрицание.

• Символы { } представляют собой группу подшаблонов, где группа сопоставляется, если любой подшаблон в группе сопоставляется. Символ "," используется для разделения подшаблонов. Группы не могут быть вложены.

• Ведущие точки в имени файла рассматриваются как обычные символы в операциях сопоставления. Например, шаблон "*" сопоставляется с именем файла ".login". Метод Files.isHidden(java.nio.file.Path) может быть использован для проверки, является ли файл скрытым.

• Все остальные символы сопоставляют сами себя в зависимости от реализации. Это включает символы, представляющие любой name-separators.

• Сопоставление компонентов root сильно зависит от реализации и не специфицируется.

Если синтаксис равен "regex", то компонент шаблона является регулярным выражением, определённым классом Pattern.

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

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

    UserPrincipalLookupService lookupService = FileSystems.getDefault().getUserPrincipalLookupService();
    Files.setOwner(path, lookupService.lookupPrincipalByName("joe"));

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