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