マッピングファイル名

いくつかのタスクはソースファイルを使ってターゲットファイルを作成します。 タスクにも依りますが、ターゲットファイルがどの名前になるのかは一目瞭然かもしれません (javacでは、ご存知のとおり .java ファイルに対して .class ファイルが生成されます) - しかし、他の場合にAntの手助けをしたりとかちょっとした特別の機能を使いたいとかという理由でターゲットファイルを指定したいかも知れません。

ソースファイルは通常ファイルセットとして指定しますが、 ターゲットファイルを直接指定することはありません - その代わりに１つのソースファイルに対して(複数の)ターゲットファイルを見つける方法を Ant に伝えることができます。これは、org.apache.tools.ant.util.FileNameMapper の実装が担当します。それは from と to 属性でパラメータ化されたルールをもとにしてターゲットファイルを作り上げます - つまり、このことの正確な意味は実装依存ということです。

これらの実装は、次の属性を持つ <mapper> 要素で定義します。

Antは to や from 属性中の \ や / 文字を、 現在のプラットフォームの正しいディレクトリセパレータに自動的に変換しないことに注意してください。 このセパレータを指定する必要があるなら、代わりに ${file.separator} を使用してください。

ネストした要素として指定されるパラメータ

クラスパスはネストした <classpath> 要素、つまり パス 類似構造として指定できます。

組み込まれているマッパ型:

すべての組み込まれているマッパは、大文字小文字を区別します。

identity

ターゲットファイル名はソースファイル名と同一です。to と from は共に無視します。

<mapper type="identity"/>

flatten

ターゲットファイル名は先行するディレクトリ情報を取り除いた形でソースファイル名と同一です。 to と from は共に無視します。

<mapper type="flatten"/>

merge

ターゲットファイル名は to で定義された名前で常に同じになります。 from は無視されます。

例:

<mapper type="merge" to="archive.tar"/>

glob

to と from 共に、多くても1つの * を含むパターンを定義します。 from のパターンに一致するそれぞれのソースファイルに対して、 ターゲットファイル名は to のパターン中の * を from のパターン中の * に一致した文字列と置き換えることによって to のパターンから構築します。from のパターンに一致しないソースファイル名は無視します。

<mapper type="glob" from="*.java" to="*.java.bak"/>

<mapper type="glob" from="C*ies" to="Q*y"/>

regexp

to と from ともに正規表現を定義します。 ソースファイル名が fromのパターンにマッチした場合、 ターゲットファイル名は to のパターンから構築します。 その際 \0 から \9 を全一致(\0)や () で囲まれた部分正規表現にマッチした内容を表す後方参照として使用します。 from のパターンに一致しないソースファイル名は無視します。

Antの中ではドル記号($)はもう１つドル記号を使ってエスケープする必要があることに注意してください。

regexp マッパにはサポートライブラリ、またはそのライブラリの指定を隠す org.apache.tools.ant.util.regexp.RegexpMatcher の実装が必要です。 Antには、JDK 1.4のjava.util.regex パッケージ、 jakarta-regexp および jakarta-ORO の実装が付いてきます。 ソースからコンパイルしてそれらのうちのどれかを使うつもりなら、そのライブラリが CLASSPATHの中に含まれているか確認してください。 gnu.regexp や gnu.rex をAntと一緒に 使用するための情報として この記事を参照してください。

これが意味するところは、使用しているAntリリースの optional.jar とサポートされている正規表現ライブラリの1つを必要とするということです。 両方が同じクラスパスからロードされることを確認してください。つまり CLASSPATH、 ANT_HOME/lib ディレクトリまたはそのマッパのネストした <classpath> 要素のいずれかにそれらを配置してください。 optional.jar を ANT_HOME/lib に配置し正規表現ライブラリをネストした <classpath> 要素にすることはできません。

Antは次のアルゴリズムをもとに正規表現ライブラリを選びます:

• システムプロパティ ant.regexp.matcherimpl が設定されている場合、 そのプロパティ値が org.apache.tools.ant.util.regexp.RegexpMatcher を実装した使用すべきクラスの名前とみなします。
• ant.regexp.matcherimpl が設定されていない場合、最初に JDK1.4 のクラスを、 次に jakarta-ORO を、最後に jakarta-regexp を試します。

<mapper type="regexp" from="^(.*)\.java$$" to="\1.java.bak"/>

<mapper type="regexp" from="^(.*)/([^/]+)/([^/]*)$$" to="\1/\2/\2-\3"/>

<mapper type="regexp" from="^(.*)\.(.*)$$" to="\2.\1"/>

package

glob マッパ と同じシンタックスを共有し、 package マッパはソースパターンにマッチした中で見つかったディレクトリセパレータを、 ターゲットパターンで置き換わる部分でドットに置き換えます。 このマッパーは <uptodate> と <junit> の出力と一緒に組み合わせると特に有用です。

<mapper type="package"
        from="*Test.java" to="TEST-*Test.xml"/>

unpackage (Ant 1.6 から)

このマッパは、package マッパと逆になります。 このマッパは、パッケージ名の中のドットをディレクトリセパレータに置き換えます。 これは、JUnit がテストしたテストケースと対応する XML フォーマッタの結果をマッチさせるのに有用です。 このマッパは、glob マッパ を元にしたシンタックスを共有します。

<mapper type="unpackage"
        from="TEST-*Test.xml" to="${test.src.dir}/*Test.java">

Copyright © 2000-2004 The Apache Software Foundation. All rights Reserved.

[訳注: これは下地寛武、浦本 和則が翻訳しました。日本語訳に対するコメントがあれば、 report@jajakarta.orgに送って下さい。]