Jetty 配置文件语法

cy_88

　　语法
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");

英文原文：　 http://docs.codehaus.org/display/JETTY/Syntax+Reference