jarコマンド

名前

jar - クラスおよびリソースのアーカイブを作成し、アーカイブから個々のクラスまたはリソースを操作またはリストア

シノプシス

jar [OPTION ...] [ [--release VERSION] [-C dir] files] ...

説明

jarコマンドは、ZIPおよびZLIB圧縮形式に基づく汎用アーカイブおよび圧縮ツールです。 最初は、jarコマンドはJavaアプレット(JDK 11以降はサポートされていません)またはアプリケーションをパッケージ化するように設計されていましたが、JDK 9から、ユーザーはjarコマンドを使用してモジュラJARを作成できます。 転送やデプロイの場合は通常、モジュールをモジュラJARとしてパッケージ化した方が便利です。

jarコマンドの構文は、tarコマンドの構文と似ています。 必須の操作引数のいずれかで定義された複数の主要な操作モードがあります。 その他の引数は、操作の動作を変更するオプションと、操作を実行するために必要なオペランドのいずれかです。

モジュールまたはアプリケーションのコンポーネント(ファイル、イメージおよびサウンド)が1つのアーカイブに結合されていると、Javaエージェント(ブラウザなど)は、それらのコンポーネントを1回のHTTPトランザクションでダウンロードすることができ、コンポーネントごとに新しい接続を必要とすることがありません。 これによって、ダウンロードの回数が大幅に減ります。 また、jarコマンドはファイルを圧縮するので、ダウンロード時間もさらに短くなります。 また、jarコマンドを使用すると、ファイル内の個々のエントリに署名できるため、起点を認証できます。 JARファイルは、圧縮されているかどうかにかかわらず、クラス・パスのエントリとして使用できます。

アーカイブは、モジュール記述子module-info.classを、指定されたディレクトリのルートまたは.jarアーカイブのルートに含めた場合、モジュラJARになります。 次の操作(「作成および更新モードでのみ有効な操作修飾子」を参照)は、モジュラJARの作成または更新時、あるいは既存の非モジュラJARの更新時にのみ有効です。

• --module-version

• --hash-modules

• --module-path

ノート:

長形式のオプションの必須引数またはオプション引数はすべて、対応する短形式のオプションに対しても必須またはオプションです。

主要な操作モード

jarコマンドを使用する場合は、実行する操作を指定する必要があります。 jarコマンドの操作モードを指定するには、この項で説明する適切な操作引数を含めます。 操作引数と他の1文字オプションを同時に使用できます。 一般に、操作引数はコマンド行に指定する最初の引数です。

-cまたは--create

アーカイブを作成します。

-i FILEまたは--generate-index= FILE

指定されたJARファイルの索引情報を生成します。 このオプションは非推奨であり、将来のリリースで削除される可能性があります。

-tまたは--list

アーカイブの目次をリストします。

-uまたは--update

既存のJARファイルを更新します。

-xまたは--extract

アーカイブから指定(または全部)のファイルを抽出します。

-dまたは--describe-module

モジュール・ディスクリプタまたは自動モジュール名を出力します。

任意のモードで有効な操作修飾子

次のオプションを使用して、jarコマンドに含まれる操作モードのアクションをカスタマイズできます。

-C DIR

指定されたディレクトリを変更し、コマンド行の最後に指定されたファイルを格納します。

jar [OPTION ...] [ [--release VERSION] [-C dir] files]

-f FILEまたは--file= FILE

アーカイブ・ファイル名を指定します。

--release VERSION

マルチリリースJARファイルを作成します。 オプションの後に指定したすべてのファイルを、META-INF/versions/ VERSION /という名前のJARファイルのバージョニングされたディレクトリに配置します。VERSIONは、値を9以上にする正の整数にする必要があります。

実行時に、JARに複数のバージョンのクラスが存在する場合、JDKは最初に検出したバージョンを使用し、最初にVERSION番号がJDKのメジャー・バージョン番号と一致するディレクトリ・ツリーで検索します。 次に、連続して小さいVERSION番号を持つディレクトリを検索し、最後にJARのルートを調べます。

-vまたは--verbose

詳細出力を標準出力に送信または出力します。

作成および更新モードでのみ有効な操作修飾子

次のオプションは、作成および更新の主要操作モードの動作をカスタマイズするのに使用できます。

-e CLASSNAMEまたは--main-class= CLASSNAME

モジュラJARファイルまたは実行可能なモジュラJARファイルにバンドルされたスタンドアロン・アプリケーションのアプリケーション・エントリ・ポイントを指定します。

-m FILEまたは--manifest= FILE

指定されたマニフェスト・ファイルからマニフェスト情報を含めます。

-Mまたは--no-manifest

エントリに対してマニフェスト・ファイルを作成しません。

--module-version=VERSION

