java.util.zip
クラス Inflater

java.lang.Object
  |
  +--java.util.zip.Inflater

public class Inflater

extends Object

このクラスは、一般的な ZLIB 圧縮ライブラリを使用して汎用の圧縮解除アルゴリズムをサポートします。ZLIB 圧縮ライブラリは、当初 PNG グラフィック標準の一部として開発されたもので、特許では保護されていません。仕様の詳細は、「パッケージ java.util.zip の説明」を参照してください。

関連項目:

Deflater

コンストラクタの概要

Inflater()
新しいデコンプレッサを作成します。

Inflater(boolean nowrap)
新しいデコンプレッサを作成します。

メソッドの概要

void	end() デコンプレッサを閉じ、圧縮解除された入力をすべて破棄します。
protected void	finalize() ガベージコレクションが行われたときにデコンプレッサを閉じます。
boolean	finished() 圧縮データストリームの最後に達した場合に true を返します。
int	getAdler() 圧縮解除データの ADLER-32 値を返します。
int	getRemaining() 入力バッファに残っているバイトの総数を返します。
int	getTotalIn() これまでに入力されたバイトの総数を返します。
int	getTotalOut() これまでに出力されたバイトの総数を返します。
int	inflate(byte[] b) 指定されたバッファにバイトを圧縮解除します。
int	inflate(byte[] b, int off, int len) 指定されたバッファにバイトを圧縮解除します。
boolean	needsDictionary() プリセットディクショナリが圧縮解除に必要な場合に true を返します。
boolean	needsInput() 入力バッファにデータが残っていない場合に true を返します。
void	reset() 新しい入力データセットが処理できるようにインフレータをリセットします。
void	setDictionary(byte[] b) プリセットディクショナリを指定のバイト配列に設定します。
void	setDictionary(byte[] b, int off, int len) プリセットディクショナリを指定のバイト配列に設定します。
void	setInput(byte[] b) 圧縮解除のための入力データを設定します。
void	setInput(byte[] b, int off, int len) 圧縮解除のための入力データを設定します。

クラス java.lang.Object から継承したメソッド

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

Inflater

public Inflater(boolean nowrap)

新しいデコンプレッサを作成します。パラメータ nowrap が true の場合は、ZLIB ヘッダおよびチェックサムフィールドは使用されません。これによって、GZIP と PKZIP の両方で使用される圧縮形式との互換性が確保されます。

注: nowrap オプションを使用する場合は、入力として特別な「ダミー」バイトを指定する必要があります。これは、最適化を行うために ZLIB ネイティブライブラリで必要となります。

パラメータ:

nowrap - true の場合は GZIP 互換の圧縮をサポート

Inflater

public Inflater()

新しいデコンプレッサを作成します。

メソッドの詳細

setInput

public void setInput(byte[] b,
                     int off,
                     int len)

圧縮解除のための入力データを設定します。needsInput() で入力データがさらに必要であることを示す true が返されるときは、このメソッドを呼び出す必要があります。

パラメータ:

b - 入力データバイト

off - 入力データの開始オフセット

len - 入力データの長さ

関連項目:

needsInput()

setInput

public void setInput(byte[] b)

圧縮解除のための入力データを設定します。needsInput() で入力データがさらに必要であることを示す true が返されるときは、このメソッドを呼び出す必要があります。

パラメータ:

b - 入力データバイト

関連項目:

needsInput()

setDictionary

public void setDictionary(byte[] b,
                          int off,
                          int len)

プリセットディクショナリを指定のバイト配列に設定します。inflate() が 0 を返す場合、または needsDictionary() がプリセットディクショナリを必要とすることを示す true を返す場合は、このメソッドを呼び出す必要があります。メソッド getAdler() を使用して必要なディクショナリの Adler-32 値を取得できます。

パラメータ:

b - ディクショナリデータバイト

off - データの開始オフセット

len - データの長さ

