java.nio.file.attribute

Интерфейсный BasicFileAttributeView

Все Суперинтерфейсы:

AttributeView, FileAttributeView

Все Известные Подынтерфейсы:

DosFileAttributeView, PosixFileAttributeView

public interface BasicFileAttributeView
extends FileAttributeView

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

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

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

Имя	Ввести
"lastModifiedTime"	FileTime
"lastAccessTime"	FileTime
"creationTime"	FileTime
"размер"	Long
"isRegularFile"	Boolean
"isDirectory"	Boolean
"isSymbolicLink"	Boolean
"isOther"	Boolean
"fileKey"	Object

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

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

С тех пор:

1.7

Сводка метода

Методы

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

Деталь метода

имя

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, null, time);
 

Параметры:

lastModifiedTime - новое прошлое измененное время, или null не изменить значение

lastAccessTime - прошлое время доступа, или null не изменить значение

createTime - файл создает время, или null не изменить значение

Броски:

IOException - если ошибка ввода-вывода происходит

SecurityException - В случае провайдера по умолчанию менеджер безопасности устанавливается, checkWrite метод вызывается, чтобы проверить доступ для записи к файлу

См. Также:

Files.setLastModifiedTime(java.nio.file.Path, java.nio.file.attribute.FileTime)