名 前
jar − Java ア ー カ イ ブ ツ ー ル
形 式
jar [
−C ] [ c ] [ f ] [ i ] [
−J option ] [ M ] [ m ] [
O ] [ t ] [ u ] [ v ]
[ x file ] [ manifest-file ]
destination input-file
[ input-files ]
機 能 説 明
jar は Java ア プ リ ケ ー シ ョ ン の 1 つ で 、 複 数 個 の フ ァ イ ル を 1 個 の JAR ア ー カ イ ブ フ ァ イ ル に 統 合 し ま す 。 ま た 、 jar は 汎 用 的 な ア ー カ イ ブ 作 成 用 お よ び 圧 縮 用 の ツ ー ル で も あ り 、 圧 縮 は ZIP ま た は ZLIB 形 式 で 行 い ま す 。 た だ し jar ツ ー ル の 主 な 目 的 は 、 い く つ か の Java ア プ レ ッ ト や ア プ リ ケ ー シ ョ ン を 1 個 の ア ー カ イ ブ に 統 合 し て 簡 略 化 す る こ と で す 。 ア プ レ ッ ト や ア プ リ ケ ー シ ョ ン の コ ン ポ ー ネ ン ト 、 た と え ば ク ラ ス フ ァ イ ル 、 イ メ ー ジ 、 サ ウ ン ド な ど を 単 一 の ア ー カ イ ブ に ま と め る と 、 ブ ラ ウ ザ の よ う な Java エ ー ジ ェ ン ト に ダ ウ ン ロ ー ド す る と き に 、 一 度 の HTTP ト ラ ン ザ ク シ ョ ン で 済 み ま す 。 コ ン ポ ー ネ ン ト ご と に 新 た に 接 続 す る 必 要 が あ り ま せ ん 。 こ れ に よ り ダ ウ ン ロ ー ド 時 間 が 大 幅 に 短 縮 で き ま す 。 ま た jar は フ ァ イ ル の 圧 縮 も 行 う の で 、 ダ ウ ン ロ ー ド が よ り 高 速 に な り ま す 。 さ ら に 、 フ ァ イ ル 中 の 個 々 の エ ン ト リ に 対 し て ア プ レ ッ ト の 作 成 者 が 署 名 で き る の で 、 作 成 元 を 明 確 化 で き ま す 。 jar ツ ー ル の 構 文 は 、 tar(1) コ マ ン ド の 構 文 と ほ ぼ 同 一 で す 。 jar ア ー カ イ ブ は 、 圧 縮 さ れ て い る か ど う か に か か わ ら ず 、 ク ラ ス パ ス エ ン ト リ と し て 使 用 で き ま す 。
jar を 使 用 す る 場 合 は 、 以 下 に 示 す 3 種 類 の フ ァ イ ル を 入 力 し ま す 。
|
• |
manifest フ ァ イ ル (任 意 指 定 )
出 力 先
jar フ ァ イ ル ブ さ れ る フ ァ イ ル 群 標 準 的 な 使 い 方 は 次 の と お り で す 。
example% jar cmf myManifestFile myJarFile *.class cmf で は な く cfm を 指 定 す る 場 合 (つ ま り 、 m オ プ シ ョ ン と f オ プ シ ョ ン の 順 番 を 逆 に す る 場 合 )、 最 初 に jar ア ー カ イ ブ 名 を 指 定 し 、 次 に manifest フ ァ イ ル 名 を 指 定 す る 必 要 が あ り ま す 。 example% jar cfm myJarFile myManifestFile *.class manifest は RFC822 ASCII 形 式 を 使 用 す る た め 、 manifest フ ァ イ ル の 内 容 は 簡 単 に 表 示 お よ び 処 理 で き ま す 。 オ プ シ ョ ン次 の オ プ シ ョ ン を サ ポ ー ト し ま す 。
example% jar uf foo.jar −C classes *
2 つ 目 の 引 数 が 、 処 理 さ れ る jar フ ァ イ ル で あ る こ と を 指 定 し ま す 。 作 成 −c オ プ シ ョ ン で 作 成 を 行 う 場 合 に は 、 2 つ 目 の 引 数 は 作 成 す る jar フ ァ イ ル の 名 前 (標 準 出 力 の 代 わ り に 使 用 ) を 表 し ま す 。 −t オ プ シ ョ ン で 内 容 の 一 覧 表 示 、 ま た は −x オ プ シ ョ ン で 抽 出 を 行 う 場 合 に は 、 2 つ 目 の 引 数 は そ の 対 象 と な る jar フ ァ イ ル の 名 前 を 表 し ま す 。
デ ッ ク ス 情 報 を 生 成 し ま す 。 次 に 例 を 示 し ま す 。 example% jar i foo.jar foo.jar
に INDEX.LIST フ ァ
イ ル が 生 成 さ
れ ま す 。 こ の
フ ァ イ ル に は
、 foo.jar の 各 パ ッ
ケ ー ジ お よ び
foo.jar の Class-Path 属 性
に 指 定 さ れ て
い る す べ て の
jar フ ァ イ ル の
位 置 情 報 が 書
き 込 ま れ て い
ま す 。 option を Java 仮 想 マ シ ン に 渡 し ま す 。 こ こ で 、 option は 、 Java ア プ リ ケ ー シ ョ ン 起 動 プ ロ グ ラ ム java(1) の マ ニ ュ ア ル ペ ー ジ で 説 明 さ れ て い る オ プ シ ョ ン の 1 つ で す 。 た と え ば 、 −J-Xms48m は 、 起 動 時 に 使 用 す る メ モ リ を 48M バ イ ト に 設 定 し ま す 。 −J が 基 本 に す る 仮 想 マ シ ン に オ プ シ ョ ン を 渡 す こ と は 、 共 通 の 規 約 で す 。
example% jar cmf myManifestFile myJarFile *.class マ ニ フ ェ ス ト フ ァ イ ル に は 、 デ フ ォ ル ト の マ ニ フ ェ ス ト に 含 ま れ て い な い 、 専 用 の 「 名 前 -値 」 属 性 ヘ ッ ダ を 追 加 で き ま す 。 こ の よ う な ヘ ッ ダ の 例 と し て は 、 ベ ン ダ 情 報 、 バ ー ジ ョ ン 情 報 、 パ ッ ケ ー ジ シ ー リ ン グ 、 お よ び JAR に 含 ま れ る ア プ リ ケ ー シ ョ ン を 実 行 す る た め の ヘ ッ ダ が あ り ま す 。 m オ プ シ ョ ン の 使 用 例 に つ い て は 、 「 Java Tutorial」 の 「 JAR Files」 節 と 「 JRE 開 発 者 向 け ノ ー ト 」 Web ペ ー ジ を 参 照 し て く だ さ い 。
標 準 入 力 の 内 容 の 一 覧 を 表 示 し ま す 。
JAR フ ァ イ ル を 更 新 し ま す 。 次 に 例 を 示 し ま す 。 example% jar uf foo.jar foo.class こ の 例 は 、 フ ァ イ ル foo.class を 既 存 の JAR フ ァ イ ル foo.jar に 追 加 し ま す 。 example% jar umf foo.jar こ の 例 は 、 foo.jar の マ ニ フ ェ ス ト を マ ニ フ ェ ス ト の 情 報 で 更 新 し ま す 。
x file 標 準 入 力 か ら フ ァ イ ル を 抽 出 し ま す 。 file 引 数 は 、 抽 出 す る フ ァ イ ル を 指 定 し ま す 。 引 数 を 省 略 す る と 、 す べ て の フ ァ イ ル が 抽 出 さ れ ま す 。 引 数 に 指 定 し た フ ァ イ ル の ど れ か が デ ィ レ ク ト リ の 場 合 、 そ の デ ィ レ ク ト リ は 再 帰 的 に 処 理 さ れ ま す 。 使 用 例あ る デ ィ レ ク ト リ 中 の フ ァ イ ル を す べ て ア ー カ イ ブ に 追 加 す る 例 を 示 し ま す 。 example% ls main.jar buy.jar sell.jar other.jar main.jar の マ ニ フ ェ ス ト の Class-Path 属 性 に 次 の よ う に 指 定 し た 場 合 、 Class-Path: buy.jar sell.jar other.jar i オ プ シ ョ ン を 使 用 す れ ば 、 ア プ リ ケ ー シ ョ ン の ク ラ ス の ロ ー ド を 高 速 化 で き ま す 。 example$ jar i main.jar INDEX.LIST フ ァ イ ル が META-INF デ ィ レ ク ト リ に 追 加 さ れ ま す 。 こ の 結 果 、 ア プ リ ケ ー シ ョ ン の ク ラ ス ロ ー ダ に よ っ て ク ラ ス ま た は リ ソ ー ス の 検 索 が 行 わ れ る と き に 、 適 切 な jar フ ァ イ ル が ダ ウ ン ロ ー ド さ れ ま す 。 関 連 項 目keytool(1)
http://java.sun.com/docs/books/tutorial/jar/ JRE 開 発 者 向 け ノ ー ト @ http://java.sun.com/j2se/1.4/runtime.html#example JAR ガ イ ド @ http://java.sun.com/j2se/1.4/docs/guide/jar/index.html : 英 語 版 関 連 項 目 の 詳 細 は 、 以 下 の URL 中 の サ ー チ リ ン ク を 使 用 し て 参 照 し て く だ さ い 。 |