クラス VfsResource

メソッドの詳細

• getInputStream

  public InputStreamSE getInputStream() throws IOExceptionSE

  インターフェースからコピーされた説明: InputStreamSource

  基礎となるリソースのコンテンツの InputStreamSE を返します。

  通常、このような呼び出しごとに新しいストリームが作成されると考えられます。

  この要件は、JavaMail などの API を考慮する場合に特に重要です。JavaMail では、メールの添付ファイルを作成するときにストリームを複数回読み取ることができる必要があります。このようなユースケースでは、各 getInputStream() コールが新しいストリームを返す必要があります。

  戻り値:

  基になるリソースの入力ストリーム (null であってはなりません)

  例外:

  FileNotFoundExceptionSE - 基盤となるリソースが存在しない場合

  IOExceptionSE - コンテンツストリームを開けなかった場合

  関連事項:

  • Resource.isReadable()
  • Resource.isOpen()

• exists

  public boolean exists()

  クラスからコピーされた説明: AbstractResource

  この実装は、ファイルを開くことができるかどうかをチェックし、InputStream を開くことができるかどうかにフォールバックします。

  これは、ディレクトリとコンテンツリソースの両方をカバーします。

  次で指定:

  インターフェース Resource の exists 

  オーバーライド:

  クラス AbstractResource の exists 

• isReadable

  public boolean isReadable()

  クラスからコピーされた説明: AbstractResource

  この実装は、exists（5.1 の時点で改訂された）というリソースに対して、常に true を返します。

  次で指定:

  インターフェース Resource の isReadable 

  オーバーライド:

  クラス AbstractResource の isReadable 

  関連事項:

  • InputStreamSource.getInputStream()
  • Resource.exists()

• getURL

  public URLSE getURL() throws IOExceptionSE

  クラスからコピーされた説明: AbstractResource

  この実装は、リソースを URL に解決できないと想定して、FileNotFoundException をスローします。

  次で指定:

  インターフェース Resource の getURL 

  オーバーライド:

  クラス AbstractResource の getURL 

  例外:

  IOExceptionSE - リソースを URL として解決できない場合、つまりリソースが記述子として使用できない場合

• getURI

  public URISE getURI() throws IOExceptionSE

  クラスからコピーされた説明: AbstractResource

  この実装は、AbstractResource.getURL() によって返された URL に基づいて URI を構築します。

  次で指定:

  インターフェース Resource の getURI 

  オーバーライド:

  クラス AbstractResource の getURI 

  例外:

  IOExceptionSE - リソースを URI として解決できない場合、つまりリソースが記述子として使用できない場合

• getFile

  public FileSE getFile() throws IOExceptionSE

  クラスからコピーされた説明: AbstractResource

  この実装は、リソースを絶対ファイルパスに解決できないと想定して、FileNotFoundException をスローします。

  次で指定:

  インターフェース Resource の getFile 

  オーバーライド:

  クラス AbstractResource の getFile 

  例外:

  FileNotFoundExceptionSE - リソースが絶対ファイルパスとして解決できない場合、つまりリソースがファイルシステムで使用できない場合

  IOExceptionSE - 一般的な解決 / 読み取りエラーの場合

  関連事項:

  • InputStreamSource.getInputStream()

• contentLength

  public long contentLength() throws IOExceptionSE

  クラスからコピーされた説明: AbstractResource

  このメソッドは、InputStream 全体を読み取ってコンテンツの長さを決定します。

  InputStreamResource のカスタムサブクラスの場合、このメソッドをより最適な実装でオーバーライドすることを強くお勧めします。ファイルの長さをチェックするか、ストリームを 1 回しか読み取れない場合は単に -1 を返します。

  次で指定:

  インターフェース Resource の contentLength 

  オーバーライド:

  クラス AbstractResource の contentLength 

  例外:

  IOExceptionSE - リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)

  関連事項:

  • InputStreamSource.getInputStream()

• lastModified

  public long lastModified() throws IOExceptionSE

  クラスからコピーされた説明: AbstractResource

  この実装は、使用可能な場合、元となるファイルのタイムスタンプをチェックします。

  次で指定:

  インターフェース Resource の lastModified 

  オーバーライド:

  クラス AbstractResource の lastModified 

  例外:

  IOExceptionSE - リソースを解決できない場合 (ファイルシステム内、または他の既知の物理リソース型として)

  関連事項:

  • AbstractResource.getFileForLastModifiedCheck()

• createRelative

  public Resource createRelative(StringSE relativePath) throws IOExceptionSE

  クラスからコピーされた説明: AbstractResource

  この実装は、このリソースに対して相対リソースを作成できないと想定して、FileNotFoundException をスローします。

  次で指定:

  インターフェース Resource の createRelative 

  オーバーライド:

  クラス AbstractResource の createRelative 

  パラメーター:

  relativePath - 相対パス (このリソースに関連して)

  戻り値:

  相対リソースのリソースハンドル

  例外:

  IOExceptionSE - 相対リソースを決定できない場合

• getFilename

  public StringSE getFilename()

  クラスからコピーされた説明: AbstractResource

  この実装は、このリソース型にファイル名がないと仮定して、常に null を返します。

  次で指定:

  インターフェース Resource の getFilename 

  オーバーライド:

  クラス AbstractResource の getFilename 

• getDescription

  public StringSE getDescription()

  インターフェースからコピーされた説明: Resource

  このリソースの説明を返します。これは、リソースを操作する際のエラー出力に使用されます。

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

  関連事項:

  • Object.toString()

• equals

  public boolean equals(@Nullable ObjectSE other)

  クラスからコピーされた説明: AbstractResource

  この実装は、説明文字列を比較します。

  オーバーライド:

  クラス AbstractResource の equals 

  関連事項:

  • Resource.getDescription()

• hashCode

  public int hashCode()

  クラスからコピーされた説明: AbstractResource

  この実装は、説明のハッシュコードを返します。

  オーバーライド:

  クラス AbstractResource の hashCode 

  関連事項:

  • Resource.getDescription()