Manpages

名 前

java − Java イ ン タ プ リ タ

形 式

java [ options ] class [ argument ... ]

java [ options ] −jar file.jar
[ argument ... ]

パ ラ メ ー タ

オ プ シ ョ ン の 指 定 順 序 は 任 意 で す 。 特 定 の オ プ シ ョ ン に 適 用 さ れ る パ ラ メ ー タ に つ い て は 、 以 下 の 「 オ プ シ ョ ン 」 節 を 参 照 し て く だ さ い 。

−jar と 同 時 に 使 用 さ れ る

機 能 説 明

java ツ ー ル は 、 Java ア プ リ ケ ー シ ョ ン を 起 動 し ま す 。 java ツ ー ル は 、 Java Runtime Environment を 起 動 し た あ と 、 指 定 さ れ た ク ラ ス を ロ ー ド し 、 こ の ク ラ ス の main メ ソ ッ ド を 呼 び 出 し て Java ア プ リ ケ ー シ ョ ン を 起 動 し ま す 。 main メ ソ ッ ド は 次 の シ グ ニ チ ャ を 持 っ て い な け れ ば な り ま せ ん 。

public static void main(String args[]) こ の メ ソ ッ ド は public お よ び static で 宣 言 さ れ 、 値 を 返 さ ず 、 パ ラ メ ー タ と し て String 配 列 を 使 用 で き な け れ ば な り ま せ ん 。 デ フ ォ ル ト で は 、 オ プ シ ョ ン で は な い 最 初 の 引 数 が 、 呼 び 出 す ク ラ ス の 名 前 に な り ま す 。 こ の 名 前 に は 、 完 全 指 定 の ク ラ ス 名 を 使 用 す る 必 要 が あ り ま す 。 −jar オ プ シ ョ ン を 指 定 し た 場 合 、 オ プ シ ョ ン で は な い 最 初 の 引 数 は 、 ア プ リ ケ ー シ ョ ン の ク ラ ス フ ァ イ ル と リ ソ ー ス フ ァ イ ル を 含 む JAR ア ー カ イ ブ の 名 前 に な り ま す 。 こ の 場 合 、 Main-Class マ ニ フ ェ ス ト ヘ ッ ダ で 指 定 さ れ た ク ラ ス が ス タ ー ト ア ッ プ ク ラ ス に な り ま す 。

Java Runtime は 、 ブ ー ト ス ト ラ ッ プ ク ラ ス パ ス 、 イ ン ス ト ー ル 型 拡 張 機 能 、 お よ び ユ ー ザ ク ラ ス パ ス の 3 つ の 場 所 か ら 、 起 動 ク ラ ス と そ の 他 の 使 用 す る ク ラ ス を 探 し ま す 。 ク ラ ス 名 ま た は JAR フ ァ イ ル 名 の あ と に あ る オ プ シ ョ ン で は な い 引 数 は 、 main 関 数 に 渡 さ れ ま す 。

オ プ シ ョ ン

起 動 コ マ ン ド に は 、 現 在 の 実 行 環 境 お よ び 将 来 の リ リ ー ス で サ ポ ー ト さ れ る 標 準 オ プ シ ョ ン が あ り ま す 。 た だ し 以 下 で 説 明 す る よ う に 、 別 の オ プ シ ョ ン に 置 き 換 え ら れ た オ プ シ ョ ン は 現 在 で は 使 わ れ て お ら ず 、 将 来 の リ リ ー ス で は 削 除 さ れ る 予 定 で す 。 こ の ほ か の 非 標 準 オ プ シ ョ ン は 、 現 在 の Virtual Machine 実 装 に 固 有 の オ プ シ ョ ン で 、 将 来 変 更 さ れ る 可 能 性 が あ り ま す 。 非 標 準 オ プ シ ョ ン は −X で 始 ま り ま す 。 標 準 オ プ シ ョ ン

−classpath classpath

