PropertySet

自 Apache Ant 1.6 起

将一组属性分组,以便在支持此功能的任务中通过引用使用。

属性 描述 必需
dynamic 是否在每次使用该集合时重新评估该集合。 否;默认值为 true
negate 是否否定结果。如果为 true,则将返回所有被嵌套元素选中的属性。自 Ant 1.6.2 起 否;默认值为 false
refid 使此 propertyset 成为对在其他地方定义的 propertyset引用。如果指定,则不允许其他属性或嵌套元素。

作为嵌套元素指定的参数

propertyref

从当前项目中选择要包含在集合中的属性。

属性 描述 必需
name 选择具有给定名称的属性。 这些选项中只有一个
prefix 选择名称以给定字符串开头的属性。
regex 选择与给定正则表达式匹配的属性。类似于regexp 类型映射器,这需要支持的正则表达式库。
builtin 选择内置属性集。此属性的有效值为 all(所有 Ant 属性)、system(系统属性)和 commandline(调用 Ant 时在命令行上指定的所有属性(加上一些特殊的内部 Ant 属性))。

propertyset

propertyset 可用作更多 propertyset 的集合并集。

例如

<propertyset id="properties-starting-with-foo">
  <propertyref prefix="foo"/>
</propertyset>
<propertyset id="properties-starting-with-bar">
  <propertyref prefix="bar"/>
</propertyset>
<propertyset id="my-set">
  <propertyset refid="properties-starting-with-foo"/>
  <propertyset refid="properties-starting-with-bar"/>
</propertyset>

将名称以 foobar 开头的所有属性收集到名为 my-set 的集合中。

mapper

映射器——最多可以指定一个映射器。映射器用于更改属性键的名称,例如

<propertyset id="properties-starting-with-foo">
  <propertyref prefix="foo"/>
  <mapper type="glob" from="foo*" to="bar*"/>
</propertyset>

将名称以 foo 开头的所有属性收集起来,但将名称更改为以 bar 开头。

如果提供,则嵌套映射器将在对匹配属性进行任何否定之后应用。