Ant内置任务之xmlproperty
一、概述
xmlproperty是Ant内置任务,用于从格式良好的XML文件中加载属性。例如:
<root>
<properties>
<foo>bar</foo>
</properties>
</root>
等价于java属性文件的root.properties.foo = bar,默认情况下此任务不对输入做处理,不会解析属性引用如${foo}。
可以通过semanticAttributes属性启动输入处理,如果设置为true,当XML加载时会进行以下处理:
1.解析属性引用。
2.以下属性将做不同的处理:
id:属性与给定的id值关联。
location:属性被视为文件位置。
refid:属性设置为引用属性的值。
value:属性值设置为指定的值。
3.路径结构可以通过以下属性定义:
pathid:给定的id用于标识路径。
二、属性
file:要解析的XML文件,可以通过嵌套资源或单元素资源集合指定。
prefix:预置到每个属性的前缀。
keepRoot:是否保留XML根标签做为属性名的第一个值,默认为true。
validate:是否验证输入文件,否则XML必须是格式良好的,默认为false。
collapseAttributes:是否将属性视为嵌套元素,默认为false。
semanticAttributes:是否启用属性名称的特殊处理,默认为false。
includeSemanticAttribute:是否将语义属性名做为属性名的一部分,如果semanticAttributes设置为false,忽略此属性,默认为false。
rootDirectory:解析文件引用的目录,如果semanticAttributes设置为false,忽略此属性,默认为${basedir}。
delimiter:ant1.7.1起,用于分隔多个值的分隔符。默认为“,”。
支持的嵌套元素:
xmlcatalog:用于执行实体解析。
三、简单示例
property.xml
<root attr1="attrvalue1">
<property>
<p1 attr2="attrvalue2">value1</p1>
<p2>value2</p2>
</property>
</root>
build.xml
<project>
<xmlproperty file="property.xml" prefix="test1"/>
<xmlproperty file="property.xml" collapseAttributes="true" prefix="test2"/>
<xmlproperty file="property.xml" keepRoot="false" prefix="test3"/>
<echo>${test1.root.property.p1}</echo>
<echo>${test1.root.property.p2}</echo>
<echo>${test3.property.p1}</echo>
<echo>${test3.property.p1(attr2)}</echo>
<echo>${test1.root(attr1)}</echo>
<echo>${test1.root.property.p1(attr2)}</echo>
<echo>${test2.root.attr1}</echo>
<echo>${test2.root.property.p1.attr2}</echo>
</project>