javaタスク - Antリファレンス

<java>

属性

classname　 jar　 args　 classpath　 classpathref　 fork　 spawn　 jvm　 jvmargs　 maxmemory　 failonerror　 resultproperty　 dir　 output　 error　 logError　 append　 outputproproperty　 errorproperty　 input　 inputstring　 newenvironment　 timeout　

下位要素

<arg> <vmarg> <sysproperty> <syspropertyset> <classpath> <bootclasspath>

Ant から Java で作成された実行クラスを実行します。実行中の Ant と同一プロセスで起動する方法と、新しいプロセスとして起動する方法 (fork と呼んでいます) を選択できます。

属性

classname: 実行する Java のクラス名。
デフォルト: jar か classname のどちらか必須
jar: 実行する JAR ファイルの場所 (マニフェストファイルに Main-Class が記述されていなければなりません)。このオプションを選択するなら fork 属性を true に設定する必要があります。
デフォルト: jar か classname のどちらか必須
args: 実行クラスに渡す引数。推奨されません。代わりにネストした <arg> 要素を使用してください。
デフォルト: 省略可
classpath: 使用するクラスパス。
デフォルト: 省略可
classpathref: 別の場所で定義されている PATH への reference として与えられる、使用するクラスパス。
デフォルト: 省略可
fork: もし true にした場合、クラスの実行は Ant と別の仮想マシンで実行されます。
デフォルト: false
spawn: もし true にした場合、Ant の外側で生きるプロセスの開始を許可します。fork=true にする必要があり、timeout, input, output, error, result 属性とは互換がありません。
デフォルト: false
jvm: Java 仮想マシンを呼び出す時に使用するコマンド。このコマンドは java.lang.Runtime.exec() によって解決されます。fork が無効なら無視されます。
デフォルト: java
jvmargs: 新しく起動した仮想マシンに渡す引数 (fork が無効なら無視されます)。推奨されません。代わりにネストした <jvmarg> を使用してください。
デフォルト: 省略可
maxmemory: 新しく起動した仮想マシンに割り当てる最大メモリ量 (fork が向こうなら無視されます)。
デフォルト: 仮想マシンのデフォルト
failonerror: 実行したコマンドがリターンコード 0 以外で終了した場合にビルドプロセスを停止します (〓〓参照)。
デフォルト: false
resultproperty: コマンドのリターンコードを設定するプロパティの名前。failonerror=false かつ fork=true の場合にのみ有効です。
デフォルト: false
dir: 仮想マシンを呼び出す時のディレクトリ (fork が無効な場合は無視されます)。
デフォルト: カレントディレクトリ
output: 出力を保存するためのファイル名。もし標準エラーストリームがファイルへもプロパティへもリダイレクトされていない場合はこの出力先に出力されます。
デフォルト:
error: コマンドがリダイレクトされる標準エラーのファイル。
デフォルト:
logError: この属性はエラー出力を Ant のログ上で閲覧しつつファイルやプロパティにリダイレクトする時に使用します。エラー出力は出力ファイルやプロパティに含まれないでしょう。error や errorProperty 属性にリダイレクトするなら、この属性は何の影響もありません。
デフォルト:
append: output や error ファイルに追加するか上書きするかを設定します。
デフォルト: false
outputproproperty: コマンドの出力を格納するプロパティの名前。エラーストリームがファイルやストリームの分けてリダイレクトされていないのであれば、このプロパティはエラー出力も含みます。
デフォルト:
errorproperty: コマンドの標準エラーを格納するプロパティ名。
デフォルト:
input: 実行するコマンドの標準入力が取り出せるファイル。この属性は inputstring 属性と mutually exclusive です。
デフォルト: コンソールから (spawn="true" でなければ)
inputstring: 実行するコマンドの入力ストリームとして渡す文字列。この属性は input 属性と mutually exclusive です。
デフォルト: コンソールから (spawn="true" でなければ)
newenvironment: 新しい環境変数が指定されているときに古い環境を propagate しない (fork が無効の場合は無視)。
デフォルト: false
timeout: 指定された時刻が経過してもコマンドが終了しない場合に停止を行います (ミリ秒単位)。fork を有効にした場合にのみこの機能を強く推奨します。
デフォルト: false

下位の要素

<arg>
<vmarg>: Java クラスと新しく起動した仮想マシンにそれぞれ引数を記述するために <arg> と <vmarg> をネストします。
<sysproperty>: 実行クラスが必要とするシステムプロパティを記述するために >sysproperty> 要素を使用します。これらのプロパティは対象クラスの実行中の仮想マシンで有効になります (Ant や新しく起動した仮想マシンでも)。この要素の属性は〓環境変数〓と同じです。
<syspropertyset> (Ant 1.6 以降): システムプロパティとして使用するためのプロパティセットを記述できます。
<classpath>: Java の classpath 属性は〓PATHに似た構造〓で、classpath 要素経由でも設定できます。
<bootclasspath> (Ant 1.6 以降)

