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

Для интерпретации шаблонов 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".

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

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

• Начальные точки/ в именах файлов рассматриваются при сопоставлении как обычные символы. Например, шаблон glob "*" соответствует имени файла ".login". Чтобы проверить, считается ли файл скрытым, можно использовать метод Files.isHidden(Path).

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

• Сопоставление компонентов root в значительной степени зависит от реализации и не определено.

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

Для синтаксисов glob и regex детали сопоставления, например чувствительность к регистру, зависят от реализации и поэтому не определены.

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

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

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