Jetty服务配置文件.doc

Jetty服务配置文件

    首先让我们回顾一下jetty的启动。命令“ java -jar start.jar etc/jetty.xml” 中指定的文件 etc/jetty.xml 就是我们本章讨论的主要对象，我们称这种文件叫“服务配置文件”。下文中有时候我们说jetty.xml配置文件并不是特指这个文件而是通指“服务配置文件”。

   Jetty其实提供一个IOC/DI（反转控制和依赖注射）容器，jetty.xml配置文件就是这个容器的配置文件，和Jetty本身服务没有直接关系，你甚至可以独立使用该组件。由次可见Jetty组件化设计发挥到了极致，组件之间也没有多少依赖性。相信熟悉springframework的朋友都知道它是 IOC领域的佼佼者之一。有趣的是虽然Jetty的IOC容器实现只是在内部使用，但它却是在springframework之前就存在了。Jetty的IOC容器实现代码非常少，只涉及到两个类：
· org.mortbay.xml.XmlConfiguration
· org.mortbay.xml.XmlParser

    其本质是解析服务配置文件的组件为我们提供一个动态调用Java代码的工具，Jetty利用这个工具实现所谓的IOC容器配置Server对象和相关组件。如果我们手写这些jetty.xml配置对应的Java代码的话，其实就是嵌入式使用Jetty的方法，这里也体现了Jetty设计精妙之处。

    在本章节中我们先展示下Jetty默认的jetty.xml文件，让大家对它有关大概的了解；然后详细介绍jetty xml Configuration的语法；最后我们使用org.mortbay.xml.XmlConfiguration编写写测试用例来更深入的了解jetty.xml和jetty启动配置过程。

4.1 jetty.xml 示例剖析

Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">

        50

        50

            30000

            2

            false

            8443

           5000

           5000

           m>

      w>

        "org.mortbay.jetty.deployer.ContextDeployer">

          /contexts
          5

     configuration files.    It does not support hot deploy or   -->

          lt="."/>/webapps
 false
 true
 false
          /etc/webdefault.xml

    l>

            Test Realm
            /etc/realm.properties
            0

          /yyyy_mm_dd.request.log
          yyyy_MM_dd
          t name="retainDays">90
          true
          false
          false
          GMT

    true
    true
    true
    1000

4.2 Jetty xml Configuration语法
    jetty.xml 的xml语法就好比一个编程语言，几乎就是Java语言的xml编程形式。
标签
    标签作为jetty.xml根元素，表示org.mortbay.xml.XmlConfiguration需要配置的对象。

    属性
        id：可选；如果XmlConfiguration上下文环境 中存在该ID的话就对已存在的对象进行配置，反之创建一个class属性指定的类对象，同时以id为key保存在上下文环境中。
     （其实所谓的上下文环境 就是java.util.HashMap 对象）
     class：必选；被配置的类。

    可包含其他标签 :
        New, Set, Put, Call 和 Ref
    例子 ：

  8080 
e>
指定ID属性后，通过命令java -jar start.jar etc/jetty.xml etc/jetty-ssl.xml 启动多个配置文件时，这些配置文件都会对同一Server对象进行配置。

这段xml对应的java代码是
org.mortbay.jetty.Server server = new org.mortbay.jetty.Server(); server.setPort(8080);  

标签
    设置目标对象的属性(property)，目标对象是Set标签的父标签所指的对象。如果name属性为xxx，那么就会调用目标对象的setXxx方法，如果setXxx方法不存在就会直接设置xxx属性字段。
    如果标签内容是普通文本，那么它会尽量尝试转型，如setXxx(int xxx)就会转成相应的int行。
属性
    name: 对象的属性名称

可包含对象
    不同文本, Call, New and SystemProperty，Ref 标签
      普通文本也可以和其他四个标签混合使用，所得的值是字符串相加的结果。

示例  

 jetty  

等价于Java代码：
foo.Bar bar = new  foo.Bar();
bar.setXxxDepartment("jetty" );

foo.Cat temp = new foo.Cat();
temp.doSomething();
bar.setCat(temp);

标签
    返回目标对象的属性。假如name属性为xxx，则调用目标对象的getXxx方法如果getXxx方法不存在，那么就直接访问xxx字段。

属性
     id: 如果设置id属性，那么get获得的对象将以id值为key保存在 上下文环境
    name：目标对象的属性名。
    class：如果指定该属性，则调用该类上的静态的get方法或者字段。

