javax.mail.internet
インタフェース SharedInputStream

既知の実装クラスの一覧:
SharedByteArrayInputStream, SharedFileInputStream

public interface SharedInputStream

複数の処理でデータを共有する InputStream は、このインタフェースを実装する場合があります。 これにより、そうした InputStream のユーザは、InputStream 内の現在の位置を識別し、 元の InputStreams 内のデータのサブセットを表す新しい InputStream を作成できます。 新しい InputStream は、データをコピーすることなく、元と同じ基底データにアクセスします。

Note that implementations of this interface must ensure that the close method does not close any underlying stream that might be shared by multiple instances of SharedInputStream until all shared instances have been closed.

導入されたバージョン:
JavaMail 1.2

メソッドの概要
 long getPosition()
          InputStream 内の現在位置を InputStream の先頭からのオフセットで返します。
 InputStream newStream(long start, long end)
          この InputStream のデータのサブセットを表す新しい InputStream を返します。
 

メソッドの詳細

getPosition

long getPosition()
InputStream 内の現在位置を InputStream の先頭からのオフセットで返します。

戻り値:
現在の位置

newStream

InputStream newStream(long start,
                      long end)
この InputStream のデータのサブセットを表す新しい InputStream を返します。 これは start (これを含む) から始まり、end (これを含まない) で終わります。 start は負であってはなりません。end が -1 の場合、 新しいストリームはこのストリームと同じ場所で終わります。 返される InputStream も SharedInputStream インタフェースを実装します。

パラメータ:
start - 開始位置
end - 終了位置 + 1
戻り値:
新しいストリーム