FilterSet

FilterSets are groups of filters. Filters can be defined as token-value pairs or be read in from a file. FilterSets can appear inside tasks that support this feature or at the same level as <target> - i.e., as children of <project>.

フィルターセットはフィルターの集合です。 フィルターはトークンと値の組で定義するか、 ファイルより読み込みます。 フィルターセットはこの機能をサポートするタスクの中か、 <target>と同じレベルで現れます。- 即ち<project>の子のレベルです。

In addition, FilterSets can specify begintoken and/or endtoken attributes to define what to match.

それに加え、 フィルターセットでは、 マッチするものを定義するために、 begintokenおよび/または endtoken属性を指定することができます。

Filtersets are used for doing replacements in tasks such as <copy>, etc.

フィルターセットは <copy> などのタスクで、 置換を行うために用いられます。

Filterset

Attribute Description Default Required
begintoken The string marking the beginning of a token (eg., @date@). @ No
endtoken The string marking the end of a token (eg., @date@). @ No
属性 説明 デフォルト 必須
begintoken トークンの始まりを示す文字列 (例 @date@) @ No
endtoken トークンの終わりを示す文字列 (例 @date@) @ No

Filter

Attribute Description Required
token The token to replace (eg., @date@) Yes
value The value to replace it with (eg., Thursday, April 26, 2001). Yes
属性 説明 必須
token 置換されるトークン(例 @date@) Yes
value 置き換える値 (例、Thursday, April 26, 2001) Yes

Filtersfile

Attribute Description Required
file A properties file of name-value pairs from which to load the tokens. Yes
属性 説明 必須
file トークンをロードする名前と値の組のプロパティファイル Yes

Examples

You are copying the version.txt file to the dist directory from the build directory but wish to replace the token @date@ with today's date.

トークン @date@ を今日の日付に置き換えようとしながら、 version.txt ファイルを build ディレクトリから、 dist ディレクトリにコピーします。

<copy file="${build.dir}/version.txt" toFile="${dist.dir}/version.txt">
  <filterset>

    <filter token="date" value="${TODAY}"/>
  </filterset>
</copy>

You are copying the version.txt file to the dist directory from the build directory but wish to replace the token %date* with today's date.

トークン %date* を今日の日付に置き換えようとしながら、 version.txt ファイルを build ディレクトリから、 dist ディレクトリにコピーします。

<copy file="${build.dir}/version.txt" toFile="${dist.dir}/version.txt">
  <filterset begintoken="%" endtoken="*">
    <filter token="date" value="${TODAY}"/>

  </filterset>
</copy>

Copy all the docs but change all dates and appropriate notices as stored in a file.

全ての日付と適切な注意書きをファイルに保存されている通りに変更しながら、全ての docs にあるファイルをコピーします。

<copy toDir="${dist.dir}/docs" >

  <fileset dir="${build.dir}/docs">
    <include name="**/*.html">
  </fileset>
  <filterset begintoken="%" endtoken="*">

    <filtersfile file="${user.dir}/dist.properties"/>
  </filterset>
</copy>

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

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