MOYO Laboratory ≫ Antリファレンス ∥ カスタムタスク	フレームあり ∥ なし
`<java>` 属性 `classname`　 `jar`　 `args`　 `classpath`　 `classpathref`　 `fork`　 `spawn`　 `jvm`　 `jvmargs`　 `maxmemory`　 `failonerror`　 `resultproperty`　 `dir`　 `output`　 `error`　 `logError`　 `append`　 `outputproproperty`　 `errorproperty`　 `input`　 `inputstring`　 `newenvironment`　 `timeout`　下位要素 `<arg>` `<vmarg>` `<sysproperty>` `<syspropertyset>` `<classpath>` `<bootclasspath>` Ant から Java で作成された実行クラスを実行します。実行中の Ant と同一プロセスで起動する方法と、新しいプロセスとして起動する方法 (fork と呼んでいます) を選択できます。属性 `classname` 実行する Java のクラス名。デフォルト: jar か classname のどちらか必須 `jar` 実行する JAR ファイルの場所 (マニフェストファイルに `Main-Class` が記述されていなければなりません)。このオプションを選択するなら `fork` 属性を `true` に設定する必要があります。デフォルト: jar か classname のどちらか必須 `args` 実行クラスに渡す引数。推奨されません。代わりにネストした `<arg>` 要素を使用してください。デフォルト: 省略可 `classpath` 使用するクラスパス。デフォルト: 省略可 `classpathref` 別の場所で定義されている `PATH` への `reference` として与えられる、使用するクラスパス。デフォルト: 省略可 `fork` もし `true` にした場合、クラスの実行は Ant と別の仮想マシンで実行されます。デフォルト: `false` `spawn` もし `true` にした場合、Ant の外側で生きるプロセスの開始を許可します。`fork=true` にする必要があり、`timeout`, `input`, `output`, `error`, `result` 属性とは互換がありません。デフォルト: `false` `jvm` Java 仮想マシンを呼び出す時に使用するコマンド。このコマンドは `java.lang.Runtime.exec()` によって解決されます。`fork` が無効なら無視されます。デフォルト: `java` `jvmargs` 新しく起動した仮想マシンに渡す引数 (`fork` が無効なら無視されます)。推奨されません。代わりにネストした `<jvmarg>` を使用してください。デフォルト: 省略可 `maxmemory` 新しく起動した仮想マシンに割り当てる最大メモリ量 (`fork` が向こうなら無視されます)。デフォルト: 仮想マシンのデフォルト `failonerror` 実行したコマンドがリターンコード 0 以外で終了した場合にビルドプロセスを停止します (〓〓参照)。デフォルト: `false` `resultproperty` コマンドのリターンコードを設定するプロパティの名前。`failonerror=false` かつ `fork=true` の場合にのみ有効です。デフォルト: `false` `dir` 仮想マシンを呼び出す時のディレクトリ (`fork` が無効な場合は無視されます)。デフォルト: カレントディレクトリ `output` 出力を保存するためのファイル名。もし標準エラーストリームがファイルへもプロパティへもリダイレクトされていない場合はこの出力先に出力されます。デフォルト: `error` コマンドがリダイレクトされる標準エラーのファイル。デフォルト: `logError` この属性はエラー出力を Ant のログ上で閲覧しつつファイルやプロパティにリダイレクトする時に使用します。エラー出力は出力ファイルやプロパティに含まれないでしょう。`error` や `errorProperty` 属性にリダイレクトするなら、この属性は何の影響もありません。デフォルト: `append` `output` や `error` ファイルに追加するか上書きするかを設定します。デフォルト: `false` `outputproproperty` コマンドの出力を格納するプロパティの名前。エラーストリームがファイルやストリームの分けてリダイレクトされていないのであれば、このプロパティはエラー出力も含みます。デフォルト: `errorproperty` コマンドの標準エラーを格納するプロパティ名。デフォルト: `input` 実行するコマンドの標準入力が取り出せるファイル。この属性は `inputstring` 属性と mutually exclusive です。デフォルト: コンソールから (spawn="true" でなければ) `inputstring` 実行するコマンドの入力ストリームとして渡す文字列。この属性は `input` 属性と mutually exclusive です。デフォルト: コンソールから (spawn="true" でなければ) `newenvironment` 新しい環境変数が指定されているときに古い環境を propagate しない (`fork` が無効の場合は無視)。デフォルト: `false` `timeout` 指定された時刻が経過してもコマンドが終了しない場合に停止を行います (ミリ秒単位)。`fork` を有効にした場合にのみこの機能を強く推奨します。デフォルト: `false` 下位の要素 `<arg>` `<vmarg>` Java クラスと新しく起動した仮想マシンにそれぞれ引数を記述するために `<arg>` と `<vmarg>` をネストします。 `<sysproperty>` 実行クラスが必要とするシステムプロパティを記述するために `>sysproperty>` 要素を使用します。これらのプロパティは対象クラスの実行中の仮想マシンで有効になります (Ant や新しく起動した仮想マシンでも)。この要素の属性は〓環境変数〓と同じです。 `<syspropertyset>` (Ant 1.6 以降) システムプロパティとして使用するためのプロパティセットを記述できます。 `<classpath>` Java の `classpath` 属性は〓PATHに似た構造〓で、classpath 要素経由でも設定できます。 `<bootclasspath>` (Ant 1.6 以降) MOYO Laboratory ≫ Antリファレンス ∥ カスタムタスク