クラス FileSystemResource
- 実装されているすべてのインターフェース:
InputStreamSource, Resource, WritableResource
java.io.File および java.nio.file.Path の Resource 実装は、ファイルシステムターゲットで処理します。File および URL としての解決をサポートします。拡張 WritableResource インターフェースを実装します。 メモ: この Resource 実装は、読み取り / 書き込みのやり取りに NIO.2 API を使用し、PathSE ハンドルを使用して構築できます。その場合、すべてのファイルシステムやり取りは NIO.2 経由で実行され、getFile() では FileSE のみが使用されます。
- 導入:
- 28.12.2003
- 作成者:
- Juergen Hoeller, Sam Brannen
- 関連事項:
コンストラクターの概要
コンストラクターコンストラクター説明FileSystemResource(FileSE file) FileSE ハンドルから新しいFileSystemResourceを作成します。FileSystemResource(StringSE path) ファイルパスから新しいFileSystemResourceを作成します。FileSystemResource(FileSystemSE fileSystem, StringSE path) FileSystemSE ハンドルから新しいFileSystemResourceを作成し、指定されたパスを見つけます。FileSystemResource(PathSE filePath) メソッドのサマリー
修飾子と型メソッド説明longこの実装は、基になるファイル / パスの長さを返します。createRelative(StringSE relativePath) この実装は FileSystemResource を作成し、このリソース記述子の元となるファイルのパスに対して指定されたパスを適用します。booleanこの実装は、基になるファイルパスを比較します。booleanexists()この実装は、元となるファイルが存在するかどうかを返します。byte[]このリソースの内容をバイト配列として返します。getContentAsString(CharsetSE charset) 指定された文字セットを使用して、このリソースの内容を文字列として返します。この実装は、ファイルの絶対パスを含む説明を返します。getFile()この実装は、元となるファイル参照を返します。この実装は、ファイルの名前を返します。この実装は、基礎となる NIO パス参照を返します。この実装は、基になるファイルの NIO ファイルストリームを開きます。この実装は、基になるファイルの FileOutputStream を開きます。final StringSEgetPath()このリソースのファイルパスを返します。getURI()この実装は、元となるファイルの URI を返します。getURL()この実装は、元となるファイルの URL を返します。inthashCode()この実装は、基になるファイルパスのハッシュコードを返します。booleanisFile()この実装は常にファイルを示します。booleanこの実装は、元となるファイルが読み取り可能としてマークされているかどうかを確認します(ディレクトリではなく、コンテンツを含む実際のファイルに対応します)。booleanこの実装は、元となるファイルが書き込み可能としてマークされているかどうかを確認します(また、ディレクトリではなくコンテンツを含む実際のファイルに対応します)。longこの実装は、基になるファイル / パスの最終変更時刻を返します。この実装は、基になるファイルの FileChannel を開きます。この実装は、基になるファイルの FileChannel を開きます。クラス AbstractResource から継承されたメソッド
getFileForLastModifiedCheck, isOpen, toString
コンストラクターの詳細
FileSystemResource
ファイルパスから新しいFileSystemResourceを作成します。メモ:
createRelative(String)を介して相対リソースを構築する場合、ここで指定されたリソースベースパスがスラッシュで終わるかどうかが異なります。"C:/dir1/"" の場合、相対パスはそのルートに作成されます: たとえば、相対パス "dir2" → "C:/dir1/dir2""。"C:/dir1"" の場合、相対パスは同じディレクトリレベルに適用されます。: 相対パス "dir2"→ 「C:/dir2"。- パラメーター:
path- ファイルパス- 関連事項:
FileSystemResource
FileSE ハンドルから新しいFileSystemResourceを作成します。メモ:
createRelative(String)を介して相対リソースを構築する場合、相対パスは同じディレクトリレベルで適用されます : たとえば、new File("C:/dir1"), relative path "dir2" → "C:/dir2"! 指定されたルートディレクトリに相対パスを構築したい場合は、constructor with a file pathを使用してルートパスの末尾にスラッシュを追加します。: 「C:/dir1/"。これは、このディレクトリをすべての相対パスのルートとして示します。- パラメーター:
file- ファイルハンドル- 関連事項:
FileSystemResource
PathSE ハンドルから新しいFileSystemResourceを作成し、FileSE ではなく NIO.2 を介してすべてのファイルシステムの対話を実行します。PathResourceとは対照的に、このバリアントは、特にパスのクリーニングとcreateRelative(String)の処理に関して、一般的なFileSystemResourceの規則に厳密に従います。メモ:
createRelative(String)を介して相対リソースを構築する場合、相対パスは同じディレクトリレベルで適用されます : たとえば、Paths.get("C:/dir1"), 相対パス "dir2" → "C:/dir2"! 指定されたルートディレクトリに相対パスを構築したい場合は、constructor with a file pathを使用してルートパスの末尾にスラッシュを追加します。: 「C:/dir1/"。これは、このディレクトリをすべての相対パスのルートとして示します。または、createRelativeのjava.nio.path.Path解決にPathResource(Path)を使用し、常に相対パスをネストすることを検討してください。- パラメーター:
filePath- ファイルへのパスハンドル- 導入:
- 5.1
- 関連事項:
FileSystemResource
FileSystemSE ハンドルから新しいFileSystemResourceを作成し、指定されたパスを見つけます。これは
FileSystemResource(String)の代替であり、FileSE ではなく NIO.2 を介してすべてのファイルシステムの対話を実行します。- パラメーター:
fileSystem- FileSystem 内でパスを見つけるpath- ファイルパス- 導入:
- 5.1.1
- 関連事項:
メソッドの詳細
getPath
このリソースのファイルパスを返します。exists
public boolean exists()この実装は、元となるファイルが存在するかどうかを返します。- 次で指定:
- インターフェース
Resourceのexists - オーバーライド:
- クラス
AbstractResourceのexists - 関連事項:
isReadable
public boolean isReadable()この実装は、元となるファイルが読み取り可能としてマークされているかどうかを確認します(ディレクトリではなく、コンテンツを含む実際のファイルに対応します)。- 次で指定:
- インターフェース
ResourceのisReadable - オーバーライド:
- クラス
AbstractResourceのisReadable - 関連事項:
getInputStream
この実装は、基になるファイルの NIO ファイルストリームを開きます。- 次で指定:
- インターフェース
InputStreamSourceのgetInputStream - 戻り値:
- 基になるリソースの入力ストリーム (
nullであってはなりません) - 例外:
IOExceptionSE- コンテンツストリームを開けなかった場合- 関連事項:
getContentAsByteArray
インターフェースからコピーされた説明:Resourceこのリソースの内容をバイト配列として返します。- 次で指定:
- インターフェース
ResourceのgetContentAsByteArray - 戻り値:
- バイト配列としてのこのリソースの内容
- 例外:
IOExceptionSE- 一般的な解決 / 読み取りエラーの場合
getContentAsString
インターフェースからコピーされた説明:Resource指定された文字セットを使用して、このリソースの内容を文字列として返します。- 次で指定:
- インターフェース
ResourceのgetContentAsString - パラメーター:
charset- デコードに使用する文字セット- 戻り値:
- このリソースの内容を
Stringとして - 例外:
IOExceptionSE- 一般的な解決 / 読み取りエラーの場合
isWritable
public boolean isWritable()この実装は、元となるファイルが書き込み可能としてマークされているかどうかを確認します(また、ディレクトリではなくコンテンツを含む実際のファイルに対応します)。- 次で指定:
- インターフェース
WritableResourceのisWritable - 関連事項:
getOutputStream
この実装は、基になるファイルの FileOutputStream を開きます。- 次で指定:
- インターフェース
WritableResourceのgetOutputStream - 例外:
IOExceptionSE- ストリームを開けなかった場合- 関連事項:
getURL
この実装は、元となるファイルの URL を返します。- 次で指定:
- インターフェース
ResourceのgetURL - オーバーライド:
- クラス
AbstractResourceのgetURL - 例外:
IOExceptionSE- リソースを URL として解決できない場合、つまりリソースが記述子として使用できない場合- 関連事項:
getURI
この実装は、元となるファイルの URI を返します。- 次で指定:
- インターフェース
ResourceのgetURI - オーバーライド:
- クラス
AbstractResourceのgetURI - 例外:
IOExceptionSE- リソースを URI として解決できない場合、つまりリソースが記述子として使用できない場合- 関連事項:
isFile
public boolean isFile()この実装は常にファイルを示します。- 次で指定:
- インターフェース
ResourceのisFile - オーバーライド:
- クラス
AbstractResourceのisFile - 関連事項:
getFile
この実装は、元となるファイル参照を返します。- 次で指定:
- インターフェース
ResourceのgetFile - オーバーライド:
- クラス
AbstractResourceのgetFile - 関連事項:
getFilePath
readableChannel
この実装は、基になるファイルの FileChannel を開きます。- 次で指定:
- インターフェース
ResourceのreadableChannel - オーバーライド:
- クラス
AbstractResourceのreadableChannel - 戻り値:
- 基になるリソースのバイトチャネル (
nullであってはなりません) - 例外:
IOExceptionSE- コンテンツチャネルを開けなかった場合- 関連事項:
writableChannel
この実装は、基になるファイルの FileChannel を開きます。- 次で指定:
- インターフェース
WritableResourceのwritableChannel - 戻り値:
- 基になるリソースのバイトチャネル (
nullであってはなりません) - 例外:
IOExceptionSE- コンテンツチャネルを開けなかった場合- 関連事項:
contentLength
この実装は、基になるファイル / パスの長さを返します。- 次で指定:
- インターフェース
ResourceのcontentLength - オーバーライド:
- クラス
AbstractResourceのcontentLength - 例外:
IOExceptionSE- リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)- 関連事項:
lastModified
この実装は、基になるファイル / パスの最終変更時刻を返します。- 次で指定:
- インターフェース
ResourceのlastModified - オーバーライド:
- クラス
AbstractResourceのlastModified - 例外:
IOExceptionSE- リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)- 関連事項:
createRelative
この実装は FileSystemResource を作成し、このリソース記述子の元となるファイルのパスに対して指定されたパスを適用します。- 次で指定:
- インターフェース
ResourceのcreateRelative - オーバーライド:
- クラス
AbstractResourceのcreateRelative - パラメーター:
relativePath- 相対パス (このリソースに関連して)- 戻り値:
- 相対リソースのリソースハンドル
- 関連事項:
getFilename
この実装は、ファイルの名前を返します。- 次で指定:
- インターフェース
ResourceのgetFilename - オーバーライド:
- クラス
AbstractResourceのgetFilename - 関連事項:
getDescription
この実装は、ファイルの絶対パスを含む説明を返します。- 次で指定:
- インターフェース
ResourceのgetDescription - 関連事項:
equals
この実装は、基になるファイルパスを比較します。- オーバーライド:
- クラス
AbstractResourceのequals - 関連事項:
hashCode