クラス PathResource

実装されているすべてのインターフェース:
InputStreamSource, Resource, WritableResource

@DeprecatedSE(since="7.0", forRemoval=true) public class PathResource extends AbstractResource implements WritableResource
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
7.0 以降、FileSystemResource を推奨
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
関連事項:
  • コンストラクターの概要

    コンストラクター
    コンストラクター
    説明
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    パス文字列から新しい PathResource を作成します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    URISE から新しい PathResource を作成します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    PathSE ハンドルから新しい PathResource を作成します。
  • 方法の概要

    修飾子と型
    メソッド
    説明
    long
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、元となるファイルの長さを返します。
    createRelative(StringSE relativePath)
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装では、このリソース記述子の元となるファイルのパスに相対的な指定されたパスを適用して、PathResource を作成します。
    boolean
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装では、基礎となる PathSE 参照を比較します。
    boolean
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、元となるファイルが存在するかどうかを返します。
    byte[]
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    このリソースの内容をバイト配列として返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    指定された文字セットを使用して、このリソースの内容を文字列として返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    このリソースの説明を返します。これは、リソースを操作する際のエラー出力に使用されます。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、基礎となる FileSE 参照を返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、ファイルの名前を返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、基礎となる PathSE 参照を返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装では、基になるファイルの InputStreamSE を開きます。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装では、基になるファイルの OutputStreamSE を開きます。
    final StringSE
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    このリソースのファイルパスを返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、基になるファイルの URISE を返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、基になるファイルの URLSE を返します。
    int
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、基礎となる PathSE 参照のハッシュコードを返します。
    boolean
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は常にファイルを示します。
    boolean
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、元となるファイルが読み取り可能としてマークされているかどうかを確認します(ディレクトリではなく、コンテンツを含む実際のファイルに対応します)。
    boolean
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、元となるファイルが書き込み可能としてマークされているかどうかを確認します(また、ディレクトリではなくコンテンツを含む実際のファイルに対応します)。
    long
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装は、基になるファイルのタイムスタンプを返します。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装では、基になるファイルの ReadableByteChannelSE を開きます。
    非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
    この実装では、基になるファイルの WritableByteChannelSE を開きます。

    クラス AbstractResource から継承されたメソッド

    getFileForLastModifiedCheck, isOpen, toString

    クラス ObjectSE から継承されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, waitSE, waitSE

    インターフェース Resource から継承されたメソッド

    isOpen
  • コンストラクターの詳細

    • PathResource

      public PathResource(PathSE path)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      PathSE ハンドルから新しい PathResource を作成します。

      メモ: FileSystemResource とは異なり、createRelative(String) を介して相対リソースを構築する場合、相対パスは指定されたルートのに構築されます : たとえば、Paths.get("C:/dir1/")、相対パス "dir2" → "C:/dir1/dir2"!

      パラメーター:
      path - パスハンドル
    • PathResource

      public PathResource(StringSE path)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      パス文字列から新しい PathResource を作成します。

      メモ: FileSystemResource とは異なり、createRelative(String) を介して相対リソースを構築する場合、相対パスは指定されたルートのに構築されます : たとえば、Paths.get("C:/dir1/")、相対パス "dir2" → "C:/dir1/dir2"!

      パラメーター:
      path - 通り
      関連事項:
    • PathResource

      public PathResource(URISE uri)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      URISE から新しい PathResource を作成します。

      メモ: FileSystemResource とは異なり、createRelative(String) を介して相対リソースを構築する場合、相対パスは指定されたルートのに構築されます : たとえば、Paths.get("C:/dir1/")、相対パス "dir2" → "C:/dir1/dir2"!

      パラメーター:
      uri - パス URI
      関連事項:
  • メソッドの詳細

    • getPath

      public final StringSE getPath()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      このリソースのファイルパスを返します。
    • exists

      public boolean exists()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、元となるファイルが存在するかどうかを返します。
      次で指定:
      インターフェース Resourceexists 
      オーバーライド:
      クラス AbstractResourceexists 
      関連事項:
    • isReadable

      public boolean isReadable()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、元となるファイルが読み取り可能としてマークされているかどうかを確認します(ディレクトリではなく、コンテンツを含む実際のファイルに対応します)。
      次で指定:
      インターフェース ResourceisReadable 
      オーバーライド:
      クラス AbstractResourceisReadable 
      関連事項:
    • getInputStream

      public InputStreamSE getInputStream() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装では、基になるファイルの InputStreamSE を開きます。
      次で指定:
      インターフェース InputStreamSourcegetInputStream 
      戻り値:
      基になるリソースの入力ストリーム (null であってはなりません)
      例外:
      IOExceptionSE - コンテンツストリームを開けなかった場合
      関連事項:
    • getContentAsByteArray

      public byte[] getContentAsByteArray() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      インターフェースからコピーされた説明: Resource
      このリソースの内容をバイト配列として返します。
      次で指定:
      インターフェース ResourcegetContentAsByteArray 
      戻り値:
      バイト配列としてのこのリソースの内容
      例外:
      IOExceptionSE - 一般的な解決 / 読み取りエラーの場合
    • getContentAsString

      public StringSE getContentAsString(CharsetSE charset) throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      インターフェースからコピーされた説明: Resource
      指定された文字セットを使用して、このリソースの内容を文字列として返します。
      次で指定:
      インターフェース ResourcegetContentAsString 
      パラメーター:
      charset - デコードに使用する文字セット
      戻り値:
      このリソースの内容を String として
      例外:
      IOExceptionSE - 一般的な解決 / 読み取りエラーの場合
    • isWritable

      public boolean isWritable()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、元となるファイルが書き込み可能としてマークされているかどうかを確認します(また、ディレクトリではなくコンテンツを含む実際のファイルに対応します)。
      次で指定:
      インターフェース WritableResourceisWritable 
      関連事項:
    • getOutputStream

      public OutputStreamSE getOutputStream() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装では、基になるファイルの OutputStreamSE を開きます。
      次で指定:
      インターフェース WritableResourcegetOutputStream 
      例外:
      IOExceptionSE - ストリームを開けなかった場合
      関連事項:
    • getURL

      public URLSE getURL() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、基になるファイルの URLSE を返します。
      次で指定:
      インターフェース ResourcegetURL 
      オーバーライド:
      クラス AbstractResourcegetURL 
      例外:
      IOExceptionSE - リソースを URL として解決できない場合、つまりリソースが記述子として使用できない場合
      関連事項:
    • getURI

      public URISE getURI() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、基になるファイルの URISE を返します。
      次で指定:
      インターフェース ResourcegetURI 
      オーバーライド:
      クラス AbstractResourcegetURI 
      例外:
      IOExceptionSE - リソースを URI として解決できない場合、つまりリソースが記述子として使用できない場合
      関連事項:
    • isFile

      public boolean isFile()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は常にファイルを示します。
      次で指定:
      インターフェース ResourceisFile 
      オーバーライド:
      クラス AbstractResourceisFile 
      関連事項:
    • getFile

      public FileSE getFile()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、基礎となる FileSE 参照を返します。
      次で指定:
      インターフェース ResourcegetFile 
      オーバーライド:
      クラス AbstractResourcegetFile 
      関連事項:
    • getFilePath

      public PathSE getFilePath()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、基礎となる PathSE 参照を返します。
      次で指定:
      インターフェース ResourcegetFilePath 
    • readableChannel

      public ReadableByteChannelSE readableChannel() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装では、基になるファイルの ReadableByteChannelSE を開きます。
      次で指定:
      インターフェース ResourcereadableChannel 
      オーバーライド:
      クラス AbstractResourcereadableChannel 
      戻り値:
      基になるリソースのバイトチャネル (null であってはなりません)
      例外:
      IOExceptionSE - コンテンツチャネルを開けなかった場合
      関連事項:
    • writableChannel

      public WritableByteChannelSE writableChannel() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装では、基になるファイルの WritableByteChannelSE を開きます。
      次で指定:
      インターフェース WritableResourcewritableChannel 
      戻り値:
      基になるリソースのバイトチャネル (null であってはなりません)
      例外:
      IOExceptionSE - コンテンツチャネルを開けなかった場合
      関連事項:
    • contentLength

      public long contentLength() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、元となるファイルの長さを返します。
      次で指定:
      インターフェース ResourcecontentLength 
      オーバーライド:
      クラス AbstractResourcecontentLength 
      例外:
      IOExceptionSE - リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)
      関連事項:
    • lastModified

      public long lastModified() throws IOExceptionSE
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、基になるファイルのタイムスタンプを返します。
      次で指定:
      インターフェース ResourcelastModified 
      オーバーライド:
      クラス AbstractResourcelastModified 
      例外:
      IOExceptionSE - リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)
      関連事項:
    • createRelative

      public Resource createRelative(StringSE relativePath)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装では、このリソース記述子の元となるファイルのパスに相対的な指定されたパスを適用して、PathResource を作成します。
      次で指定:
      インターフェース ResourcecreateRelative 
      オーバーライド:
      クラス AbstractResourcecreateRelative 
      パラメーター:
      relativePath - 相対パス (このリソースに関連して)
      戻り値:
      相対リソースのリソースハンドル
      関連事項:
    • getFilename

      public StringSE getFilename()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、ファイルの名前を返します。
      次で指定:
      インターフェース ResourcegetFilename 
      オーバーライド:
      クラス AbstractResourcegetFilename 
      関連事項:
    • getDescription

      public StringSE getDescription()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      インターフェースからコピーされた説明: Resource
      このリソースの説明を返します。これは、リソースを操作する際のエラー出力に使用されます。

      実装では、toString メソッドからこの値を返すことも推奨されます。

      次で指定:
      インターフェース ResourcegetDescription 
      関連事項:
    • equals

      public boolean equals(@Nullable ObjectSE other)
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装では、基礎となる PathSE 参照を比較します。
      オーバーライド:
      クラス AbstractResourceequals 
      関連事項:
    • hashCode

      public int hashCode()
      非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
      この実装は、基礎となる PathSE 参照のハッシュコードを返します。
      オーバーライド:
      クラス AbstractResourcehashCode 
      関連事項: