DirSet

DirSets are groups of directories. These directories can be found in a directory tree starting in a base directory and are matched by patterns taken from a number of PatternSets. DirSets can appear inside tasks that support this feature or at the same level as target (i.e., as children of <project>).

DirSet はディレクトリの集まりです。 これらのディレクトリは、 ベースディレクトリからはじまるディレクトリツリーにあり、 幾つかの PatternSet から得られるパターンにマッチします。 DirSet はこの機能をサポートするタスクの中に置かれるか、 target と同じレベルに置かれます。 (即ち、<project> の子要素として)

PatternSets can be specified as nested <patternset> elements. In addition, DirSet holds an implicit PatternSet and supports the nested <include>, <includesfile>, <exclude> and <excludesfile> elements of <patternset> directly, as well as <patternset>'s attributes.

PatternSet は <patternset> 要素をネストすることによっても指定することができます。 それに加えて、 DirSet は暗黙的な ParternSet を持ち、 <patternset> の属性と同様に、 <patternset><include><includesfile><exclude><excludesfile> 要素を直接ネストするのをサポートしています。

Attribute Description Required
dir The root of the directory tree of this DirSet. Yes
includes A comma- or space-separated list of patterns of directories that must be included; all directories are included when omitted. No
includesfile The name of a file; each line of this file is taken to be an include pattern. No
excludes A comma- or space-separated list of patterns of directories that must be excluded; no directories are excluded when omitted. No
excludesfile The name of a file; each line of this file is taken to be an exclude pattern. No
casesensitive Specifies whether case-sensitivty should be applied (true|yes|on or false|no|off). No; defaults to true.
followsymlinks Shall symbolic links be followed? Defaults to true. See fileset's documentation. No
属性 説明 必須
dir この DirSet のディレクトリツリーのルート Yes
includes カンマか空白文字で区切られた含めたいディレクトリのパターンのリスト。 省略した場合全てのディレクトリが含まれます。 No
includesfile ファイル名: このファイルの各行が include パターンとして扱われます No
excludes カンマか空白文字で区切られた除外するディレクトリのパターンのリスト。 省略した場合、何もディレクトリは除外されません。 No
excludesfile ファイル名: このファイルの各行が exclude パターンとして扱われます No
casesensitive 大文字小文字を区別するか指定します。 (true|yes|on あるいは false|no|off) No; デフォルトはtrue.
followsymlinks シンボリックリンクに従うか。 デフォルトは true。 ファイルセットのドキュメントを参照 No

Examples

<dirset dir="${build.dir}">
  <include name="apps/**/classes"/>

  <exclude name="apps/**/*Test*"/>
</dirset>

Groups all directories named classes found under the apps subdirectory of ${build.dir}, except those that have the text Test in their name.

${build.dir}の、サブディレクトリ apps 以下にある、 名前にTestを含まない、 全てのclassesという名前のディレクトリを集めます

<dirset dir="${build.dir}">
  <patternset id="non.test.classes">

    <include name="apps/**/classes"/>
    <exclude name="apps/**/*Test*"/>
  </patternset>
</dirset>

Groups the same directories as the above example, but also establishes a PatternSet that can be referenced in other <dirset> elements, rooted at a different directory.

別のディレクトリをルートとする 別の <dirset> 要素を参照する PatternSet を作るのに加え、 上の例と同じディレクトリを集めます。

<dirset dir="${debug_build.dir}" >
  <patternset refid="non.test.classes"/>

</dirset>

Groups all directories in directory ${debug_build.dir}, using the same patterns as the above example.

上の例と同じパターンを使って、 ${debug_build.dir} ディレクトリにある全てのディレクトリを集めます。


Copyright © 2002,2004 The Apache Software Foundation. All rights Reserved.

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