Conditions

These are the nested elements that can be used as conditions in the <condition> and <waitfor> tasks.

<condition>および<waitfor>タスクにおいて、条件を示すために、ネストした要素として使用できます。

not

The <not> element expects exactly one other condition to be nested into this element, negating the result of the condition. It doesn't have any attributes and accepts all nested elements of the condition task as nested elements as well.

<not>要素は、この要素内にネストした条件の結果の否定を示します。この要素は、一切の属性を持ちません。また、conditionタスクにおいて利用可能な全ての要素を、ネストした要素として利用する事ができます。

and

The <and> element doesn't have any attributes and accepts an arbitrary number of conditions as nested elements - all nested elements of the condition task are supported. This condition is true if all of its contained conditions are, conditions will be evaluated in the order they have been specified in the build file.

<and>要素は、属性を一切もたず、任意の数の条件をネストした要素として受け付けます。conditionタスクにおいて利用可能な全ての要素を、ネストした要素として利用する事ができます。この条件は、含まれている条件の全てが真であれば、真となります。条件は、ビルドファイルに記述された順に評価されます。

The <and> condition has the same shortcut semantics as the Java && operator, as soon as one of the nested conditions is false, no other condition will be evaluated.

<and>条件は、Javaの&&オぺレ−タと同一のショ−トカットセマンティクスを持ちます。すなわち、ネストされた条件の1つでも偽であれば、その他の条件は評価されません。

or

The <or> element doesn't have any attributes and accepts an arbitrary number of conditions as nested elements - all nested elements of the condition task are supported. This condition is true if at least one of its contained conditions is, conditions will be evaluated in the order they have been specified in the build file.

<or>要素は、属性を一切もたず、任意の数の条件をネストした要素として受け付けます。conditionタスクにおいて利用可能な全ての要素を、ネストした要素として利用する事ができます。この条件は、含まれている条件の1つでも真であれば、真となります。条件は、ビルドファイルに記述された順に評価されます。

The <or> condition has the same shortcut semantics as the Java || operator, as soon as one of the nested conditions is true, no other condition will be evaluated.

<or>条件は、Javaの || オぺレ−タと同一のショ−トカットセマンティクスを持ちます。すなわち、ネストした条件の1つが真であれば、その他の条件は評価されません。

available

This condition is identical to the Available task, all attributes and nested elements of that task are supported, the property and value attributes are redundant and will be ignored.

この条件は、Availableタスクと同一です。Availableタスクの全ての属性とネストした要素が使用できます。プロパティ属性およびvalue属性は、不要なものとして無視されます。

uptodate

This condition is identical to the Uptodate task, all attributes and nested elements of that task are supported, the property and value attributes are redundant and will be ignored.

この条件はUptodateタスクと同一です。Uptodateタスクの全ての属性とネスした要素を使用できます。プロパティ属性およびvalue属性は、不要なものとして無視されます。

os

Test whether the current operating system is of a given type. Each defined attribute is tested and the result is true only if all the tests succeed.

現在のオペレーティングシステム(OS)が指定されたタイプであるかどうか、テストします。それぞれの属性についてテストが行われ、全てが満たされている場合にのみ、タスクの実行結果が真となります。

Attribute
属性
Description
説明
Required
必須
family The name of the operating system family to expect.
期待するOSファミリーの名前。
No
name The name of the operating system to expect.
期待するOSの名前。
No
arch The architecture of the operating system to expect.
OSに対して期待されるアーキテクチャ。
No
version The version of the operating system to expect.
期待されるOSのバージョン。
No

Supported values for the family attribute are:

family属性に適用可能な値:

equals

Tests whether the two given Strings are identical

二つの文字列が同一かどうかをテストします。

Attribute
属性
Description
説明
Required
必須
arg1 First string to test.
比較対象となる文字列。
Yes
arg2 Second string to test.
もう一方の比較対象文字列。
Yes
casesensitive Perform a case sensitive comparision. Default is true.
文字列の大小を考慮した比較を行うかどうかのフラグ。デフォルト値はtrueです。
No
trim Trim whitespace from arguments before comparing them. Default is false.
比較前に空白文字をトリムするかどうかの比較。デフォルト値はfalseです。
No

