jar

実行可能JARファイル内にバンドルされたスタンドアロンのJavaアプリケーションのエントリ・ポイントとなるように、entrypointオペランドで指定されたクラスを設定します。このオプションを使用すると、マニフェスト・ファイル内のMain-Class属性値が作成またはオーバーライドされます。eオプションは、JARファイルを作成(c)または更新(u)する際に使用できます。

たとえば、次のコマンドはMain.classファイルとともにMain.jarアーカイブを作成しますが、その際に、マニフェスト・ファイル内のMain-Clas属性値はMainに設定されます。

jar cfe Main.jar Main Main.class

次のコマンドを実行すると、Java Runtime Environment (JRE)から直接このアプリケーションを呼び出すことができます。

java -jar Main.jar

エントリ・ポイントのクラス名が特定のパッケージ内に存在している場合、区切り文字としてドット(.)またはスラッシュ(/)を使用できます。たとえば、Main.classがmydirという名前のパッケージ内に存在している場合、次の方法のいずれかでエントリ・ポイントを指定できます。

jar -cfe Main.jar mydir/Main mydir/Main.class
jar -cfe Main.jar mydir.Main mydir/Main.class

作成(c)、更新(u)、抽出(x)または表示(t)されるJARファイルの名前となるように、jarfileオペランドで指定されたファイルを設定します。fオプションとjarfileオペランドを省略すると、stdinからJARファイル名を受け入れたり(xおよびtの場合)、stdoutにJARファイルを送信したり(cおよびuの場合)するように、jarコマンドが指示されます。

JARファイルを作成(c)または更新(u)するときに、fileオペランドを使用すると、アーカイブに追加されるファイルまたはディレクトリのパスと名前が定義されます。JARファイルを抽出(x)またはその内容を一覧表示(t)するときに、fileオペランドを使用すると、抽出または一覧表示されるファイルのパスと名前が定義されます。有効なファイルまたはディレクトリを少なくとも1つ指定する必要があります。複数のfileオペランドは空白文字で区切ります。entrypoint、jarfileまたはmanifestオペランドを使用する場合は、その後にfileオペランドを指定する必要があります。

JARファイルを作成(c)または更新(u)するときに、entrypointオペランドを使用すると、実行可能JARファイルにバンドルされたスタンドアロンのJavaアプリケーションのエントリ・ポイントとなるクラスの名前が定義されます。eオプションが存在する場合は、entrypointオペランドを指定する必要があります。

作成(c)、更新(u)、抽出(x)または表示(t)されるファイルの名前を定義します。fオプションが存在する場合は、jarfileオペランドを指定する必要があります。fオプションとjarfileオペランドを省略すると、stdinからJARファイル名を受け入れたり(xおよびtの場合)、stdoutにJARファイルを送信したり(cおよびuの場合)するように、jarコマンドが指示されます。

JARファイルの索引を作成(i)するときは、fオプションを付けずにjarfileオペランドを指定します。

JARファイルを作成(c)または更新(u)するときに、manifestオペランドを使用すると、JARファイル内のMANIFEST.MFに含まれる属性の名前と値を持つ既存のマニフェスト・ファイルが定義されます。fオプションが存在する場合は、manifestオペランドを指定する必要があります。

jarコマンド行を短くしたり簡潔にしたりするために、引数を個別のテキスト・ファイルに指定し、接頭辞としてアット・マーク(@)を付けてjarコマンドに渡すことができます。jarコマンドは、アット・マークで始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。

引数ファイルには、jarコマンドのオプションおよび引数を含めることができます(ただし、-Jオプションはランチャに渡されますが、引数ファイルをサポートしていないため除外されます)。ファイル内の引数は、空白文字または改行文字で区切ることができます。引数ファイル内のファイル名は、jarコマンドを実行する現在のディレクトリから見た相対パスであり、引数ファイルの位置から見た相対パスではありません。アスタリスク(*)などのワイルドカードは、通常ならばオペレーティング・システム・シェルによって展開されますが、この場合は展開されません。

次の例では、findコマンドによる現在のディレクトリ出力からのファイルの名前を持つclasses.listファイルを作成する方法を示します。

find . -name '*.class' -print > classes.list

その後、jarコマンドを実行し、@arg-file構文を使用してclasses.listファイルを渡すことができます。

jar cf my.jar @classes.list

引数ファイルにはパスを指定できますが、相対パスが記述された引数ファイル内のすべてのファイル名は、次の例で示すように、渡されたパスに対して相対的ではなく、jarコマンドの現在の作業ディレクトリに相対的となります。

jar @dir/classes.list

% ls
1.au          Animator.class    monkey.jpg
2.au          Wave.class        spacemusic.au
3.au          at_work.gif

% jar cvf bundle.jar *
added manifest
adding: 1.au(in = 2324) (out= 67)(deflated 97%)
adding: 2.au(in = 6970) (out= 90)(deflated 98%)
adding: 3.au(in = 11616) (out= 108)(deflated 99%)
adding: Animator.class(in = 2266) (out= 66)(deflated 97%)
adding: Wave.class(in = 3778) (out= 81)(deflated 97%)
adding: at_work.gif(in = 6621) (out= 89)(deflated 98%)
adding: monkey.jpg(in = 7667) (out= 91)(deflated 98%)
adding: spacemusic.au(in = 3079) (out= 73)(deflated 97%)

% ls -F
audio/ classes/ images/
% jar cvf bundle.jar audio classes images
added manifest
adding: audio/(in = 0) (out= 0)(stored 0%)
adding: audio/1.au(in = 2324) (out= 67)(deflated 97%)
adding: audio/2.au(in = 6970) (out= 90)(deflated 98%)
adding: audio/3.au(in = 11616) (out= 108)(deflated 99%)
adding: audio/spacemusic.au(in = 3079) (out= 73)(deflated 97%)
adding: classes/(in = 0) (out= 0)(stored 0%)
adding: classes/Animator.class(in = 2266) (out= 66)(deflated 97%)
adding: classes/Wave.class(in = 3778) (out= 81)(deflated 97%)
adding: images/(in = 0) (out= 0)(stored 0%)
adding: images/monkey.jpg(in = 7667) (out= 91)(deflated 98%)
adding: images/at_work.gif(in = 6621) (out= 89)(deflated 98%)

% ls -F
audio/ bundle.jar classes/ images/

% jar tf bundle.jar

META-INF/
META-INF/MANIFEST.MF
audio/1.au
audio/2.au
audio/3.au
audio/spacemusic.au
classes/Animator.class
classes/Wave.class
images/monkey.jpg
images/at_work.gif

iオプションは、株取引アプリケーション用の相互依存したクラスを、3つのJARファイル(main.jar、buy.jarおよびsell.jar)に分割する際に使用します。main.jarマニフェストにClass-Path属性を指定する場合は、iオプションを使用すると、アプリケーションにおけるクラスのロード時間を短縮できます。

Class-Path: buy.jar sell.jar
jar i main.jar

INDEX.LISTファイルがMETA-INFディレクトリに挿入されます。この結果、アプリケーションのクラス・ローダーによってクラスまたはリソースの検索が行われるときに、指定されたJARファイルがダウンロードされます。

このファイルに格納されている情報を使用して、アプリケーションのクラス・ローダーは、効率的にクラスをロードします。ディレクトリをコピーするには、まずdir1内のファイルを圧縮してstdoutに出力し、続いてstdinから抽出してパイプラインでdir2に渡します(両方のjarコマンドから-fオプションを省く)。

(cd dir1; jar c .) | (cd dir2; jar x)