Spec-Zone.ru › OpenJDK 17

Интерфейс 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).

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

lastAccessTime

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

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

Возвращает:
a FileTime представляющее время последнего доступа

creationTime

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

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

Возвращает:
a 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, 2021, 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/17/docs/api/java.base/java/nio/file/attribute/BasicFileAttributes.html

Spec-Zone.ru

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