5. セレクタ

セレクタはAnt1.5で新しく追加された機能です。これまでに説明したデータ構造は、どれもファイル名を基準にしてファイルの集合を定めるものでしたが、セレクタはファイル名以外の様々な条件によってファイルの集合を扱うことができます。

セレクタは通常ファイルセットの子要素として定義しますが、プロジェクトやターゲットの子要素しても定義することができます。そのときは<selector>要素として定義し、id属性とrefid属性を用いて利用したいところから参照します。

セレクタは、大きく分けて３つに分類されます。

• コアセレクタ　
• セレクタコンテナ
• カスタムセレクタ

コアセレクタは単体として機能するセレクタで、あらかじめ用意されているものです。セレクタコンテナは、単体としては機能しないもので、他のセレクタの内包することによって利用します。カスタムセレクタは、ユーザが独自に実装するセレクタです。

5.1. コアセレクタ

コアセレクタは単体として機能するセレクタで、あらかじめAntに組み込まれてるものです。

コアセレクタには次のものがあります。

Contains

指定した文字列がファイルの内容に含まれているものを選択します。ファイル名ではなくファイルの中身を参照します。

Date

ファイルの更新時間が指定された条件に合うものを選択します。　

Depend

別の場所に存在するファイルより更新時間が新しければ選択されます。

更新時間の比較は、それぞれのファイルで異なるファイルが対象となります。デフォルトでは同じ名前のファイルが比較対象となります。

<fileset dir="{$src2}" includes="**/*.java">
  <depend targetdir="{$src1}" />
</fileset>

この例は、${src2}ディレクトリ以下に存在するJavaソースファイルのうち、${src1}ディレクトリ以下の同じ相対位置に存在する同名のファイルより更新時間が新しいものが選択さされます。また${src1}ディレクトリ以下に同名のファイルが存在しないものも選択されます。たとえば{$src2}/Test.javaというファイルが存在したとき、{$src1}/Test.javaというファイルが存在しない、もしくは${src1}/Test.javaが存在しているが更新時間が古い場合に、{$src2}/Test.javaはdependセレクタに選択されます。

比較対象のファイルとして同名のものではなく、別のファイル名変換規則を適用したい場合はmapper子要素を定義します。

Depth

ベースディレクトリから比較したファイルの深さによってファイルを選択します。

ベースディレクトリの深さは０とみなされます。次の例では、ベースディレクトリと同じディレクトリ、もしくは深さ１のディレクトリに存在するすべてのファイルが選択されます。例えば、{$src}/aや${src}/b/aは選択されますが、{$src]/c/b/aは深さ２なので選択されません。

<fileset dir="{$src}">
  <depth max="1" />
</fileset>

Filename

ファイル名パターンによってファイルを選択します。name属性で指定したパターンにマッチしたファイルが選択されます。nagate属性をtrueにした場合は、逆にパターンにマッチしないファイルが選択されます。

Present

別の場所に比較対象のファイルが存在するものを選択します。

比較対象のファイルはDepthセレクタを同じ規則で選択されます。デフォルトは同名のファイルで、子要素としてMapperを定義することによって別の規則を適用することができます。

<fileset dir="{$src1}" includes="**/*.java">
  <present targetdir="{$src2}" />
</fileset>

この例では{$src2}ディレクトリ以下に存在するJavaソースファイルで、{$src1}以下の同じ相対位置に同名のファイルが存在するものを選択します。例えば、${src2}/Test.javaが存在するとき、もし{$src1}/Test.javaが存在すれば${src2}/Test.javaは選択され、{$src2}/Test.javaが存在しないときは選択されません。

Size

ファイルのサイズによってファイルを選択します。

基準となるファイルサイズはバイトです。unitsを指定しなければvalue属性に指定した値はバイトとみなされます。unitsで指定することのできる単位には以下のものがあります。