java.nio.file.attribute

インタフェース BasicFileAttributeView

すべてのスーパーインタフェース:

AttributeView、FileAttributeView

既知のすべてのサブインタフェース:

DosFileAttributeView, PosixFileAttributeView

public interface BasicFileAttributeView
extends FileAttributeView

多くのファイルシステムで一般的なファイル属性の基本セットのビューを提供するファイル属性ビューです。ファイル属性の基本セットは、BasicFileAttributes インタフェースで定義されている必須およびオプションのファイル属性で構成されます。

一括操作としてファイル属性をファイルシステムから取得するには、readAttributes メソッドを呼び出します。このクラスでは、ファイルの時間属性を更新する setTimes メソッドも定義しています。

ファイル属性への動的アクセスが必要な場合、この属性ビューによってサポートされている属性には次の名前と型があります。

名前	型
"lastModifiedTime"	FileTime
"lastAccessTime"	FileTime
"creationTime"	FileTime
"size"	Long
"isRegularFile"	Boolean
"isDirectory"	Boolean
"isSymbolicLink"	Boolean
"isOther"	Boolean
"fileKey"	Object

getAttribute メソッドは、readAttributes() メソッドを呼び出したかのように、これらの属性のいずれかを読み取るために使用できます。

setAttribute メソッドは、setTimes メソッドを呼び出したかのように、ファイルの最終変更時間、最終アクセス時間、または作成時間属性を更新するために使用できます。

導入されたバージョン:

1.7

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
String	name() 属性ビューの名前を返します。
BasicFileAttributes	readAttributes() 一括操作として基本ファイル属性を読み取ります。
void	setTimes(FileTime lastModifiedTime, FileTime lastAccessTime, FileTime createTime) ファイルの最終変更時間、最終アクセス時間、および作成時間属性のいずれかまたはすべてを更新します。

メソッドの詳細

name

String name()

属性ビューの名前を返します。この型の属性ビューは "basic" という名前です。

定義:

name、インタフェース: AttributeView

readAttributes

BasicFileAttributes readAttributes()
                                   throws IOException

一括操作として基本ファイル属性を読み取ります。

ほかのファイルシステム操作に関して、すべてのファイル属性が原子的操作として読み取られるかどうかは実装固有です。

戻り値:

ファイル属性

例外:

IOException - 入出力エラーが発生した場合

SecurityException - デフォルトプロバイダで、セキュリティーマネージャーがインストールされている場合は、checkRead メソッドが呼び出されてファイルへの読み取りアクセスがチェックされます。

setTimes

void setTimes(FileTime lastModifiedTime,
            FileTime lastAccessTime,
            FileTime createTime)
              throws IOException

ファイルの最終変更時間、最終アクセス時間、および作成時間属性のいずれかまたはすべてを更新します。

このメソッドは、ファイルのタイムスタンプ属性を更新します。値は、そのファイルシステムでサポートされている元期と精度に変換されます。粒度の細かいほうから粗いほうへ変換すると、精度が失われます。サポートされていないタイムスタンプを設定したり、タイムスタンプをベースとなるファイルストアのサポート範囲外にある値に設定したりしようとする場合、このメソッドの動作は未定義です。IOException をスローすることによって、失敗する場合としない場合があります。

lastModifiedTime、lastAccessTime、または createTime のいずれかのパラメータに null 値が含まれている場合、対応するタイムスタンプは変更されません。タイムスタンプ属性のすべてではなく一部のみが更新される場合、実装ではそれらのファイル属性の既存値を読み取る必要があることがあります。その結果、このメソッドはほかのファイルシステム操作に関して原子的操作でない可能性があります。また、既存値の読み取りや書き換えを行うと、精度が失われる可能性もあります。lastModifiedTime、lastAccessTime、および createTime パラメータがすべて null の場合、このメソッドは何の効果もありません。

使用例: ファイルの作成時間を変更するとします。

    Path path = ...
    FileTime time = ...
    Files.getFileAttributeView(path, BasicFileAttributeView.class).setTimes(null, null, time);
 

パラメータ:

lastModifiedTime - 新しい最終変更時間。値を変更しない場合は null

lastAccessTime - 最終アクセス時間。値を変更しない場合は null

createTime - ファイルの作成時間。値を変更しない場合は null

例外:

IOException - 入出力エラーが発生した場合

SecurityException - デフォルトプロバイダで、セキュリティーマネージャーがインストールされている場合は、checkWrite メソッドが呼び出されてファイルへの書き込みアクセスがチェックされます。

関連項目:

Files.setLastModifiedTime(java.nio.file.Path, java.nio.file.attribute.FileTime)