Antプロパティー系タスク

定義したプロパティーを使用したい箇所では、「${プロパティー名}」とする。 （「${」があって「}」が無いとエラーになる）
「$」の文字そのものを（プロパティーの開始でなく）使いたい場合は、「$」の直後に「{」が無ければ問題ない。または「$$」とすれば常に「$」になる。[2009-02-06]

既にセットされているプロパティー名でさらにセット（上書き）しようとしても、上書きできず、以前の値がそのまま残る。[2009-03-17]
（デバッグモードで実行すると、「Override ignored for property "プロパティー名"」というメッセージが出力される）

一度セットされたプロパティーを削除（消去）することは出来ない。[2009-03-17]

Ant：property

プロパティーを定義するコアタスク。
（org.apache.tools.ant.taskdefs.Property extends Task）

属性（→最新property）

このタグを使わず、ant実行時にプロパティを定義することも出来る。

$ ant -Dプロパティ名=値

valueの例

プロパティー名に、値を直接指定する。

        <property name="test" value="テスト"/>

使用例：

        <echo message="${test}"/>
        <echo>${test}</echo>

locationの例

プロパティー名に、ディレクトリやファイルの場所を指定する。

        <property name="src_dir" location="src/java/sample"/>
        <property name="src_file" location="${src_dir}/File.java"/>

fileの例

プロパティーをファイルに書いておき、そのファイルを読み込むことが出来る。[2007-02-21]
ファイルの中に日本語を書く場合、native2asciiで変換しておかないと文字化けする。

	<property file="data.properties"/>

プロパティーファイルの例（内容）：

test=test-value

environmentの例

環境変数を読み込んでプロパティーとして扱う。

        <property environment="env"/>

使用例：

        <echo message="${env.CLASSPATH}"/>　←環境変数CLASSPATHの内容を画面に出力

Ant：tstamp

日付や時刻をプロパティーにセットするコアタスク。[2007-09-07]
（org.apache.tools.ant.taskdefs.Tstamp extends Task）
propertyタスクと同じように、projectタスクの直下やtargetタスクの中に書く。

フォーマット（書式）を指定したり日数/時間の加減算を行ったりしたプロパティーを作れるが、tstampタスクを実行すると少なくとも以下のプロパティーが定義される。

<tstamp />

<echo>today :${TODAY}</echo>
<echo>dstamp:${DSTAMP}</echo>
<echo>tstamp:${TSTAMP}</echo>

[echo] today :September 7 2007
[echo] dstamp:20070907
[echo] tstamp:2243

<tstamp>
 <format property="DATE" pattern="yyyy/MM/dd" />
 <format property="TIME" pattern="HH:mm:ss" />
 <format property="NOW"
  pattern="yyyy/MM/dd HH:mm:ss" />
</tstamp>

<echo>date-${DATE}</echo>
<echo>time-${TIME}</echo>
<echo>now- ${NOW}</echo>

[echo] date-2007/09/07
[echo] time-22:43:33
[echo] now- 2007/09/07 22:43:33

<tstamp>
 <format property="YES" offset="-1" unit="day"
  pattern="yyyy/MM/dd" />
 <format property="TOM" offset="1" unit="day"
  pattern="yyyy/MM/dd" />
</tstamp>

<echo>Yesterday ${YES}</echo>
<echo>Tomorrow  ${TOM}</echo>

[echo] Yesterday 2007/09/06
[echo] Tomorrow  2007/09/08

→最新tstamp

Ant：pathconvert

パス（pathやfileset等）を（プラットフォーム（OS）用に）変換してプロパティーにセットするコアタスク。[2010-01-09]
（org.apache.tools.ant.taskdefs.PathConvert extends Task）

パスをスペース区切りで列挙する例

	<property name="from1" location="WebContent/WEB-INF/lib" />

	<path id="lib.path">
		<fileset dir="${from1}" includes="**/*.jar" />
	</path>

	<pathconvert property="lib" refid="lib.path" dirsep="/" pathsep=" ">
		<map from="${from1}${file.separator}" to="" />
	</pathconvert>

	<echo message="${lib}" />

dirsep属性で変換後のディレクトリー区切り文字（通常、Windowsなら「\」、UNIXなら「/」）を指定する。
pathsep属性で変換後のパス区切り文字（通常、Windowsなら「;」、UNIXなら「:」）を指定する。
map要素は、パスの前部分（前方一致した文字列）を別の文字列に置換する指定。

上記の例では、WindowsでC:\sample\WebContent\WEB-INF\libの下に「a.jar」「b.jar」があるとすると、以下のような出力になる。
（from1は「C:\sample\WebContent\WEB-INF\lib」になる）

<pathconvert property="lib" refid="lib.path" />

<pathconvert property="lib" refid="lib.path" targetos="unix" />

<pathconvert property="lib" refid="lib.path" targetos="unix">
  <map from="${from1}" to="/home1" />
</pathconvert>

<pathconvert property="lib" refid="lib.path" dirsep="/" pathsep=" " />

<pathconvert property="lib" refid="lib.path" dirsep="/" pathsep=" ">
  <map from="${from1}" to="" />
</pathconvert>

<pathconvert property="lib" refid="lib.path" dirsep="/" pathsep=" ">
  <map from="${from1}${file.separator}" to="" />
</pathconvert>

Ant：length

長さをプロパティーに設定するコアタスク（Ant1.6.3以降）。[2009-02-06]
（org.apache.tools.ant.taskdefs.Length extends Task）

property属性で指定したプロパティー名に、長さがセットされる。

<length string="あいうえお"
 property="str.len" />

<echo message="${str.len}" />

<length string=" あいう " trim="true"
 property="trim.len" />

<echo message="${trim.len}" />

<length file="C:\temp\a.txt"
 property="file.len" />

<echo message="${file.len}" />

<length property="files.len">
  <fileset dir="C:\temp">
    <include name="*.txt" />
  </fileset>
</length>

<echo message="${files.len}" />

<length property="files.len"
 mode="each">
  <fileset dir="C:\temp">
    <include name="*.txt" />
  </fileset>
</length>

<echo message="${files.len}" />

Ant：resourceCount

リソース（ファイル等）の個数をプロパティーに設定するコアタスク（Ant1.7以降）。[2009-02-06]
（org.apache.tools.ant.taskdefs.ResourceCount extends Task）

property属性で指定したプロパティー名に、長さがセットされる。

<resourcecount property="files.count">
  <fileset dir="C:\temp">
    <include name="*.txt" />
  </fileset>
</resourcecount>

<echo message="${files.count}" />

Ant：loadfile

テキストファイルを読み込み、その内容をプロパティーに設定するコアタスク。[2008-10-25]
（org.apache.tools.ant.taskdefs.LoadFile extends LoadResource）

	<target name="loadfile">
		<loadfile property="zzz" srcfile="file.txt" />
		<echo message="${zzz}" />
	</target>

→最新loadfile

Ant：propertyfile

プロパティーファイルを作成するオプションタスク。[2007-09-07]
（org.apache.tools.ant.taskdefs.optional.PropertyFile extends Task）
作ったプロパティーファイルは、property file=で当然読める。

指定したプロパティーファイルが既に存在していた場合、その中で設定されていたプロパティーはそのまま残る。
もちろん値を上書きすることも出来るし、元の値に対して演算することも出来る。
ただ、値が書き込まれる順番は不定っぽい。

	<target name="make property-file">
		<propertyfile file="create.properties">
			<entry key="prop_name" 〜 />
		</propertyfile>
	</target>

<entry key="key1" value="value1" />
<entry key="key2" value="value2" operation="=" />

<entry key="def1" default="def" />

<entry key="exp1" type="int" operation="+" value="10" />
<entry key="exp2" type="int" operation="-" value="10" />

<entry key="exp3" type="int" operation="+" value="1" pattern="000" />

<entry key="now1" type="date" value="now" pattern="yyyyMMddHHmmss" />

<entry key="day1" type="date" operation="+" value="1" unit="day"
 pattern="yyyyMMdd" />

→最新propertyfile

Ant：condition系

条件を満たしたときにプロパティーに文字列が設定されるタスク群。[2009-03-17]
デフォルトでは「true」という文字列がセットされる。

条件が満たされなかったときは無処理。
すなわち、falseになるわけではなく、空文字列になるわけでもなく、プロパティーが削除されるわけでもない。

設定されたかどうかに応じて後続の処理を変えることが出来る。→プロパティーの存在チェック

プロパティーの存在チェック

プロパティーが設定されているかどうかの判定を行うことが出来る。[2009-03-17]
（プロパティーが存在しているかどうかであって、内容が空文字列であっても存在している事になる）