Класс FileSystem

protected FileSystem()

Инициализирует новый экземпляр этого класса.

public abstract FileSystemProvider provider()

Возвращает поставщика, который создал эту файловую систему.

public abstract void close() throws IOException

Закрывает эту файловую систему.

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

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

public abstract boolean isOpen()

Указывает, открыта ли эта файловая система.

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

public abstract boolean isReadOnly()

Указывает, разрешает ли эта файловая система только чтение для своих хранилищ файлов.

public abstract String getSeparator()

Возвращает разделитель имен в виде строки.

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

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

public abstract Iterable<Path> getRootDirectories()

Возвращает объект для итерации по путям корневых каталогов.

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

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

public abstract Iterable<FileStore> getFileStores()

Возвращает объект для итерации по хранилищам файлов.

Элементы возвращаемого итератора представляют собой объекты 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);
     }
 

public abstract Set<String> supportedFileAttributeViews()

Возвращает набор names представлений атрибутов файлов, поддерживаемых этой FileSystem.

BasicFileAttributeView обязательно должен поддерживаться, поэтому набор содержит как минимум один элемент, "basic".

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

public abstract Path getPath(String first, String... more)

Преобразует строку пути или последовательность строк, которые при объединении образуют строку пути, в Path. Если more не определяет никаких элементов, то значение параметра first является строкой пути, которую необходимо преобразовать. Если more определяет один или несколько элементов, то каждая непустая строка, включая first, рассматривается как последовательность элементов имени (см. Path) и объединяется для образования строки пути. Подробности о том, как строки объединяются, зависят от поставщика, но обычно они объединяются с использованием name-separator в качестве разделителя. Например, если разделитель имен равен "/" и вызван метод getPath("/foo","bar","gus"), то строка пути "/foo/bar/gus" преобразуется в Path. Path представляющий пустой путь, возвращается, если first является пустой строкой и more не содержит никаких непустых строк.

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

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

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

public abstract PathMatcher getPathMatcher(String syntaxAndPattern)

Возвращает PathMatcher, который выполняет операции сопоставления с представлением String объектов Path путём интерпретации заданного шаблона. Параметр syntaxAndPattern определяет синтаксис и шаблон и имеет вид:

 syntax:pattern
 

где ':' обозначает себя.

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

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

Язык шаблонов

Пример	Описание
*.java	Сопоставляет путь, представляющий имя файла, оканчивающееся на .java
*.*	Сопоставляет имена файлов, содержащие точку
*.{java,class}	Сопоставляет имена файлов, оканчивающиеся на .java или .class
foo.?	Сопоставляет имена файлов, начинающиеся с foo. и односимвольным расширением
/home/*/*	Сопоставляет /home/gus/data на платформах UNIX
/home/**	Сопоставляет /home/gus и /home/gus/data на платформах UNIX
C:\\*	Сопоставляет C:\foo и C:\bar на платформе Windows (обратите внимание, что обратный слэш экранирован; как строковый литерал в языке Java, шаблон будет "C:\\\\*")

Следующие правила используются для интерпретации шаблонов 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 детали сопоставления, такие как чувствительность к регистру, зависят от реализации и поэтому не определены.

public abstract UserPrincipalLookupService getUserPrincipalLookupService()

Возвращает UserPrincipalLookupService для этой файловой системы (необязательная операция). Результирующая служба поиска может быть использована для поиска имён пользователей или групп.

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

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

public abstract WatchService newWatchService() throws IOException

Создаёт новый сервис WatchService (необязательная операция).

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