Класс FileStore

java.lang.Object
- java.nio.file.FileStore

public abstract class FileStore
extends Object

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

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

Since:: 1.7

Конструкторы

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

Методы

Модификатор и тип	Метод и описание
`abstract Object`	`getAttribute(String attribute)` Читает значение атрибута хранилища файлов.
`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

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

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

getUsableSpace

public abstract long getUsableSpace()
                             throws IOException

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

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

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

getUnallocatedSpace

public abstract long getUnallocatedSpace()
                                  throws IOException

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

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

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

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, 2020, 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.