java.nio.file.attribute

インタフェース 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()

最終変更時間を返します。

最終変更時間を示すタイムスタンプがファイルシステム実装でサポートされていない場合、このメソッドは実装固有のデフォルト値 (通常は元期 (1970-01-01T00:00:00Z) を表す FileTime) を返します。

戻り値:

ファイルが最後の変更された時間を表す FileTime

lastAccessTime

FileTime lastAccessTime()

最終アクセス時間を返します。

最終アクセス時間を示すタイムスタンプがファイルシステム実装でサポートされていない場合、このメソッドは実装固有のデフォルト値 (通常は最終変更時間、または元期 (1970-01-01T00:00:00Z) を表す FileTime) を返します。

戻り値:

最終アクセス時間を表す FileTime

creationTime

FileTime creationTime()

作成時間を返します。作成時間は、ファイルが作成された時間です。

ファイルが作成された時間を示すタイムスタンプがファイルシステム実装でサポートされていない場合、このメソッドは実装固有のデフォルト値 (通常は最終変更時間、または元期 (1970-01-01T00:00:00Z) を表す FileTime) を返します。

戻り値:

ファイルが作成された時間を表す FileTime

isRegularFile

boolean isRegularFile()

ファイルが不明瞭な内容の通常ファイルかどうかを判断します。

isDirectory

boolean isDirectory()

ファイルがディレクトリかどうかを判断します。

isSymbolicLink

boolean isSymbolicLink()

ファイルがシンボリックリンクかどうかを判断します。

isOther

boolean isOther()

ファイルが通常のファイル、ディレクトリ、またはシンボリックリンク以外のものであるかどうかを判断します。

size

long size()

ファイルのサイズをバイトで返します。圧縮、スパースファイルのサポート、またはその他の理由により、サイズがファイルシステム上の実際のサイズと異なる場合があります。regular ファイルでないファイルのサイズは実装固有であるため未指定です。

戻り値:

ファイルサイズ (バイト)

fileKey

Object fileKey()

指定されたファイルを一意に識別するオブジェクトを返します。ファイルキーがない場合は null を返します。一部のプラットフォームまたはファイルシステムでは、ファイルを一意に識別するために識別子または識別子の組み合わせを使用できます。このような識別子は、シンボリックリンクをサポートしているファイルシステムや、1 つのファイルを複数のディレクトリのエントリにできるファイルシステムでの、ファイルツリートラバーサルなどの操作に重要です。たとえば、UNIX ファイルシステムでは、デバイス ID や inode がそのような目的でよく使われています。

このメソッドによって返されるファイルキーは、ファイルシステムとファイルが static のままである場合にのみ一意であることが保証されています。ファイルを削除したあとでファイルシステムが識別子を再利用するかどうかは、実装に依存するため、特定できません。

このメソッドによって返されるファイルキーは、等しいかどうかを比較できるため、コレクションでの使用に適しています。ファイルシステムとファイルが static のままであり、2 つのファイルが null 以外のファイルキーを持つ同じファイルである場合、それらのファイルキーは等しくなります。

関連項目:

Files.walkFileTree(java.nio.file.Path, java.util.Set<java.nio.file.FileVisitOption>, int, java.nio.file.FileVisitor<? super java.nio.file.Path>)