Интерфейс 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)

© 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.