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

含まれているクラス:

Pack200

public static interface Pack200.Unpacker

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

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

フィールドの概要

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)