JavaTM 2 Platform
Standard Ed. 5.0

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)

JavaTM 2 Platform
Standard Ed. 5.0

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

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