JavaTM Platform
Standard Ed. 6

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)

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。