可包含对象
    Set, Put  和 Call 
    get所取得的对象将作为这3个标签的目标对象。

示例

ure>

等价Java代码：
//
foo.Bar bar = new  foo.Bar();
x = bar.getXxx();
env.put("xid",x);//env 为上下文环境 对象

  >

等价Java代码：
Server server = new org.mortbay.jetty.Server();
String s = server.toString();
env.put("s",s);//env 为上下文环境 对象
org.mortbay.log.Log.info(env.get("s"));

标签
    该标签是用来实现Map接口的对象上，调用Map接口的put(Object key,Object value)方法。

属性
    name：必选；作为put方法的key参数
    type： 可选；如果设置一个类型，那么会进行类型检查。

可包含对象

    普通 文本, Call , New  , SystemProperty 标签
   普通文本也可以和其他三个标签混合使用，所得的值是字符串相加的结果。
   这些内容或者标签所产生、返回的对象作为put(Object key,Object value)方法的value参数

示例
admin

标签
    Call标签会调用目标对象的方法或者调用指定Class的静态方法。Call标签是通过name属性和标签存在个数来确定哪个方法被调用。

属性
    name：必选；指定调用的方法的方法名
   class： 可选；如果设置该属性，则会调用该Class对象的静态方法

可包含对象
   0..*个标签，然后后面可跟随Set , Put ,Call标签， 这三个标签的目标对象便是Call标签所调用方法的返回对象。

示例

"org.mortbay.jetty.Server ">

      xx
      value

等级Java代码：

Server server = new Server();
Object x = server.doSomething("xx");
x.setKey("value")

如果使用class属性

      xx
      value

等级Java代码：

Object x = foo.bar.Utils.doSomething("xx");
x.setKey("value")

标签
     在New和Call标签中使用，为它们确定参数列表。Arg标签还可以通过type属性来强制参数类型。
属性
    type：可选;如果指定该值，那么会强制该参数对象的类型
可包含对象
    普通文本 , Call , New , SystemProperty，Ref
    普通文本也可以和其他四个标签混合使用，所得的值是字符串相加的结果。

示例  

   11

   aag> 

等价于Java代码：

 foo.Bar.doSomething(new foo.Bar2(11),new foo.Bar3("aa"));

标签
    作用和Java关键字“new”一样，调用构造方法来新建一个对象。

属性
    id：可选；如果设置id，那么被创建的对象会以id为key保存在 上下文环境中
   class： 必选；指明新建对象的类型。

可包含对象
   0..*个标签，然后后面可跟随Set , Put  ,Call标签， 这三个标签的目标对象便是New标签所新建的对象。
    Arg标签用来确定使用哪个构造方法。

示例

等价于Java代码：
foo.Bar bar = new  foo.Bar() //调用默认构造方法

 bar

等价于Java代码：
foo.Bar bar = new foo.Bar( "bar" )

标签
     从上下文环境 中取得指定的对象。然后使用Set，Put，Call等标签来操作该对象。还有另外一个用法是，在标签和中使用Ref标签来引用某个对象来作为Arg或者Set的值对象，如 。

属性
    id：必选；要从 上下文环境获取对象的key

可包含对象
    Set，Put，Call。
    Ref所引用的对象作为这三个标签的操作对象。

示例

        ew>

等价Java代码：
Object obj = env.get("key")//env表示上下文环境 对象

obj.SetXxx(new foo.Bar())

标签
     创建一个List对象。当Set，Put或Arg标签需要使用List对象时，该标签就会派上用场。用Item来表示一个数组元素,并且Array只能包含Item标签。
属性

    type：必选；用来指定数组元素的类型。
    id：可选；如果存在id属性，那么被创建的List对象会以id值为key保存在 上下文环境中 。

可包含对象
    Item标签
示例  
         org.mortbay.jetty.webapp.WebInfConfiguration org.mortbay.jetty.plus.webapp.EnvConfiguration org.mortbay.jetty.plus.webapp.Configuration org.mortbay.jetty.webapp.JettyWebXmlConfiguration org.mortbay.jetty.webapp.TagLibConfiguration

等价Java代码：
List plusConfig = new ArrayList();
plusConfig.add(" org.mortbay.jetty.webapp.WebInfConfiguration ");
plusConfig.add(" org.mortbay.jetty.plus.webapp.EnvConfiguration ");
p