isset

Test whether a given property has been set in this project.

プロジェクトにおいて、指定されたプロパティが設定されているかどうか、テストします。

Attribute
属性
Description
説明
Required
必須
property The name of the property to test.
設定されているかどうかテストするプロパティの名前。
Yes

checksum

This condition is identical to the Checksum task, all attributes and nested elements of that task are supported, the property and overwrite attributes are redundant and will be ignored.

この条件はChecksumタスクとまったく同じ働きをします。Checksumタスクの全ての属性およびネストした要素が使用可能ですが、propertyおよびoverwrite属性は冗長なため、無視されます。

http

The http condition checks for a valid response from a web server of the specified url. By default, HTTP responses errors of 400 or greater are viewed as invalid.

http条件は、指定されたURLで示されるWebサーバから、妥当なレスポンスが返されるかどうか、テストします。通常は、400以上のエラーコードで示される応答が返された場合、妥当でないと判断します。

Attribute
属性
Description
説明
Required
必須
url The full URL of the page to request. The web server must return a status code of <errorsBeginAt 要求するページの完全なURL。Webサーバは<errorsBeginAtで示されるエラーコードを返さなくてはいけません。 Yes.
errorsBeginAt The lowest HTTP response code that signals an error; by default '400'; server errors, not-authorized, not-found and the like are detected
エラーの発生を示す最低のHTTP応答コード。デフォルト値は400であり、サーバエラーや認証不可、存在しないファイル、およびそれに類するものが検出されます。
No

socket

The socket condition checks for the existence of a TCP/IP listener at the specified host and port.

socket条件は、指定されたホストの指定されたポートにおける、TCP/IPリスナの存在をテストします。

Attribute
属性
Description
説明
Required
必須
server The DNS name or IP address of the server.
サーバのDNS名もしくはIPアドレスを指定します。
Yes.
port The port number to connect to.
接続先のポート番号。
Yes.

filesmatch

Test two files for matching. Nonexistence of either file results in "false". This test does a byte for byte comparision, so test time scales with byte size. NB: if the files are different sizes , one of them is missing or the filenames match the answer is so obvious the detailed test is omitted.

2つのファイルの一致をテストします。いずれか一方のファイルが存在しない場合、結果は"偽"となります。このファイルの比較はバイト単位で行われるため、テストはファイルのバイト数分、行われます。ファイルのサイズが異なる場合やファイルが存在しない場合、ファイル名が一致しない場合などの結果が明白な場合は、詳細な比較は省略されます。

Attribute
属性
Description
説明
Required
必須
file1 First file to test
比較対照のファイル。
Yes.
file2 Second file to test
もう一方の比較対象のファイル。
Yes.

contains

Tests whether a string contains another one.

文字列がもう一方の文字列を含んでいるか、テストします。

Attribute
属性
Description
説明
Required
必須
string The string to search in.
部分文字列の検索元となる文字列。
Yes
substring The string to search for.
検索対象となる部分文字列。
Yes
casesensitive Perform a case sensitive comparision. Default is true.
文字の大小を区別した判定を行うかどうかを指定します。デフォルト値はtrueです。
No

istrue

Tests whether a string equals any of the ant definitions of true, that is "true","yes", or "on"

文字列が、"true"や"yes"、"on"といった、Antで定義するtrueを示すものであるかどうか、テストします。

Attribute
属性
Description
説明
Required
必須
value value to test
テスト対象の値。
Yes
    <istrue value="${someproperty}" />
    <istrue value="false" />

isfalse

Tests whether a string is not true, the negation of <istrue>

<istrue>とは逆に、文字列がtrueを示す文字列でないことを確認します。

Attribute
属性
Description
説明
Required
必須
value value to test
テスト対象の値。
Yes
    <isfalse value="${someproperty}" />
    <isfalse value="false" />

Copyright © 2001-2002 Apache Software Foundation. All rights Reserved.

[訳注:これは山崎政憲が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]