学步园

语法
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"><br /> . . .<br /> </Set><br />
<Get> 元素

这个元素影射一个对象get方法的调用。属性名字用来选择一个get方法。如果名称是xxx，那么getXxx会被使用，或者找不到。一个Get元素可以包含Set、Put或者Call元素返回的对象。

<Get name="xyz"><br /> <Set name="xyzMethod"><New class="org.mortbay.jetty.xyz"/></Set><br /> </Get><br />
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"><br /> <Arg>value1</Arg><Set name="Test">Value2</Set><br /> </New><br /> [code]<br /> 等价于:<br /> [code]<br /> Object o = new com.acme.MyClass("value1");<br /> o.setTest("value2");<br />
<Ref> 元素

这个元素引用以前产生的一个对象，一个Ref元素包含一系列作用在参考对象上的Set, Put 和 Call元素：

<Ref id="myobject" /><br /> <Set name="Test">Value2</Set><br /> </Ref><br />
另外, Ref元素可以用来做 Arg 和 Set 元素的值：

<Set name="someMethod"><Ref id="myobj"/></Set><br />
<Array> 元素

这个元素允许生成一个新的数组作为Set、 Put 或者 Arg 元素的值。属性类型决定了数组类型。

<Array type="java.lang.String"><br /> <Item>value0</Item><br /> <Item><New class="java.lang.String"><Arg>value1</Arg></New></Item><br /> </Array><br />
等价于：

String[] a = new String[]{"value0", new String("value1")};<br />
<Map> 元素
这个元素允许生成一个新的HashMap,使用键、值队：

<Map><br /> <Entry><br /> <Item>keyName</Item><br /> <Item><New class="java.lang.String"><Arg>value1</Arg></New></Item><br /> </Entry><br /> </Map><br />
等价于：

java.util.Map map = new java.util.HashMap();<br /> map.put("keyName", "value1"};<br />
<Item> 元素
这个元素定义了一个Array或者Map条目元素的条目，可选的类型属性确定了值得类型。一个Item 元素可以包含文本值或者值元素Call、New和 SystemProperty.如果值类型没有指定，值将在空格处截断。如果是多值元素，在转化成特定类型之前被当作字符串看待。

<Item><br /> <New class="org.mortbay.jetty.nio.SelectChannelConnector"><br /> <Set name="port">8080</Set><br /> <Set name="maxIdleTime">30000</Set><br /> <Set name="Acceptors">10</Set><br /> </New><br /> </Item><br />
<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");