public class DescriptiveResource extends AbstractResource
Resource
実装。Resource
引数が API で予期されている場合にプレースホルダーとして使用されますが、実際の読み取りには必ずしも使用されません。
コンストラクターと説明 |
---|
DescriptiveResource(java.lang.String description) 新しい DescriptiveResource を作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
boolean | equals(java.lang.Object other) この実装は、基礎となる説明文字列を比較します。 |
boolean | exists() この実装は、ファイルを開くことができるかどうかをチェックし、InputStream を開くことができるかどうかにフォールバックします。 |
java.lang.String | getDescription() このリソースの説明を返します。これは、リソースを操作する際のエラー出力に使用されます。 |
java.io.InputStream | getInputStream() 基礎となるリソースのコンテンツの InputStream を返します。 |
int | hashCode() この実装は、基礎となる説明文字列のハッシュコードを返します。 |
boolean | isReadable() この実装は、 exists (5.1 の時点で改訂された)というリソースに対して、常に true を返します。 |
contentLength, createRelative, getFile, getFileForLastModifiedCheck, getFilename, getURI, getURL, isFile, isOpen, lastModified, readableChannel, toString
public DescriptiveResource(@Nullable java.lang.String description)
description
- リソースの説明 public boolean exists()
AbstractResource
Resource
の exists
AbstractResource
の exists
public boolean isReadable()
AbstractResource
exists
(5.1 の時点で改訂された)というリソースに対して、常に true
を返します。Resource
の isReadable
AbstractResource
の isReadable
InputStreamSource.getInputStream()
, Resource.exists()
public java.io.InputStream getInputStream() throws java.io.IOException
InputStreamSource
InputStream
を返します。各呼び出しで新しいストリームが作成されることが予想されます。
この要件は、JavaMail などの API を考慮する場合に特に重要です。JavaMail では、メールの添付ファイルを作成するときにストリームを複数回読み取ることができる必要があります。このようなユースケースでは、各 getInputStream()
コールが新しいストリームを返す必要があります。
null
であってはなりません)java.io.FileNotFoundException
- 基になるリソースが存在しない場合 java.io.IOException
- コンテンツストリームを開けなかった場合 public java.lang.String getDescription()
Resource
実装では、toString
メソッドからこの値を返すことも推奨されます。
Object.toString()
public boolean equals(java.lang.Object other)
AbstractResource
の equals
Resource.getDescription()
public int hashCode()
AbstractResource
の hashCode
Resource.getDescription()