モジュール java.base
パッケージ java.util.jar

インタフェースPack200.Unpacker

  • 含まれているクラス:
    Pack200


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

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

    注: ほかで指定がない場合、null引数をコンストラクタ、またはこのクラスのメソッドへ渡すとNullPointerExceptionがスローされます。

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

    導入されたバージョン:
    1.5
    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      static String DEFLATE_HINT
      unpackerが転送されたDEFLATE_HINTの値をすべて無視し、指定された値TRUEまたはFALSEで置き換えることを示すプロパティ。
      static String FALSE
      文字列「false」は、特定のプロパティで使用できます。
      static String KEEP
      文字列「keep」は、特定のプロパティで使用できます。
      static String PROGRESS
      unpackerの進捗状況をパーセントで示します。状況は、unpackerにより周期的に更新されます。
      static String TRUE
      文字列「true」は、特定のプロパティで使用できます。
    • フィールドの詳細

      • DEFLATE_HINT

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

        static final String PROGRESS
        unpackerの進捗状況をパーセントで示します。状況は、unpackerにより周期的に更新されます。 値0 - 100は正常、-1は停滞を示します。 進捗は、このプロパティの値をポーリングしてモニターできます。

        最低でも、アンパックはアンパック操作の開始時には0に、最後には100に進捗を設定する必要があります。

        関連項目:
        定数フィールド値
    • メソッドの詳細

      • properties

        SortedMap<String,String> properties​()
        このエンジンのプロパティ・セットを取得します。 このセットは"ライブ・ビュー"です。その内容を変更すると直ちにUnpackerエンジンに影響を与え、エンジン(進行状況などの)からの変更はマップにすぐに表示されます。

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

        実装固有のプロパティには、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 - エラーが発生した場合。