Servlet 3.0 (4) 针对Web框架的可插性

五、针对Web框架的可插性

　　就像前面所说的那样，Servlet 3.0的某些改进使得我们可以将框架和程序库插入一个web应用。这个特性减少了配置的数量，并为web应用程序提供了更好的模块性。 Servlet 3.0是通过web模块部署描述符片段(或者简称web片段)来实现可插性的。

　　Web片段是框架JAR的META-INF目录中的web.xml文件的一部分。web片段提供了web应用的逻辑划分，而不必编辑特定框架组件的web部署描述符。

　 　用于web片段的元素(标签)跟用于部署描述符的元素(标签)几乎完全一样，只是根元素(父标签)除外。Web片段的根元素应该为web- fragment，并且该文件应该名为web-fragment.xml。容器只会从WEB-INF/lib文件夹中的JAR文件中查找web- fragment.xml文件。 如果lib目录中的JAR文件含有任何web-fragment.xml文件，容器将加载所需的类，并进行处理。

　　恰如Servlet名称应该在给定web.xml文件中保持唯一性一样，web片段也应如此。此外，Servlet名称必须在整个web应用中保持唯一，包括web.xml连同其他一切web片段。

　　作为一个例子，以下web-fragment.xml将被放到框架的jars/META-INF目录中：

web-fragment.xml
< web-fragment >
< servlet >
< servlet-name > ControllerServlet </ servlet-name >
< servlet-class > com.app.control.ControllerServlet </ servlet-class >
</ servlet >
< listener >
< listener-class > com.listener.AppServletContextListener </ listener-class >
</ listener >
</ web-fragment >

　　框架的JAR 文件被放置于WEB-INF/lib文件夹下面。Servlet 3.0规范没有定义web-fragment.xml和注释的配置顺序，不过它定义了web.xml和web-fragment.xml的配置次序，如下所示：

　　1. 绝对顺序

　　2. 相对顺序

图 1. Servlet 3.0中的绝对顺序：您可以利用web.xml文件中的元素来实现绝对顺序

　　您可以利用web.xml文件中的元素来实现绝对顺序，如图1所示。这个元素具有一个子元素，它可以用来规定web片段的名称，并且按照web片段的绝对顺序进行处理。如果多个web片段具有相同的名称，容器会忽略重复的web片段。

web.xml
< web-app >
< name > DemoApp </ name >
< absolute-ordering >
< name > WebFragment1 </ name >
< name > WebFragment2 </ name >
</ absolute-ordering >
...
</ web-app >

 

图 2. Servlet 3.0中的相对顺序：您可以利用web-fragment.xml文件中的元素来实现相对顺序

　　您可以利用web-fragment.xml文件中的 元素来实现相对顺序，如图2所示。 只有当web.xml中没有元素时，容器才会查看此元素。web片段的顺序是由、和元素决定的。如果某web片段具有一个子元素的话，该文件就会被移动到已排序文档列表的开头部分。同样，如果某web片段具有一个子元素的话，该文档就会被移动到已排序文档列表的末尾部分。

　　为了更好的理解相对顺序，可以考察一些例子。下面的示例假定三个JAR文件都具有一个web-fragment.xml文件。

web-fragment.xml
< web-fragment >
< name > WebFragment1 </ name >
< ordering >< after > WebFragment2 </ after ></ ordering >
...
</ web-fragment >

web-fragment.xml
< web-fragment >
< name > WebFragment2 </ name >
..
</ web-fragment >

web-fragment.xml
< web-fragment >
< name > WebFragment3 </ name >
< ordering >< before >< others /></ before ></ ordering >
..
</ web-fragment >

　　文件将按以下顺序进行处理：

　　1. WebFragment3

　　2. WebFragment2

　　3. WebFragment1

　　持有WebFragment3的JAR文件将首先处理，这是因为元素的缘故。这个设置能够确保该文档位于列表最前面。接下来，将会处理带有WebFragment2的JAR文件，因为带有WebFragment1的JAR文件使用了元素，所以它会被压入被处理文档清单的底部。嵌套在和元素之内的元素确保相应的文档分别被推到列表的顶部和底部。

　　如果web.xml遇到了和这两个元素，那么它会忽略元素;它只会考虑绝对顺序，因为那个元素会首先出现。同样，如果元素首先出现，然后才出现元素，那么容器就会忽略元素，因为它只考虑相对顺序。 如果部署描述符中没有(在web.xml中)和(在web-fragment.xml中)，那么就被认为这些文档不依赖于任何顺序。