パッケージ jakarta.activation
インターフェース DataSource
- すべての既知のサブインターフェース:
MultipartDataSource
- すべての既知の実装クラス:
ByteArrayDataSource、FileDataSource、MimePartDataSource、URLDataSource
public interface DataSource
DataSource インターフェースは、Jakarta Activation に任意のデータコレクションの抽象化を提供します。そのデータの型と、必要に応じて
InputStreams および OutputStreams の形式でデータへのアクセスを提供します。方法の概要
修飾子と型メソッド説明このメソッドは、データの MIME 型を文字列の形式で返します。このメソッドは、データを表すInputStreamを返し、それができない場合は適切な例外をスローします。getName()このオブジェクトの名前を返します。オブジェクトの名前は、基になるオブジェクトの性質によって異なります。このメソッドは、データを書き込むことができるOutputStreamを返し、それができない場合は適切な例外をスローします。
メソッドの詳細
getInputStream
このメソッドは、データを表すInputStreamを返し、それができない場合は適切な例外をスローします。このメソッドが呼び出されるたびに新しいInputStreamオブジェクトが返される必要があり、ストリームはデータの先頭に配置される必要があることに注意してください。- 戻り値:
- InputStream
- 例外:
IOExceptionSE- InputStream の作成に失敗した場合
getOutputStream
このメソッドは、データを書き込むことができるOutputStreamを返し、それができない場合は適切な例外をスローします。このメソッドが呼び出されるたびに新しいOutputStreamオブジェクトが返される必要があり、ストリームはデータが書き込まれる場所に配置される必要があることに注意してください。- 戻り値:
- OutputStream
- 例外:
IOExceptionSE- OutputStream の作成に失敗した場合
getContentType
StringSE getContentType()このメソッドは、データの MIME 型を文字列の形式で返します。常に有効な型を返す必要があります。DataSource 実装でデータ型を判別できない場合は、getContentType が "application/octet-stream" を返すことが推奨されます。- 戻り値:
- MIME 型
getName
StringSE getName()このオブジェクトの名前を返します。オブジェクトの名前は、基になるオブジェクトの性質によって異なります。DataSources カプセル化ファイルは、オブジェクトのファイル名を返すことを選択できます。(通常、これはパス名全体ではなく、ファイル名の最後のコンポーネントになります。)- 戻り値:
- オブジェクトの名前。