モジュラJARファイルの作成または更新時、あるいは非モジュラJARファイルの更新時にモジュール・バージョンを指定します。

--hash-modules=PATTERN

指定されたパターンで一致し、モジュラJARファイルの作成時または非モジュラJARファイルの更新時に、直接または間接的に依存しているモジュールのハッシュを計算および記録します。

-pまたは--module-path

ハッシュを生成するためのモジュール依存性の場所を指定します。

@file

jarオプションとファイル名をテキスト・ファイルから読み取ります。

作成、更新および索引生成モードでのみ有効な操作修飾子

次のオプションを使用して、更新(-uまたは--update)および世代索引(-iまたは--generate-index= FILE)のメイン操作モードの作成(-cまたは--create)のアクションをカスタマイズできます:

-0または--no-compress

ZIPによる圧縮を使用せずに、保存します。

--date=TIMESTAMP

エントリのタイムスタンプに使用する、オプションのタイムゾーン形式のISO-8601拡張オフセット日時。例、"2022-02-12T12:30:00-05:00"。

その他のオプション

次のオプションは、jarコマンドで認識され、操作モードでは使用されません:

-hまたは--help [:compat]

jarコマンドのコマンドライン・ヘルプ、またはオプションで互換性ヘルプを表示します。

--help-extra

追加オプションのヘルプを表示します。

--version

プログラム・バージョンを出力します。

jarコマンド構文の例

• Foo.classおよびBar.classという2つのクラス・ファイルを含むアーカイブclasses.jarを作成します。

  jar --create --file classes.jar Foo.class Bar.class

• 最終変更日時を2021 Jan 6 12:36:00に設定するFoo.classおよびBar.classという2つのクラス・ファイルを含むアーカイブclasses.jarを作成します。

  jar --create --date="2021-01-06T14:36:00+02:00" --file=classes.jar Foo.class Bar.class

• foo/ディレクトリ内のすべてのファイルを含む既存のマニフェストmymanifestを使用して、アーカイブclasses.jarを作成します。

  jar --create --file classes.jar --manifest mymanifest -C foo/

• モジュール記述子がclasses/module-info.classにあるモジュラJARアーカイブfoo.jarを作成します。

  jar --create --file foo.jar --main-class com.foo.Main --module-version 1.0 -C foo/classes resources

• 既存の非モジュラJAR foo.jarをモジュラJARファイルに更新します。

  jar --update --file foo.jar --main-class com.foo.Main --module-version 1.0 -C foo/module-info.class

• classesディレクトリ内のファイルをJARのルートに配置するバージョン管理されたJARまたは複数の要素JAR、foo.jarを作成し、ファイルをJARのMETA-INF/versions/10ディレクトリにあるclasses-10ディレクトリに配置します。

  この例では、classes/com/fooディレクトリには、JDK 8用にコンパイルされたcom.foo.Hello (エントリ・ポイント・クラス)およびcom.foo.NameProviderという2つのクラスが含まれています。 classes-10/com/fooディレクトリには、JDK 10固有のコードを含み、JDK 10用にコンパイルされた、異なるバージョンのcom.foo.NameProviderクラスが含まれています。

  この設定では、ディレクトリclassesおよびclasses-10を含むディレクトリから次のコマンドを実行して、マルチ・リリースJARファイルfoo.jarを作成します。

  jar --create --file foo.jar --main-class com.foo.Hello -C classes . --release 10 -C classes-10 .

  JARファイルfoo.jarには次のものが含まれるようになりました:

  % jar -tf foo.jar
  
  META-INF/
  META-INF/MANIFEST.MF
  com/
  com/foo/
  com/foo/Hello.class
  com/foo/NameProvider.class
  META-INF/versions/10/com/
  META-INF/versions/10/com/foo/
  META-INF/versions/10/com/foo/NameProvider.class

  他の情報と同様に、ファイルMETA-INF/MANIFEST.MFには、エントリ・ポイントがcom.foo.Helloのマルチ・リリースJARファイルであることを示す次の行が含まれます。

  ...
  Main-Class: com.foo.Hello
  Multi-Release: true

  com.foo.Helloクラスがcom.foo.NameProviderクラスでメソッドをコールする場合、JDK 10を使用してプログラムを実行すると、com.foo.NameProviderクラスがMETA-INF/versions/10/com/foo/内のメソッドであることが保証されます。 JDK 8を使用してプログラムを実行すると、com.foo.NameProviderクラスがcom/fooのJARのルートにあるクラスであることが保証されます。

• classes.listファイルからオプションおよびクラス・ファイルのリストを読み取って、アーカイブmy.jarを作成します。

  ノート:

  jarコマンドを短縮または簡略化するには、別のテキスト・ファイルで引数を指定し、アットマーク(@)をプレフィクスとしてjarコマンドに渡します。

  jar --create --file my.jar @classes.list