ブ 、 お よ び ZIP ア ー カ イ ブ の リ ス ト を 指 定 し ま す 。 ク ラ ス パ ス の 各 エ ン ト リ は コ ロ ン (:) で 区 切 り ま す 。 −classpath ま た は −cp を 指 定 す る と 、 こ れ ら の オ プ シ ョ ン の 値 に よ っ て CLASSPATH 環 境 変 数 の 設 定 は 上 書 き さ れ ま す 。

java で −classpath ま た は −cp を 使 う 場 合 、 こ れ ら の オ プ シ ョ ン に よ っ て 指 定 さ れ る の は ユ ー ザ ク ラ ス の ク ラ ス パ ス だ け で す 。 −classpath ま た は −cp を 使 う 場 合 、 こ れ ら の オ プ シ ョ ン に よ っ て 指 定 さ れ る の は 、 ユ ー ザ ク ラ ス と ブ ー ト ス ト ラ ッ プ ク ラ ス の 両 方 の ク ラ ス パ ス で す 。

−classpath と −cp を 使 用 せ ず 、 CLASSPATH も 設 定 さ れ て い な い 場 合 、 ユ ー ザ ク ラ ス パ ス は 現 在 の デ ィ レ ク ト リ (.) に な り ま す 。

シ ス テ ム プ ロ パ テ ィ の 値 を 設 定 し ま す 。

−ea :<package name>... |:<class name> 表 明 を 有 効 に し ま す 。 デ フ ォ ル ト で 、 表 明 は 無 効 で す 。 引 数 を 指 定 し な く て も 、 enableassertions ま た は −ea で 表 明 が 有 効 に な り ま す 。 「 ...」 で 終 わ る 引 数 を 1 つ 指 定 す る と 、 ス イ ッ チ に よ り 、 指 定 し た パ ッ ケ ー ジ お よ び す べ て の サ ブ パ ッ ケ ー ジ 内 の 表 明 が 有 効 に な り ま す 。 「 ...」 と い う 引 数 を 指 定 す る と 、 ス イ ッ チ に よ り 、 現 在 の 作 業 用 デ ィ レ ク ト リ 内 に あ る 名 前 の な い パ ッ ケ ー ジ 内 の 表 明 が 有 効 に な り ま す 。 「 ...」 で 終 わ ら な い 引 数 を 1 つ 指 定 す る と 、 ス イ ッ チ に よ り 、 指 定 し た ク ラ ス 内 の 表 明 が 有 効 に な り ま す 。

1 行 の コ マ ン ド に 、 こ れ ら の ス イ ッ チ の 複 数 の イ ン ス タ ン ス が 含 ま れ て い る 場 合 、 ク ラ ス を 読 み 込 む 前 に 、 正 し く 処 理 さ れ ま す 。 た と え ば 、 パ ッ ケ ー ジ com.wombat.fruitbat
(お よ び す べ て の サ ブ パ ッ ケ ー ジ ) 内 だ け の 有 効 な 表 明 を 含 ん だ プ ロ グ ラ ム を 実 行 す る 場 合 、 次 の コ マ ン ド を 使 用 で き ま す 。

example% java -ea:com.wombat.fruitbat... <Main Class>

−enableassertions お よ び −ea ス イ ッ チ は 、 す べ て の ク ラ ス ロ ー ダ お よ び シ ス テ ム ク ラ ス (ク ラ ス ロ ー ダ を 持 た な い ) に 適 用 さ れ ま す 。 こ の 規 則 に は 1 つ 例 外 が あ り ま す 。 引 数 が な い 形 式 の 場 合 、 ス イ ッ チ は シ ス テ ム に 適 用 さ れ ま せ ん 。 こ れ を 利 用 し て 、 簡 単 に 、 シ ス テ ム ク ラ ス を 除 く す べ て の ク ラ ス の 表 明 を 有 効 に す る こ と が で き ま す 。 す べ て の シ ス テ ム ク ラ ス の 表 明 を 有 効 に す る 個 別 の ス イ ッ チ も 用 意 さ れ て い ま す 。 −enablesystemassertions を 参 照 し て く だ さ い 。

