Spec-Zone.ru › OpenJDK 24

Интерфейс 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-файловых системах для этих целей обычно используются идентификатор устройства и inode.

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

Ключи файлов, возвращаемые этим методом, могут сравниваться на равенство и подходят для использования в коллекциях. Если файловая система и файлы остаются неизменными, и два файла являются 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, 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/BasicFileAttributes.html

Spec-Zone.ru

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