名前
jar - クラスおよびリソースのアーカイブを作成し、アーカイブから個々のクラスまたはリソースを操作またはリストア
シノプシス
jar
[OPTION ...] [ [--release
VERSION] [-C
dir] files] ...
説明
jar
コマンドは、ZIPおよびZLIB圧縮形式に基づく汎用アーカイブおよび圧縮ツールです。 最初は、jar
コマンドはJavaアプレット(JDK 11以降はサポートされていません)またはアプリケーションをパッケージ化するように設計されていましたが、JDK 9から、ユーザーはjar
コマンドを使用してモジュラJARを作成できます。 転送やデプロイの場合は通常、モジュールをモジュラJARとしてパッケージ化した方が便利です。
jar
コマンドの構文は、tar
コマンドの構文と似ています。 必須の操作引数の1つによって定義されるいくつかの主な操作モードを持っています。 その他の引数は、操作の動作を変更するオプションか、操作を実行するために必要なオプションです。
モジュールまたはアプリケーションのコンポーネント(ファイル、イメージおよびサウンド)が1つのアーカイブに結合されていると、Javaエージェント(ブラウザなど)は、それらのコンポーネントを1回のHTTPトランザクションでダウンロードすることができ、コンポーネントごとに新しい接続を必要とすることがありません。 これによって、ダウンロードの回数が大幅に減ります。 また、jar
コマンドはファイルを圧縮するので、ダウンロード時間もさらに短くなります。 また、jar
コマンドを使用すると、ファイル内の個々のエントリに署名できるため、起点を認証できます。 JARファイルは、圧縮されているかどうかにかかわらず、クラス・パスのエントリとして使用できます。
アーカイブは、モジュール記述子module-info.class
を、指定されたディレクトリのルートまたは.jar
アーカイブのルートに含めた場合、モジュラJARになります。 次の操作(「作成および更新モードでのみ有効な操作修飾子」を参照)は、モジュラJARの作成または更新時、あるいは既存の非モジュラJARの更新時にのみ有効です。
--module-version
--hash-modules
--module-path
ノート:
ロング・オプションのすべての必須またはオプション引数は、対応するショート・オプションについても必須またはオプションです。
主な動作モード
jar
コマンドを使用する場合は、実行する操作を指定する必要があります。 jar
コマンドの操作モードを指定するには、この項で説明する適切な操作引数を含めます。 操作引数を他の1文字オプションと混在させることができます。 一般にoperation引数は、コマンドラインで指定された最初の引数です。
-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
- ハッシュを生成するためのモジュール依存のロケーションを指定します。
@
filejar
オプションとファイル名を、コマンド行で指定されているかのようにテキスト・ファイルから読み取ります
作成、更新、および生成インデックス・モードでのみ有効な操作修飾子
次のオプションを使用して、更新(-u
または--update
)および世代索引(-i
または--generate-index=
FILE)のメイン操作モードの作成(-c
または--create
)のアクションをカスタマイズできます:
-0
または--no-compress
- ZIPによる圧縮を使用せずに、保存します。
その他のオプション
次のオプションは、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
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ファイルに含めるファイルをリストするargファイルを指定し、プレフィクスとしてアットマーク(@
)を付けてjar
コマンドに渡します。jar --create --file my.jar @classes.list
argファイル内の1つ以上のエントリが見つからない場合、JARファイルを作成せずにJARコマンドは失敗します。