クラス PathResource
java.lang.ObjectSE
org.springframework.core.io.AbstractResource
org.springframework.core.io.PathResource
- 実装されているすべてのインターフェース:
InputStreamSource, Resource, WritableResource
@DeprecatedSE(since="7.0",
forRemoval=true)
public class PathResource
extends AbstractResource
implements WritableResource
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
PathSE ハンドルの Resource 実装。Path API を介してすべての操作と変換を実行します。FileSE および URLSE としての解決をサポートします。拡張 WritableResource インターフェースを実装します。 メモ: 5.1 以降、PathSE サポートは FileSystemResource でも利用でき、Spring の標準の文字列ベースのパス変換を適用しますが、FilesSE API を介してすべての操作を実行します。この PathResource は事実上、createRelative の動作が異なる純粋な java.nio.path.Path ベースの代替です。
- 導入:
- 4.0
- 作成者:
- Philippe Marschall, Juergen Hoeller
- 関連事項:
コンストラクターの概要
コンストラクターコンストラクター説明PathResource(StringSE path) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。パス文字列から新しいPathResourceを作成します。PathResource(URISE uri) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。URISE から新しいPathResourceを作成します。PathResource(PathSE path) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。PathSE ハンドルから新しいPathResourceを作成します。方法の概要
修飾子と型メソッド説明long非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルの長さを返します。createRelative(StringSE relativePath) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、このリソース記述子の元となるファイルのパスに相対的な指定されたパスを適用して、PathResourceを作成します。boolean非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基礎となるPathSE 参照を比較します。booleanexists()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルが存在するかどうかを返します。byte[]非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このリソースの内容をバイト配列として返します。getContentAsString(CharsetSE charset) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。指定された文字セットを使用して、このリソースの内容を文字列として返します。非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このリソースの説明を返します。これは、リソースを操作する際のエラー出力に使用されます。getFile()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基礎となるFileSE 参照を返します。非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、ファイルの名前を返します。非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基礎となるPathSE 参照を返します。非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのInputStreamSE を開きます。非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのOutputStreamSE を開きます。final StringSEgetPath()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このリソースのファイルパスを返します。getURI()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基になるファイルのURISE を返します。getURL()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基になるファイルのURLSE を返します。inthashCode()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基礎となるPathSE 参照のハッシュコードを返します。booleanisFile()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は常にファイルを示します。boolean非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルが読み取り可能としてマークされているかどうかを確認します(ディレクトリではなく、コンテンツを含む実際のファイルに対応します)。boolean非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルが書き込み可能としてマークされているかどうかを確認します(また、ディレクトリではなくコンテンツを含む実際のファイルに対応します)。long非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基になるファイルのタイムスタンプを返します。非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのReadableByteChannelSE を開きます。非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのWritableByteChannelSE を開きます。クラス AbstractResource から継承されたメソッド
getFileForLastModifiedCheck, isOpen, toString
コンストラクターの詳細
PathResource
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。PathSE ハンドルから新しいPathResourceを作成します。メモ:
FileSystemResourceとは異なり、createRelative(String)を介して相対リソースを構築する場合、相対パスは指定されたルートの下に構築されます : たとえば、Paths.get("C:/dir1/")、相対パス "dir2" → "C:/dir1/dir2"!- パラメーター:
path- パスハンドル
PathResource
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。パス文字列から新しいPathResourceを作成します。メモ:
FileSystemResourceとは異なり、createRelative(String)を介して相対リソースを構築する場合、相対パスは指定されたルートの下に構築されます : たとえば、Paths.get("C:/dir1/")、相対パス "dir2" → "C:/dir1/dir2"!- パラメーター:
path- 通り- 関連事項:
PathResource
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。URISE から新しいPathResourceを作成します。メモ:
FileSystemResourceとは異なり、createRelative(String)を介して相対リソースを構築する場合、相対パスは指定されたルートの下に構築されます : たとえば、Paths.get("C:/dir1/")、相対パス "dir2" → "C:/dir1/dir2"!- パラメーター:
uri- パス URI- 関連事項:
メソッドの詳細
getPath
exists
public boolean exists()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルが存在するかどうかを返します。- 次で指定:
- インターフェース
Resourceのexists - オーバーライド:
- クラス
AbstractResourceのexists - 関連事項:
isReadable
public boolean isReadable()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルが読み取り可能としてマークされているかどうかを確認します(ディレクトリではなく、コンテンツを含む実際のファイルに対応します)。- 次で指定:
- インターフェース
ResourceのisReadable - オーバーライド:
- クラス
AbstractResourceのisReadable - 関連事項:
getInputStream
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのInputStreamSE を開きます。- 次で指定:
- インターフェース
InputStreamSourceのgetInputStream - 戻り値:
- 基になるリソースの入力ストリーム (
nullであってはなりません) - 例外:
IOExceptionSE- コンテンツストリームを開けなかった場合- 関連事項:
getContentAsByteArray
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。インターフェースからコピーされた説明:Resourceこのリソースの内容をバイト配列として返します。- 次で指定:
- インターフェース
ResourceのgetContentAsByteArray - 戻り値:
- バイト配列としてのこのリソースの内容
- 例外:
IOExceptionSE- 一般的な解決 / 読み取りエラーの場合
getContentAsString
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。インターフェースからコピーされた説明:Resource指定された文字セットを使用して、このリソースの内容を文字列として返します。- 次で指定:
- インターフェース
ResourceのgetContentAsString - パラメーター:
charset- デコードに使用する文字セット- 戻り値:
- このリソースの内容を
Stringとして - 例外:
IOExceptionSE- 一般的な解決 / 読み取りエラーの場合
isWritable
public boolean isWritable()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルが書き込み可能としてマークされているかどうかを確認します(また、ディレクトリではなくコンテンツを含む実際のファイルに対応します)。- 次で指定:
- インターフェース
WritableResourceのisWritable - 関連事項:
getOutputStream
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのOutputStreamSE を開きます。- 次で指定:
- インターフェース
WritableResourceのgetOutputStream - 例外:
IOExceptionSE- ストリームを開けなかった場合- 関連事項:
getURL
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基になるファイルのURLSE を返します。- 次で指定:
- インターフェース
ResourceのgetURL - オーバーライド:
- クラス
AbstractResourceのgetURL - 例外:
IOExceptionSE- リソースを URL として解決できない場合、つまりリソースが記述子として使用できない場合- 関連事項:
getURI
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基になるファイルのURISE を返します。- 次で指定:
- インターフェース
ResourceのgetURI - オーバーライド:
- クラス
AbstractResourceのgetURI - 例外:
IOExceptionSE- リソースを URI として解決できない場合、つまりリソースが記述子として使用できない場合- 関連事項:
isFile
public boolean isFile()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は常にファイルを示します。- 次で指定:
- インターフェース
ResourceのisFile - オーバーライド:
- クラス
AbstractResourceのisFile - 関連事項:
getFile
getFilePath
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基礎となるPathSE 参照を返します。- 次で指定:
- インターフェース
ResourceのgetFilePath
readableChannel
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのReadableByteChannelSE を開きます。- 次で指定:
- インターフェース
ResourceのreadableChannel - オーバーライド:
- クラス
AbstractResourceのreadableChannel - 戻り値:
- 基になるリソースのバイトチャネル (
nullであってはなりません) - 例外:
IOExceptionSE- コンテンツチャネルを開けなかった場合- 関連事項:
writableChannel
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基になるファイルのWritableByteChannelSE を開きます。- 次で指定:
- インターフェース
WritableResourceのwritableChannel - 戻り値:
- 基になるリソースのバイトチャネル (
nullであってはなりません) - 例外:
IOExceptionSE- コンテンツチャネルを開けなかった場合- 関連事項:
contentLength
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、元となるファイルの長さを返します。- 次で指定:
- インターフェース
ResourceのcontentLength - オーバーライド:
- クラス
AbstractResourceのcontentLength - 例外:
IOExceptionSE- リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)- 関連事項:
lastModified
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基になるファイルのタイムスタンプを返します。- 次で指定:
- インターフェース
ResourceのlastModified - オーバーライド:
- クラス
AbstractResourceのlastModified - 例外:
IOExceptionSE- リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)- 関連事項:
createRelative
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、このリソース記述子の元となるファイルのパスに相対的な指定されたパスを適用して、PathResourceを作成します。- 次で指定:
- インターフェース
ResourceのcreateRelative - オーバーライド:
- クラス
AbstractResourceのcreateRelative - パラメーター:
relativePath- 相対パス (このリソースに関連して)- 戻り値:
- 相対リソースのリソースハンドル
- 関連事項:
getFilename
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、ファイルの名前を返します。- 次で指定:
- インターフェース
ResourceのgetFilename - オーバーライド:
- クラス
AbstractResourceのgetFilename - 関連事項:
getDescription
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。インターフェースからコピーされた説明:Resourceこのリソースの説明を返します。これは、リソースを操作する際のエラー出力に使用されます。実装では、
toStringメソッドからこの値を返すことも推奨されます。- 次で指定:
- インターフェース
ResourceのgetDescription - 関連事項:
equals
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装では、基礎となるPathSE 参照を比較します。- オーバーライド:
- クラス
AbstractResourceのequals - 関連事項:
hashCode
public int hashCode()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。この実装は、基礎となるPathSE 参照のハッシュコードを返します。- オーバーライド:
- クラス
AbstractResourceのhashCode - 関連事項:
FileSystemResourceを推奨