−disableassertions :<package name>... |:<class name>
−da :<package name>... |:<class name> 表 明 を 無 効 に し ま す 。 こ れ は デ フ ォ ル ト で す 。 引 数 を 指 定 せ ず に 、 disableassertions ま た は −da で 表 明 を 無 効 に し ま す 。 「 ...」 で 終 わ る 引 数 を 1 つ 指 定 す る と 、 ス イ ッ チ に よ り 、 指 定 し た パ ッ ケ ー ジ お よ び す べ て の サ ブ パ ッ ケ ー ジ 内 の 表 明 が 無 効 に な り ま す 。 「 ...」 と い う 引 数 を 指 定 す る と 、 ス イ ッ チ に よ り 、 現 在 の 作 業 用 デ ィ レ ク ト リ 内 に あ る 名 前 の な い パ ッ ケ ー ジ 内 の 表 明 が 無 効 に な り ま す 。 「 ...」 で 終 わ ら な い 引 数 を 1 つ 指 定 す る と 、 ス イ ッ チ に よ り 、 指 定 し た ク ラ ス 内 の 表 明 が 無 効 に な り ま す 。 パ ッ ケ ー ジ com.wombat.fruitbat の 表 明 は 有 効 に 、 ク ラ ス com.wombat.fruitbat.Brickbat の 表 明 は 無 効 に し て プ ロ グ ラ ム を 実 行 す る に は 、 次 の コ マ ン ド を 使 用 し ま す 。

example% java -ea:com.wombat.fruitbat... -da:com.wombat.fruitbat.Brickbat <Main Class>

−disableassertions お よ び −da ス イ ッ チ は 、 す べ て の ク ラ ス ロ ー ダ お よ び シ ス テ ム ク ラ ス (ク ラ ス ロ ー ダ を 持 た な い ) に 適 用 さ れ ま す 。 こ の 規 則 に は 1 つ 例 外 が あ り ま す 。 引 数 を 持 た な い 形 式 の 場 合 、 ス イ ッ チ は シ ス テ ム に 適 用 さ れ ま せ ん 。 こ れ を 利 用 し て 、 簡 単 に 、 シ ス テ ム ク ラ ス を 除 く す べ て の ク ラ ス 内 の 表 明 を 有 効 に す る こ と が で き ま す 。 す べ て の シ ス テ ム ク ラ ス 内 内 の 表 明 を 有 効 に す る 個 別 の ス イ ッ チ も 用 意 さ れ て い ま す 。 −disablesystemassertions を 参 照 し て く だ さ い 。

−enablesystemassertions

ム ク ラ ス の デ フ ォ ル ト の 表 明 ス テ ー タ ス を true に 設 定 し ま す )。

−disablesystemassertions

JAR の 中 に カ プ セ ル 化 さ れ た プ ロ グ ラ ム を 実 行 し ま す 。 最 初 の 引 数 は 、 起 動 ク ラ ス の 名 前 で は な く 、 JAR ア ー カ イ ブ フ ァ イ ル の 名 前 に な り ま す 。 こ の オ プ シ ョ ン が 動 作 す る た め に は 、 JAR フ ァ イ ル の マ ニ フ ェ ス ト に 形 式 Main-Class:classname の 行 が 入 っ て い な け れ ば な り ま せ ん 。 classname は 、 ユ ー ザ の ア プ リ ケ ー シ ョ ン の 開 始 点 と な る public static void main(String[] args) メ ソ ッ ド を 持 つ ク ラ ス を 識 別 し ま す 。 Jar フ ァ イ ル と Jar フ ァ イ ル の マ ニ フ ェ ス ト を 扱 う 方 法 に つ い て は 、 Jar ツ ー ル の リ フ ァ レ ン ス ペ ー ジ と 「 Java Tutorial」 の 「 Jar Files」 を 参 照 し て く だ さ い 。 こ の オ プ シ ョ ン を 使 用 す る と き は 、 JAR フ ァ イ ル が す べ て の ユ ー ザ ク ラ ス の ソ ー ス と な る た め 、 他 の ユ ー ザ ク ラ ス パ ス の 設 定 は 無 視 さ れ ま す 。

