Интерфейс BasicFileAttributeView

Все суперинтерфейсы:: AttributeView, FileAttributeView

Все известные подинтерфейсы:: DosFileAttributeView, PosixFileAttributeView

public interface BasicFileAttributeView
extends FileAttributeView

Представление атрибутов файла, предоставляющее представление основного набора атрибутов файлов, общих для многих файловых систем. Основной набор атрибутов файлов состоит из обязательных и необязательных атрибутов файлов, как определено интерфейсом BasicFileAttributes.

Атрибуты файла извлекаются из файловой системы как операция сжатия, вызывая метод readAttributes. Этот класс также определяет метод setTimes для обновления временных атрибутов файла.

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

Имя	Тип
"lastModifiedTime"	`FileTime`
"lastAccessTime"	`FileTime`
"creationTime"	`FileTime`
"size"	`Long`
"isRegularFile"	`Boolean`
"isDirectory"	`Boolean`
"isSymbolicLink"	`Boolean`
"isOther"	`Boolean`
"fileKey"	`Object`

Метод getAttribute может использоваться для чтения любого из этих атрибутов так, как если бы вызывался метод readAttributes().

Метод setAttribute может использоваться для обновления атрибутов времени последнего изменения, последнего доступа или создания файла так, как если бы вызывался метод setTimes.

С:: 1.7

Методы

Модификатор и тип	Метод	Описание
`String`	`name()`	Возвращает имя представления атрибутов.
`BasicFileAttributes`	`readAttributes()`	Читает базовые атрибуты файла как единую операцию.
`void`	`setTimes(FileTime lastModifiedTime, FileTime lastAccessTime, FileTime createTime)`	Обновляет любое или все из атрибутов времени последнего изменения, последнего доступа и создания файла.

Методы

name

String name()

Возвращает имя представления атрибутов. Представления атрибутов этого типа имеют имя "basic".

Определено в:: name в интерфейсе AttributeView
Возвращает:: имя представления атрибутов

readAttributes

BasicFileAttributes readAttributes()
                            throws IOException

Читает базовые атрибуты файла как единую операцию.

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

Возвращает:: атрибуты файла
Исключения:: IOException - если произошла ошибка ввода-вывода; SecurityException - В случае с предустановленным поставщиком, если установлен менеджер безопасности, вызывается его метод checkRead для проверки доступа на чтение к файлу

setTimes

void setTimes(FileTime lastModifiedTime,
              FileTime lastAccessTime,
              FileTime createTime)
       throws IOException

Обновляет любое или все из атрибутов времени последнего изменения, последнего доступа и создания файла.

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

Если любой из lastModifiedTime, lastAccessTime, или createTime параметров имеет значение null, то соответствующая временная метка не изменяется. Реализация может потребовать чтения существующих значений атрибутов файла, когда обновляются только некоторые, но не все, атрибуты временных меток. Следовательно, этот метод может не быть атомной операцией по отношению к другим операциям с файловой системой. Чтение и перезапись существующих значений также может привести к потере точности. Если все lastModifiedTime, lastAccessTime и createTime параметры имеют значение null, то этот метод не имеет эффекта.

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

Path path = ...
    FileTime time = ...
    Files.getFileAttributeView(path, BasicFileAttributeView.class).setTimes(null, time, null);

Параметры:: lastModifiedTime - новое время последнего изменения, или null для сохранения значения неизменным; lastAccessTime - время последнего доступа, или null для сохранения значения неизменным; createTime - время создания файла, или null для сохранения значения неизменным
Исключения:: IOException - если произошла ошибка ввода-вывода; SecurityException - В случае с предустановленным поставщиком, если установлен менеджер безопасности, вызывается его метод checkWrite для проверки доступа на запись к файлу
См. также:: Files.setLastModifiedTime(java.nio.file.Path, java.nio.file.attribute.FileTime)