パッケージ jp.gr.java_conf.dangan.io

このパッケージは java.io パッケージによる入出力を支援するクラスを提供する。

参照:
説明

インタフェースの概要

Disconnectable

接続を解除できるストリームのための インターフェイス。

クラスの概要

BitInputStream	ビット入力のためのユーティリティクラス。
BitOutputStream	接続された出力ストリームにビットデータを出力するための 出力ストリームクラス。
Bits	ビット処理のためのユーティリティメソッド群。
CachedInputStream	キャッシュを使用して高速化するための入力ストリーム。
DisconnectableInputStream	データを供給する入力ストリームと データを処理する 入力ストリームとの接続を解除するためのユーティリティクラス。
DisconnectableOutputStream	データを処理して出力する出力ストリームと データをデバイスに出力するストリームとの 接続を解除するためのユーティリティクラス。
GrowthByteBuffer	自動的に伸張するバッファ。
LimitedInputStream	読み込み可能なデータ量が制限された入力ストリーム。
LittleEndian	リトルエンディアンで バイト配列や InputStream, OutputStream にアクセスするメソッドを提供するユーティリティクラス。

例外の概要

BitDataBrokenException	EndOfStream に達してしまったため要求されたビット数の データを得られなかった場合に投げられる例外。
NotEnoughBitsException	要求されたビット数のデータを得られなかった場合に 投げられる例外。

パッケージ jp.gr.java_conf.dangan.io の説明

このパッケージは java.io パッケージによる入出力を支援するクラスを提供する。 このパッケージでは以下のような点で java.io パッケージと異なるので注意する事。

• read(byte[] buf, int off, int len) や write(byte[] buf, int off, int len) で off や len で示される範囲が buf の範囲外を含む場合、 範囲チェックを行うのではなく破壊的なアクセスの後 IndexOutOfBoundsException を投げる。 このとき java.io パッケージのクラスと違い 入出力処理を行ってしまうため メソッド呼び出し前の状態への復旧は不可能である。
• mark / reset のサポートは基本的に接続された InputStream に依存する。 markSupported() は接続された InputStream の markSupported の戻り値を返す。 入力クラスがバッファリングしている場合、markSupported() が false を返しても バッファ内の移動で可能な範囲で reset() 可能であるが、 これは バッファの大きさ＝readLimit という事では無いので注意する事。
• java.io パッケージでは close() 後のアクセス(read(),write() 等)では 主に IOException を投げるが このパッケージでは Exception を投げる (主に NullPointerException を投げる) ので注意する事。
• java.io パッケージでは EndOfStream に達した後のアクセスを伴わないメソッド呼び出し read(new byte[0]), skip(0)の振る舞いは統一されていない (クラスによって 0 を返したり -1 を返したりする) が、 このパッケージでは InputStream の規約に従い、 常に 0 を返すので注意する事。