语法
configure.dtd
这个文档类型描述符指明了xml元素和java api之间的简单影射,jetty.xml配置文件的第一行必须引用这个dtd,如下:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">
Java对象通过一连串<New>, <Set>, <Put> 和 <Call>元素来配置。下面的例子让你有个初步的了解:
<Set name="Test">value</Set> == obj.setTest("value");
<Put name="Test">value</Put> == obj.put("Test","value");
<Call name="test"><Arg>value</Arg></Call> == obj.test("value");
<New class="com.acme.MyStuff"><Arg/></New> == new com.acme.MyStuff();
最大努力地使值匹配方法中的参数,明确的类型也要指明。org.mortbay.util.XmlConfiguration类使用configure.dtd描述符来分析Jetty xml文件。
<Configure> 元素
这个根元素用来指定要配置的对象类:
<Configure class="org.mortbay.jetty.Server> . . . </Configure>
另外,如果对象已经存在并声明了一个id,那么他能在配置元素中被参考,如下:
<Configure id="Server" class="org.mortbay.jetty.Server">
配置元素包含 New, Set, Put, Call or Ref 元素。
<Set> 元素
这个元素影射一个对象set方法的调用。名称和可选属性用来选择set方法。如果名称是 xxx,那么setXxx被使用, 后者这个方法找不到。一个Set元素可以包含值文本或者值元素Call, New 和 SystemProperty。如果值类型没有定义,值会从空格截断。如果包含多值元素,在转化成指定类型之前,会作为字符串添加。一个Set附带一个类属性被作为一个静态set方法调用。
<Set name="xyz">
. . .
</Set>
<Set name="xyz">
. . .
</Set>
<Get> 元素
这个元素影射一个对象get方法的调用。属性名字用来选择一个get方法。如果名称是xxx,那么getXxx会被使用,或者找不到。一个Get元素可以包含Set、Put或者Call元素返回的对象。
<Get name="xyz">
<Set name="xyzMethod"><New class="org.mortbay.jetty.xyz"/></Set>
</Get>
<Get name="xyz">
<Set name="xyzMethod"><New class="org.mortbay.jetty.xyz"/></Set>
</Get>
A Get with a class attribute is treated as a static get method or field.
<Put> 元素
这个元素影射当前对象put方法的调用,这个对象必须应用了Map接口。属性名字用来作为put的键,可选类型属性用来确定值的类型。一个 Put 元素可以包含文本值或者值元素Call, New 和 SystemProperty. 如果没有指定类型,值将被在空格处截断。如果包含多值元素,在转化成指定类型之前被作为字符串看待。
<Put name="admin">admin</Put>
<Call> 元素
这个元素影射当前对象一个方法的任意调用,属性名字和Arg元素用来确定方法。一个Call元素可以包含一系列的Arg元素,跟随一系列作用在新对象上的Set、Put或者Call元素。
<Call name="test">
<Arg>value1</Arg>
<Set name="Test">Value2</Set>
</Call>
等价于:
Object o2 = o1.test("value1");
o2.setTest("value2");
一个带class属性的Call当作一个静态调用:
<Call class="com.acme.Foo" name="setString">
<Arg>somestring</Arg>
</Call>
等价于:
com.acme.Foo.setString("somestring");
<Arg> 元素
这个元素为Call元素定义了一个位置参数,可选类型属性用来确定值的类型。一个Arg元素可以包含文本值或者值元素Call, New 和 SystemProperty。 如果值类型没有指定,值会从空格处截断。如果是多值元素,在转化成特定类型之前,被当作字符串处理。
<Arg><Ref id="Server"/></Arg>
<Arg>./webapps</Arg>
<Arg>org/mortbay/jetty/webapp/webdefault.xml</Arg>
<Arg type="boolean">True</Arg>
<Arg type="boolean">False</Arg>
这里的Ref标签指向了一个以前指定了id参数的对象。
<New> 元素
这个元素生成一个使用Set、Put或者Arg元素作值的一个新对象。类属性决定了新对象的属性,包含的Arg元素用来做新对象构造器的值。
一个New元素可以包含一个惟一的id参数,以后可以用来引用它。一个New元素包含一系列Arg元素,跟随一系列作用在新对象上的Set, Put 和 Call 元素:
<New id="myobject" class="com.acme.MyClass">
<Arg>value1</Arg><Set name="Test">Value2</Set>
</New>
[code]
等价于:
[code]
Object o = new com.acme.MyClass("value1");
o.setTest("value2");
<New id="myobject" class="com.acme.MyClass">
<Arg>value1</Arg><Set name="Test">Value2</Set>
</New>
[code]
等价于:
[code]
Object o = new com.acme.MyClass("value1");
o.setTest("value2");
<Ref> 元素
这个元素引用以前产生的一个对象,一个Ref元素包含一系列作用在参考对象上的Set, Put 和 Call元素:
<Ref id="myobject" />
<Set name="Test">Value2</Set>
</Ref>
<Ref id="myobject" />
<Set name="Test">Value2</Set>
</Ref>
另外, Ref元素可以用来做 Arg 和 Set 元素的值:
<Set name="someMethod"><Ref id="myobj"/></Set>
<Set name="someMethod"><Ref id="myobj"/></Set>
<Array> 元素
这个元素允许生成一个新的数组作为Set、 Put 或者 Arg 元素的值。属性类型决定了数组类型。
<Array type="java.lang.String">
<Item>value0</Item>
<Item><New class="java.lang.String"><Arg>value1</Arg></New></Item>
</Array>
<Array type="java.lang.String">
<Item>value0</Item>
<Item><New class="java.lang.String"><Arg>value1</Arg></New></Item>
</Array>
等价于:
String[] a = new String[]{"value0", new String("value1")};
String[] a = new String[]{"value0", new String("value1")};
<Map> 元素
这个元素允许生成一个新的HashMap,使用键、值队:
<Map>
<Entry>
<Item>keyName</Item>
<Item><New class="java.lang.String"><Arg>value1</Arg></New></Item>
</Entry>
</Map>
<Map>
<Entry>
<Item>keyName</Item>
<Item><New class="java.lang.String"><Arg>value1</Arg></New></Item>
</Entry>
</Map>
等价于:
java.util.Map map = new java.util.HashMap();
map.put("keyName", "value1"};
java.util.Map map = new java.util.HashMap();
map.put("keyName", "value1"};
<Item> 元素
这个元素定义了一个Array或者Map条目元素的条目,可选的类型属性确定了值得类型。一个Item 元素可以包含文本值或者值元素Call、New和 SystemProperty.如果值类型没有指定,值将在空格处截断。如果是多值元素,在转化成特定类型之前被当作字符串看待。
<Item>
<New class="org.mortbay.jetty.nio.SelectChannelConnector">
<Set name="port">8080</Set>
<Set name="maxIdleTime">30000</Set>
<Set name="Acceptors">10</Set>
</New>
</Item>
<Item>
<New class="org.mortbay.jetty.nio.SelectChannelConnector">
<Set name="port">8080</Set>
<Set name="maxIdleTime">30000</Set>
<Set name="Acceptors">10</Set>
</New>
</Item>
<SystemProperty> 元素
这个元素允许JVM系统属性作为Set、Put或者Arg 元素的值。名称属性指明了属性名称,可选的默认参数提供了默认值
This element allows JVM System properties to be retrieved as part of the value of a Set, Put or Arg element. The name attribute specifies the property name and the optional default argument provides a default value.
<SystemProperty name="Test" default="value"/>
等价于:
System.getProperty("Test","value");
--转自