Класс FileStore

java.lang.Object

java.nio.file.FileStore

public abstract class FileStore extends Object

Хранилище для файлов. A FileStore представляет пул хранилища, устройство, раздел, том, конкретную файловую систему или другую реализацию, специфическую для хранения файлов. FileStore, где хранится файл, получается путем вызова метода getFileStore, или все файловые хранилища могут быть перечислены путем вызова метода getFileStores.

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

Since:: 1.7

Краткое описание конструкторов

FileStore()

Модификатор	Конструктор	Описание
`protected`	Инициализирует новый экземпляр этого класса.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract Object`	`getAttribute(String attribute)`	Читает значение атрибута файлового хранилища.
`long`	`getBlockSize()`	Возвращает количество байтов на блок в этом файловом хранилище.
`abstract <V extends FileStoreAttributeView> V`	`getFileStoreAttributeView(Class<V> type)`	Возвращает `FileStoreAttributeView` заданного типа.
`abstract long`	`getTotalSpace()`	Возвращает размер файлового хранилища в байтах.
`abstract long`	`getUnallocatedSpace()`	Возвращает количество невыделенных байтов в файловом хранилище.
`abstract long`	`getUsableSpace()`	Возвращает количество байтов, доступных для этой виртуальной машины Java в файловом хранилище.
`abstract boolean`	`isReadOnly()`	Указывает, является ли это файловое хранилище только для чтения.
`abstract String`	`name()`	Возвращает имя этого файлового хранилища.
`abstract boolean`	`supportsFileAttributeView(Class<? extends FileAttributeView> type)`	Указывает, поддерживает ли это файловое хранилище атрибуты файлов, идентифицируемые заданным представлением атрибутов файла.
`abstract boolean`	`supportsFileAttributeView(String name)`	Указывает, поддерживает ли это файловое хранилище атрибуты файлов, идентифицируемые заданным представлением атрибутов файла.
`abstract String`	`type()`	Возвращает тип этого файлового хранилища.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

FileStore

protected FileStore()

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

Подробное описание методов

name

public abstract String name()

Возвращает имя этого хранилища файлов. Формат имени сильно зависит от реализации. Обычно это имя пула хранения или тома.

Строка, возвращаемая этим методом, может отличаться от строки, возвращаемой методом toString.

Возвращает:: имя этого хранилища файлов

type

public abstract String type()

Возвращает тип этого хранилища файлов. Формат строки, возвращаемой этим методом, сильно зависит от реализации. Он может, например, указывать используемый формат или является ли хранилище файлов локальным или удалённым.

Возвращает:: строка, представляющая тип этого хранилища файлов

isReadOnly

public abstract boolean isReadOnly()

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

Возвращает:: true, если и только если это хранилище файлов только для чтения

getTotalSpace

public abstract long getTotalSpace() throws IOException

Возвращает размер хранилища файлов в байтах. Если общее количество байтов в хранилище файлов больше, чем Long.MAX_VALUE, то будет возвращено Long.MAX_VALUE.

Возвращает:: размер хранилища файлов в байтах
Имеет исключения:: IOException - если произошла ошибка ввода-вывода

getUsableSpace

public abstract long getUsableSpace() throws IOException

Возвращает количество байтов, доступных для этой виртуальной машины Java в хранилище файлов. Если количество доступных байтов больше, чем Long.MAX_VALUE, то будет возвращено Long.MAX_VALUE.

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

Возвращает:: текущее количество доступных байтов
Имеет исключения:: IOException - если произошла ошибка ввода-вывода

getUnallocatedSpace

public abstract long getUnallocatedSpace() throws IOException

Возвращает количество нераспределённых байтов в хранилище файлов. Если количество нераспределённых байтов больше, чем Long.MAX_VALUE, то будет возвращено Long.MAX_VALUE.

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

Возвращает:: текущее количество нераспределённых байтов
Имеет исключения:: IOException - если произошла ошибка ввода-вывода

getBlockSize

public long getBlockSize() throws IOException

Возвращает количество байтов на блок в этом хранилище файлов.

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

Требования к реализации:: Реализация в этом классе бросает исключение UnsupportedOperationException.
Возвращает:: положительное значение, представляющее размер блока этого хранилища файлов в байтах
Имеет исключения:: IOException - если произошла ошибка ввода-вывода; UnsupportedOperationException - если операция не поддерживается
С тех пор:: 10

supportsFileAttributeView

public abstract boolean supportsFileAttributeView(Class<? extends FileAttributeView> type)

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

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

Параметры:: type - тип представления атрибутов файла
Возвращает:: true, если и только если представление атрибутов файла поддерживается

supportsFileAttributeView

public abstract boolean supportsFileAttributeView(String name)

Вызов этого метода для проверки, поддерживает ли хранилище файлов BasicFileAttributeView, идентифицируемого именем "basic", всегда вернёт true. В случае с поставщиком по умолчанию, этот метод не может гарантировать правильный результат, когда хранилище файлов не является локальным устройством хранения. Причины этого специфичны для реализации и, следовательно, не определены.

Параметры:: name - name представления атрибутов файла
Возвращает:: true, если и только если представление атрибутов файла поддерживается

getFileStoreAttributeView

public abstract <V extends FileStoreAttributeView> V getFileStoreAttributeView(Class<V> type)

Возвращает FileStoreAttributeView заданного типа.

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

Типовые параметры:: V - тип FileStoreAttributeView
Параметры:: type - объект Class, соответствующий представлению атрибутов
Возвращает:: представление атрибутов хранилища файлов указанного типа или null, если представление атрибутов недоступно

getAttribute

public abstract Object getAttribute(String attribute) throws IOException

Считывает значение атрибута хранилища файлов.

Параметр attribute идентифицирует атрибут для чтения и имеет вид:

имя-представления:имя-атрибута

где символ ':' обозначает сам себя.

имя-представления - это name AttributeView, который идентифицирует набор атрибутов файла. имя-атрибута - это имя атрибута.

Пример использования: Предположим, мы хотим узнать, включена ли ZFS-сжатие (предполагая, что представление "zfs" поддерживается):

    boolean compression = (Boolean)fs.getAttribute("zfs:compression");

Параметры:: attribute - атрибут для чтения
Возвращает:: значение атрибута; null может быть допустимым для некоторых атрибутов
Имеет исключения:: UnsupportedOperationException - если представление атрибутов недоступно или оно не поддерживает чтение атрибута; IOException - если произошла ошибка ввода-вывода

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/nio/file/FileStore.html