Класс FileSystem

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

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

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

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

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

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

При установке менеджера безопасности он вызывается для проверки доступа к каждому корневому каталогу. Если доступ запрещен, корневой каталог не возвращается итератором. В случае поставщика по умолчанию вызывается метод SecurityManager.checkRead(String) для проверки доступа для чтения к каждому корневому каталогу. Зависит от системы, выполняются ли проверки разрешений при получении итератора или во время итерации.

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

В случае поставщика по умолчанию, если установлен менеджер безопасности, менеджер безопасности вызывается для проверки RuntimePermission("getFileStoreAttributes"). Если доступ запрещен, хранилища файлов не возвращаются итератором. Кроме того, вызывается метод менеджера безопасности SecurityManager.checkRead(String) для проверки доступа для чтения к верхнему каталогу хранилища. Если доступ запрещен, хранилище файлов не возвращается итератором. Зависит от системы, выполняются ли проверки разрешений при получении итератора или во время итерации.

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

    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(java.nio.file.Path) можно использовать для проверки, является ли файл скрытым.

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

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

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

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

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

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

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