java.util.jar
インタフェース Pack200.Unpacker

含まれているクラス:

Pack200

public static interface Pack200.Unpacker

unpacker エンジンは、パックされたストリームを JAR ファイルに変換します。このエンジンのインスタンスは、Pack200.newUnpacker() を使用して取得できます。

このエンジンにより生成された JAR ファイルにはすべて、zip ファイルコメントとして文字列「PACK200」が含まれます。これにより、JAR アーカイブがパックおよび展開されたことを、配備者が検出できるようになります。

このバージョンの unpacker は、以前のすべてのバージョンと互換性があります。

導入されたバージョン:

1.5

フィールドの概要

static String	DEFLATE_HINT unpacker が転送された DEFLATE_HINT の値をすべて無視し、指定された値 TRUE または FALSE で置き換えることを示すプロパティー。
static String	FALSE 文字列「false」は、特定のプロパティーで使用できます。
static String	KEEP 文字列「keep」は、特定のプロパティーで使用できます。
static String	PROGRESS unpacker の進捗状況をパーセントで示します。
static String	TRUE 文字列「true」は、特定のプロパティーで使用できます。

メソッドの概要

void	addPropertyChangeListener(PropertyChangeListener listener) PropertyChange イベントのリスナーをプロパティーマップに登録します。
SortedMap<String,String>	properties() このエンジンのプロパティーセットを取得します。
void	removePropertyChangeListener(PropertyChangeListener listener) addPropertyChangeListener(java.beans.PropertyChangeListener) で追加された PropertyChange イベントのリスナーを削除します。
void	unpack(File in, JarOutputStream out) Pack200 アーカイブを読み込み、エンコードされた JAR を JarOutputStream に書き込みます。
void	unpack(InputStream in, JarOutputStream out) Pack200 アーカイブを読み込み、エンコードされた JAR を JarOutputStream に書き込みます。

フィールドの詳細

KEEP

static final String KEEP

文字列「keep」は、特定のプロパティーで使用できます。

関連項目:

DEFLATE_HINT, 定数フィールド値

TRUE

static final String TRUE

文字列「true」は、特定のプロパティーで使用できます。

関連項目:

DEFLATE_HINT, 定数フィールド値

FALSE

static final String FALSE

文字列「false」は、特定のプロパティーで使用できます。

関連項目:

DEFLATE_HINT, 定数フィールド値

DEFLATE_HINT

static final String DEFLATE_HINT

unpacker が転送された DEFLATE_HINT の値をすべて無視し、指定された値 TRUE または FALSE で置き換えることを示すプロパティー。デフォルト値は、特殊な文字列 KEEP です。これは、unpacker に対し、転送されたすべてのデフレーションヒントを保存するよう求めます。

関連項目:

定数フィールド値

PROGRESS

static final String PROGRESS

unpacker の進捗状況をパーセントで示します。状況は、unpacker により周期的に更新されます。値 0 〜 100 は正常、-1 は停滞を示します。PropertyChangeListener とともにこのプロパティーを観察するようにしてください。

unpacker は、最低限、パッキング操作の最初に進捗を 0 に、操作の最後に進捗を 100 に設定する必要があります。

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener), 定数フィールド値

メソッドの詳細

properties

SortedMap<String,String> properties()

このエンジンのプロパティーセットを取得します。このセットは「ライブビュー」であるため、内容を変更するとただちに Packer エンジンがその影響を受けます。また、エンジンから行われた変更 (進捗の表示など) は、ただちにマップで確認できます。

プロパティーマップには、定義済みの実装固有のプロパティーやデフォルトのプロパティーを含められます。ユーザーは、既存のプロパティーを変更する前に、情報を確認して意味を十分に理解することが推奨されています。

実装固有のプロパティーには、com. で始まる、実装者に関連付けられたパッケージ名、または類似の接頭辞が付加されます。pack. および unpack. で始まるすべてのプロパティー名は、この API 用に予約されています。

不明なプロパティーは、未指定のエラーとして無視または拒否できます。無効なエントリにより、詳細不明エラーがスローされる場合があります。

戻り値:

オプションキー文字列とオプション値の、ソートされた関連付け

unpack

void unpack(InputStream in,
            JarOutputStream out)
            throws IOException

Pack200 アーカイブを読み込み、エンコードされた JAR を JarOutputStream に書き込みます。入力ストリームの内容全体が読み込まれます。次に示す代替手段を使用して、Pack200 アーカイブをファイルに読み込み、File オブジェクトを渡す方が効率が良い場合があります。

入力を閉じますが、出力は閉じません(出力にはより多くの要素を蓄積できる)。

パラメータ:

in - InputStream

out - JarOutputStream

例外:

IOException - エラーが発生した場合

unpack

void unpack(File in,
            JarOutputStream out)
            throws IOException

Pack200 アーカイブを読み込み、エンコードされた JAR を JarOutputStream に書き込みます。

出力は閉じません(出力にはより多くの要素を蓄積できる)。

パラメータ:

in - File

out - JarOutputStream

例外:

IOException - エラーが発生した場合

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener listener)

PropertyChange イベントのリスナーをプロパティーマップに登録します。通常、これは、アプリケーションにより進捗バーの更新に使用されます。

パラメータ:

listener - プロパティーの変更時に呼び出されるオブジェクト

関連項目:

properties(), PROGRESS

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener listener)

addPropertyChangeListener(java.beans.PropertyChangeListener) で追加された PropertyChange イベントのリスナーを削除します。

パラメータ:

listener - 削除される PropertyChange リスナー

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener)