Класс FileStore

java.lang.Object

java.nio.file.FileStore

public abstract class FileStore extends Object

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

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

С момента:: 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()`	Возвращает тип этого файлового хранилища.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения заданного промежутка реального времени.

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

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.