パッケージ jakarta.mail.util
クラス SharedFileInputStream
- java.lang.ObjectSE
-
- java.io.InputStreamSE
-
- java.io.FilterInputStreamSE
-
- java.io.BufferedInputStreamSE
-
- jakarta.mail.util.SharedFileInputStream
- 実装されているすべてのインターフェース:
SharedInputStream、CloseableSE、AutoCloseableSE
public class SharedFileInputStream extends BufferedInputStreamSE implements SharedInputStream
SharedFileInputStreamは、ファイルからのデータをバッファリングし、markおよびresetメソッドをサポートするBufferedInputStreamです。また、ファイルのサブセットを表す他のストリームを作成できるnewStreamメソッドもサポートしています。RandomAccessFileオブジェクトは、ファイルデータにアクセスするために使用されます。SharedFileInputStream が閉じられると、
newStreamメソッドで作成されたすべてのストリームも閉じられることに注意してください。これにより、SharedFileInputStream オブジェクトの作成者は、基になるファイルへのアクセスを制御し、必要に応じてファイルが閉じられるようにして、ファイル記述子のリークを回避できます。この動作は SharedInputStream の要件と矛盾し、将来のリリースで変更される可能性があることにも注意してください。- 導入:
- JavaMail 1.4
- 作成者:
- Bill Shannon
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 protected longbufpos読み取りバッファの最初のバイトに対応するファイルオフセット。protected intbufsize読み取りバッファの通常のサイズ。protected longdatalenファイルのこのサブセット内のデータの量。protected RandomAccessFileSEinデータを含むファイル。protected longstartファイルのこのサブセット内のデータの開始のファイルオフセット。クラス java.io.BufferedInputStreamSE から継承されたフィールド
bufSE, countSE, marklimitSE, markposSE, posSE
コンストラクターの概要
コンストラクター コンストラクター 説明 SharedFileInputStream(FileSE file)ファイルのSharedFileInputStreamを作成します。SharedFileInputStream(FileSE file, int size)指定されたバッファサイズでSharedFileInputStreamを作成します。SharedFileInputStream(StringSE file)名前付きファイルのSharedFileInputStreamを作成しますSharedFileInputStream(StringSE file, int size)指定されたバッファサイズでSharedFileInputStreamを作成します。
方法の概要
すべてのメソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 intavailable()この入力ストリームからブロックせずに読み取ることができるバイト数を返します。voidclose()この入力ストリームを閉じて、ストリームに関連付けられているシステムリソースを解放します。protected voidfinalize()このストリームを強制的に閉じます。longgetPosition()InputStream の先頭からのオフセットとして、InputStream の現在の位置を返します。voidmark(int readlimit)InputStreamのmarkメソッドの一般契約を参照してください。booleanmarkSupported()この入力ストリームがmarkおよびresetメソッドをサポートしているかどうかをテストします。InputStreamSEnewStream(long start, long end)この InputStream からのデータのサブセットを表す新しい InputStream を返します。これは、start(包括的)からend(排他的)までです。intread()InputStreamのreadメソッドの一般契約を参照してください。intread(byte[] b, int off, int len)指定されたオフセットから開始して、このストリームから指定されたバイト配列にバイトを読み取ります。voidreset()InputStreamのresetメソッドの一般契約を参照してください。longskip(long n)InputStreamのskipメソッドの一般契約を参照してください。クラス java.io.FilterInputStreamSE から継承されたメソッド
readSE
クラス java.io.InputStreamSE から継承されたメソッド
nullInputStream, readAllBytes, readNBytesSE, readNBytesSE, transferToSE
フィールドの詳細
in
protected RandomAccessFileSE in
データを含むファイル。関連するすべての SharedFileInputStreams で共有されます。
bufsize
protected int bufsize
読み取りバッファの通常のサイズ。
bufpos
protected long bufpos
読み取りバッファの最初のバイトに対応するファイルオフセット。
start
protected long start
ファイルのこのサブセット内のデータの開始のファイルオフセット。
datalen
protected long datalen
ファイルのこのサブセット内のデータの量。
コンストラクターの詳細
SharedFileInputStream
public SharedFileInputStream(FileSE file) throws IOExceptionSE
ファイルのSharedFileInputStreamを作成します。- パラメーター:
file- ファイル- 例外:
IOExceptionSE- ファイルを開くときにエラーが発生した場合
SharedFileInputStream
public SharedFileInputStream(StringSE file) throws IOExceptionSE
名前付きファイルのSharedFileInputStreamを作成します- パラメーター:
file- ファイル- 例外:
IOExceptionSE- ファイルを開くときにエラーが発生した場合
SharedFileInputStream
public SharedFileInputStream(FileSE file, int size) throws IOExceptionSE
指定されたバッファサイズでSharedFileInputStreamを作成します。- パラメーター:
file- ファイルsize- バッファサイズ。- 例外:
IOExceptionSE- ファイルを開くときにエラーが発生した場合IllegalArgumentExceptionSE- サイズ ≤ の場合 0。
SharedFileInputStream
public SharedFileInputStream(StringSE file, int size) throws IOExceptionSE
指定されたバッファサイズでSharedFileInputStreamを作成します。- パラメーター:
file- ファイルsize- バッファサイズ。- 例外:
IOExceptionSE- ファイルを開くときにエラーが発生した場合IllegalArgumentExceptionSE- サイズ ≤ の場合 0。
メソッドの詳細
read
public int read() throws IOExceptionSEInputStreamのreadメソッドの一般契約を参照してください。- オーバーライド:
- クラス
BufferedInputStreamSEのread - 戻り値:
- データの次のバイト、またはストリームの終わりに達した場合は
-1。 - 例外:
IOExceptionSE- I/O エラーが発生した場合。
read
public int read(byte[] b, int off, int len) throws IOExceptionSE指定されたオフセットから開始して、このストリームから指定されたバイト配列にバイトを読み取ります。このメソッドは、
クラスの対応するInputStreamSEメソッドの一般的な契約を実装します。readSE- オーバーライド:
- クラス
BufferedInputStreamSEのreadSE - パラメーター:
b- 宛先バッファ。off- バイトの格納を開始するオフセット。len- 読み取る最大バイト数。- 戻り値:
- 読み取られたバイト数、またはストリームの終わりに達した場合は
-1。 - 例外:
IOExceptionSE- I/O エラーが発生した場合。
skip
public long skip(long n) throws IOExceptionSEInputStreamのskipメソッドの一般契約を参照してください。- オーバーライド:
- クラス
BufferedInputStreamSEのskipSE - パラメーター:
n- スキップされるバイト数。- 戻り値:
- スキップされた実際のバイト数。
- 例外:
IOExceptionSE- I/O エラーが発生した場合。
available
public int available() throws IOExceptionSEこの入力ストリームからブロックせずに読み取ることができるバイト数を返します。- オーバーライド:
- クラス
BufferedInputStreamSEのavailable - 戻り値:
- この入力ストリームからブロックせずに読み取ることができるバイト数。
- 例外:
IOExceptionSE- I/O エラーが発生した場合。
mark
public void mark(int readlimit)
InputStreamのmarkメソッドの一般契約を参照してください。- オーバーライド:
- クラス
BufferedInputStreamSEのmarkSE - パラメーター:
readlimit- マーク位置が無効になる前に読み取ることができるバイトの最大制限。- 関連事項:
reset()
reset
public void reset() throws IOExceptionSEInputStreamのresetメソッドの一般契約を参照してください。markposが-1の場合(マークが設定されていないか、マークが無効になっている場合)、IOExceptionがスローされます。それ以外の場合、posはmarkposと等しく設定されます。- オーバーライド:
- クラス
BufferedInputStreamSEのreset - 例外:
IOExceptionSE- このストリームがマークされていない場合、またはマークが無効になっている場合。- 関連事項:
mark(int)
markSupported
public boolean markSupported()
この入力ストリームがmarkおよびresetメソッドをサポートしているかどうかをテストします。SharedFileInputStreamのmarkSupportedメソッドはtrueを返します。- オーバーライド:
- クラス
BufferedInputStreamSEのmarkSupported - 戻り値:
- このストリーム型が
markおよびresetメソッドをサポートするかどうかを示すboolean。 - 関連事項:
InputStream.mark(int)SE,InputStream.reset()
close
public void close() throws IOExceptionSEこの入力ストリームを閉じて、ストリームに関連付けられているシステムリソースを解放します。- 次で指定:
- インターフェース
AutoCloseableSEのclose - 次で指定:
- インターフェース
CloseableSEのclose - オーバーライド:
- クラス
BufferedInputStreamSEのclose - 例外:
IOExceptionSE- I/O エラーが発生した場合。
getPosition
public long getPosition()
InputStream の先頭からのオフセットとして、InputStream の現在の位置を返します。- 次で指定:
- インターフェース
SharedInputStreamのgetPosition - 戻り値:
- 現在の位置
newStream
public InputStreamSE newStream(long start, long end)
この InputStream からのデータのサブセットを表す新しい InputStream を返します。これは、start(包括的)からend(排他的)までです。startは非負でなければなりません。endが -1 の場合、新しいストリームはこのストリームと同じ場所で終了します。返された InputStream は、SharedInputStream インターフェースも実装します。- 次で指定:
- インターフェース
SharedInputStreamのnewStream - パラメーター:
start- 開始位置end- 終了位置 +1- 戻り値:
- 新しいストリーム
finalize
protected void finalize() throws ThrowableSEこのストリームを強制的に閉じます。- オーバーライド:
- クラス
ObjectSEのfinalize - 例外:
ThrowableSE