Spec-Zone.ru › OpenJDK 21

Интерфейс BasicFileAttributes

Все известные подинтерфейсы:
DosFileAttributes, PosixFileAttributes
public interface BasicFileAttributes
Основные атрибуты, связанные с файлом в файловой системе.

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

Пример использования:

    Path file = ...
    BasicFileAttributes attrs = Files.readAttributes(file, BasicFileAttributes.class);
С:
1.7
См. также:
  • BasicFileAttributeView

Краткое описание методов

Модификатор и тип Метод Описание
FileTime creationTime()
Возвращает время создания.
Object fileKey()
Возвращает объект, уникально идентифицирующий данный файл, или null если ключ файла недоступен.
boolean isDirectory()
Указывает, является ли файл каталогом.
boolean isOther()
Указывает, является ли файл чем-то иным, чем обычный файл, каталог или символическая ссылка.
boolean isRegularFile()
Указывает, является ли файл обычным файлом с непрозрачным содержимым.
boolean isSymbolicLink()
Указывает, является ли файл символической ссылкой.
FileTime lastAccessTime()
Возвращает время последнего доступа.
FileTime lastModifiedTime()
Возвращает время последнего изменения.
long size()
Возвращает размер файла (в байтах).

Подробное описание методов

lastModifiedTime

FileTime lastModifiedTime()
Возвращает время последнего изменения.

Если реализация файловой системы не поддерживает временную метку для указания времени последнего изменения, то этот метод возвращает специфичное для реализации значение по умолчанию, обычно FileTime представляющее эпоху (1970-01-01T00:00:00Z).

Возвращает:
объект FileTime , представляющий время последнего изменения файла

lastAccessTime

FileTime lastAccessTime()
Возвращает время последнего доступа.

Если реализация файловой системы не поддерживает временную метку для указания времени последнего доступа, то этот метод возвращает специфичное для реализации значение по умолчанию, обычно last-modified-time или FileTime представляющее эпоху (1970-01-01T00:00:00Z).

Возвращает:
объект FileTime , представляющий время последнего доступа

creationTime

FileTime creationTime()
Возвращает время создания. Время создания — это время создания файла.

Если реализация файловой системы не поддерживает временную метку для указания времени создания файла, то этот метод возвращает специфичное для реализации значение по умолчанию, обычно last-modified-time или FileTime представляющее эпоху (1970-01-01T00:00:00Z).

Возвращает:
объект FileTime , представляющий время создания файла

isRegularFile

boolean isRegularFile()
Указывает, является ли файл обычным файлом с непрозрачным содержимым.
Возвращает:
true если файл является обычным файлом с непрозрачным содержимым

isDirectory

boolean isDirectory()
Указывает, является ли файл каталогом.
Возвращает:
true если файл является каталогом

isSymbolicLink

boolean isSymbolicLink()
Указывает, является ли файл символической ссылкой.
Возвращает:
true если файл является символической ссылкой

isOther

boolean isOther()
Указывает, является ли файл чем-то иным, чем обычный файл, каталог или символическая ссылка.
Возвращает:
true если файл является чем-то иным, чем обычный файл, каталог или символическая ссылка

size

long size()
Возвращает размер файла (в байтах). Размер может отличаться от фактического размера в файловой системе из-за сжатия, поддержки разреженных файлов или по другим причинам. Размер файлов, которые не являются regular файлами, зависит от реализации и, следовательно, не определен.
Возвращает:
размер файла в байтах

fileKey

Object fileKey()
Возвращает объект, уникально идентифицирующий данный файл, или null если ключ файла недоступен. На некоторых платформах или файловых системах можно использовать идентификатор или комбинацию идентификаторов для уникальной идентификации файла. Такие идентификаторы важны для операций, таких как обход дерева файлов в файловых системах, которые поддерживают символические ссылки или файловых системах, которые позволяют файлу быть записью в более чем одном каталоге. Например, в UNIX-файловых системах для этих целей обычно используются идентификатор устройства и инод.

Гарантируется, что ключ файла, возвращаемый этим методом, уникален только в случае, если файловая система и файлы остаются статическими. Вопрос о повторном использовании идентификаторов файловой системы после удаления файла зависит от реализации и, следовательно, не определен.

Ключи файлов, возвращаемые этим методом, могут сравниваться на равенство и подходят для использования в коллекциях. Если файловая система и файлы остаются статическими, и два файла — это same с не-null ключами файлов, то их ключи файлов равны.

Возвращает:
объект, уникально идентифицирующий данный файл, или null
См. также:
  • Files.walkFileTree(java.nio.file.Path, java.util.Set<java.nio.file.FileVisitOption>, int, java.nio.file.FileVisitor<? super java.nio.file.Path>)

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/attribute/BasicFileAttributes.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API