Класс FileSystem

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

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

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

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

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

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

Элементы возвращенного итератора — это объекты 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"));

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