ク ラ ス が ロ ー ド さ れ る た び に ク ラ ス に 関 す る 情 報 を 表 示 し ま す 。

ガ ベ ー ジ コ レ ク シ ョ ン イ ベ ン ト が 発 生 す る た び に 報 告 し ま す 。

Interface (JNI) の 使 用 に 関 す る 情 報 を 報 告 し ま す 。

Java HotSpot VM 適 応 型 コ ン パ イ ラ に よ っ て 得 ら れ る パ フ ォ ー マ ン ス 上 の 利 点 は 、 こ の モ ー ド で は 実 現 さ れ ま せ ん 。
−Xbootclasspath:bootclasspath ブ ー ト ク ラ ス フ ァ イ ル を 探 す デ ィ レ ク ト リ 、 JAR ア ー カ イ ブ 、 お よ び ZIP ア ー カ イ ブ を コ ロ ン で 区 切 っ た リ ス ト を 指 定 し ま す 。 指 定 さ れ た パ ス に 存 在 す る ブ ー ト ク ラ ス フ ァ イ ル は 、 Java 2 SDK と Java 2 Runtime Environment に 含 ま れ る ブ ー ト ク ラ ス フ ァ イ ル の 代 わ り に 使 わ れ ま す 。
−Xbootclasspath/a:path デ フ ォ ル ト の ブ ー ト ス ト ラ ッ プ ク ラ ス パ ス に 追 加 す る デ ィ レ ク ト リ 、 JAR ア ー カ イ ブ 、 お よ び ZIP ア ー カ イ ブ の パ ス を コ ロ ン で 区 切 っ て 指 定 し ま す 。
−Xbootclasspath/p:path デ フ ォ ル ト の ブ ー ト ス ト ラ ッ プ ク ラ ス パ ス の 前 に 追 加 す る デ ィ レ ク ト リ 、 JAR ア ー カ イ ブ 、 お よ び ZIP ア ー カ イ ブ の パ ス を コ ロ ン で 区 切 っ て 指 定 し ま す 。 注 : こ の オ プ シ ョ ン を 、 rt.jar 内 の ク ラ ス を オ ー バ ー ラ イ ド す る 目 的 で 使 用 す る ア プ リ ケ ー シ ョ ン は 指 定 し な い で く だ さ い 。 指 定 す る と 、 Java 2 Runtime Environment バ イ ナ リ コ ー ド ラ イ セ ン ス 違 反 に な る こ と が あ り ま す 。

デ バ ッ ガ が 有 効 な 状 態 で 起 動 し ま す 。

Java 2 SDK の Virtual Machine で 実 行 さ れ る デ フ ォ ル ト の 形 式 検 査 は 、 JDK ソ フ ト ウ ェ ア の 1.1.x バ ー ジ ョ ン で 実 行 さ れ る 検 査 よ り も 厳 密 で は あ り ま せ ん 。 −Xfuture フ ラ グ を 使 用 す る と 、 ク ラ ス フ ァ イ ル 形 式 を よ り 仕 様 に 準 拠 し た も の に す る た め の 、 さ ら に 厳 密 な ク ラ ス フ ァ イ ル 形 式 検 査 が 有 効 に な り ま す 。 開 発 者 が 新 し い コ ー ド を 開 発 す る 際 に は 、 こ の フ ラ グ の 使 用 を 推 奨 し ま す 。 Java ア プ リ ケ ー シ ョ ン 起 動 ツ ー ル の 将 来 の リ リ ー ス で は 、 よ り 厳 密 な 検 査 が デ フ ォ ル ト に な る か ら で す 。

10 % の 低 下 を 招 き ま す 。