Интерфейс 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 |
Обновляет любое или все атрибуты времени последнего изменения, последнего доступа и создания файла. |
Подробное описание методов
name
String name()
"basic".- Определено в:
-
nameв интерфейсеAttributeView - Возвращает:
- имя представления атрибутов
readAttributes
BasicFileAttributes readAttributes() throws IOException
Реализация определяет, будут ли все атрибуты файла читаться как атомарная операция по отношению к другим операциям файловой системы.
- Возвращает:
- атрибуты файла
- Выбрасывает:
-
IOException- если произошла ошибка ввода-вывода
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- если произошла ошибка ввода-вывода - См. также:
© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/nio/file/attribute/BasicFileAttributeView.html
