Spec-Zone.ru › OpenJDK 25

Интерфейс 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(Path, Set, int, FileVisitor)

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, где приведены более подробные описания для разработчиков, включая обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

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