関連項目:

needsDictionary(), getAdler()

setDictionary

public void setDictionary(byte[] b)

プリセットディクショナリを指定のバイト配列に設定します。inflate() が 0 を返す場合、または needsDictionary() がプリセットディクショナリを必要とすることを示す true を返す場合は、このメソッドを呼び出す必要があります。メソッド getAdler() を使用して必要なディクショナリの Adler-32 値を取得できます。

パラメータ:

b - ディクショナリデータバイト

関連項目:

needsDictionary(), getAdler()

getRemaining

public int getRemaining()

入力バッファに残っているバイトの総数を返します。このメソッドは、圧縮解除が終了したあとに入力バッファに何バイト残っているかを調べるのに使用できます。

戻り値:

入力バッファに残っているバイトの総数

needsInput

public boolean needsInput()

入力バッファにデータが残っていない場合に true を返します。このメソッドを使用すると、入力データを追加するために #setInput を呼び出す必要があるかどうかを判断できます。

戻り値:

入力バッファにデータが残っていない場合は true

needsDictionary

public boolean needsDictionary()

プリセットディクショナリが圧縮解除に必要な場合に true を返します。

戻り値:

プリセットディクショナリが圧縮解除に必要な場合は true

関連項目:

setDictionary(byte[], int, int)

finished

public boolean finished()

圧縮データストリームの最後に達した場合に true を返します。

戻り値:

圧縮データストリームの最後に達した場合は true

inflate

public int inflate(byte[] b,
                   int off,
                   int len)
            throws DataFormatException

指定されたバッファにバイトを圧縮解除します。実際に圧縮解除されたバイト数を返します。戻り値 0 は、入力データやプリセットライブラリがさらに必要かどうかを判断するために needsInput() または needsDictionary() を呼び出す必要があることを示します。後者の場合、getAdler() を使用して、要求されるディクショナリの Adler-32 値を取得できます。

パラメータ:

b - 圧縮解除されるデータ用のバッファ

off - データの開始オフセット

len - 圧縮解除される最大バイト数

戻り値:

圧縮解除される実効バイト数

例外:

DataFormatException - 圧縮データ形式が無効な場合

関連項目:

needsInput(), needsDictionary()

inflate

public int inflate(byte[] b)
            throws DataFormatException

指定されたバッファにバイトを圧縮解除します。実際に圧縮解除されたバイト数を返します。戻り値 0 は、入力データやプリセットライブラリがさらに必要かどうかを判断するために needsInput() または needsDictionary() を呼び出す必要があることを示します。後者の場合、getAdler() を使用して、要求されるディクショナリの Adler-32 値を取得できます。

パラメータ:

b - 圧縮解除されるデータ用のバッファ

戻り値:

圧縮解除される実効バイト数

例外:

DataFormatException - 圧縮データ形式が無効な場合

関連項目:

needsInput(), needsDictionary()

getAdler

public int getAdler()

圧縮解除データの ADLER-32 値を返します。

戻り値:

圧縮解除データの ADLER-32 値

getTotalIn

public int getTotalIn()

これまでに入力されたバイトの総数を返します。

戻り値:

これまでに入力されたバイトの総数

getTotalOut

public int getTotalOut()

これまでに出力されたバイトの総数を返します。

戻り値:

これまでに出力されたバイトの総数

reset

public void reset()

新しい入力データセットが処理できるようにインフレータをリセットします。

end

public void end()

デコンプレッサを閉じ、圧縮解除された入力をすべて破棄します。このメソッドは、デコンプレッサを使用しなくなったときに呼び出す必要がありますが、finalize() メソッドによっても自動的に呼び出されます。このメソッドが呼び出されたあとの Inflater オブジェクトの動作は保証されません。

finalize

protected void finalize()

ガベージコレクションが行われたときにデコンプレッサを閉じます。

オーバーライド:

クラス Object 内の finalize