部v描述W文件就像所有XML文g一P必须以一个XML头开始。这个头声明可以使用的XML版本q给出文件的字符~码?BR>DOCYTPE声明必须立即出现在此头之后。这个声明告诉服务器适用的servlet规范的版本（?.2?.3Qƈ指定理此文件其余部分内容的语法的DTD(Document Type DefinitionQ文档类型定??BR>所有部|描q符文g的顶层（根）元素为web-app。请注意QXML元素不像HTMLQ他们是大小写敏感的。因此，web-App和WEB-APP都是不合法的Qweb-app必须用小写?BR>
2 部v描述W文件内的元素次?BR>
XML元素不仅是大写敏感的，而且它们q对出现在其他元素中的次序敏感。例如，XML头必L文g中的W一，DOCTYPE声明必须是第二项Q而web-app元素必须是第三项。在web-app元素内，元素的次序也很重要。服务器不一定强制要求这U次序，但它们允许（实际上有些服务器是q样做的Q完全拒l执行含有次序不正确的元素的Web应用。这表示使用非标准元素次序的web.xml文g是不可移植的?BR>下面的列表给Z所有可直接出现在web-app元素内的合法元素所必需的次序。例如，此列表说明servlet元素必须出现在所有servlet-mapping元素之前。请注意Q所有这些元素都是可选的。因此，可以省略掉某一元素Q但不能把它放于不正的位置?BR>l icon icon元素指出IDE和GUI工具用来表示Web应用的一个和两个囑փ文g的位|?BR>l display-name display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名U?BR>l description description元素l出与此有关的说明性文本?BR>l context-param context-param元素声明应用范围内的初始化参数?BR>l filter qo器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联?BR>l filter-mapping 一旦命名了一个过滤器Q就要利用filter-mapping元素把它与一个或多个servlet或JSP面相关联?BR>l listener servlet API的版?.3增加了对事g监听E序的支持，事g监听E序在徏立、修改和删除会话或servlet环境时得到通知。Listener元素指出事g监听E序cR?BR>l servlet 在向servlet或JSP面制定初始化参数或定制URLӞ必须首先命名servlet或JSP面。Servlet元素是用来完成此项d的?BR>l servlet-mapping 服务器一般ؓservlet提供一个缺省的URLQhttp://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URLQ以便servlet可以讉K初始化参数或更容易地处理相对URL。在更改~省URLӞ使用servlet-mapping元素?BR>l session-config 如果某个会话在一定时间内未被讉KQ服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveIntervalҎ明确讄单个会话对象的超时|或者可利用session-config元素制定~省时倹{?BR>l mime-mapping 如果Web应用h惛_Ҏ的文Ӟ希望能保证给他们分配特定的MIMEcdQ则mime-mapping元素提供q种保证?BR>l welcom-file-list welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URLӞ使用哪个文g?BR>l error-page error-page元素使得在返回特定HTTP状态代码时Q或者特定类型的异常被抛出时Q能够制定将要显C的面?BR>l taglib taglib元素Ҏ记库描述W文ӞTag Libraryu Descriptor fileQ指定别名。此功能使你能够更改TLD文g的位|，而不用编辑用这些文件的JSP面?BR>l resource-env-ref resource-env-ref元素声明与资源相关的一个管理对象?BR>l resource-ref resource-ref元素声明一个资源工厂用的外部资源?BR>l security-constraint security-constraint元素制定应该保护的URL。它与login-config元素联合使用
l login-config 用login-config元素来指定服务器应该怎样l试图访问受保护面的用h权。它与sercurity-constraint元素联合使用?BR>l security-role security-role元素l出安全角色的一个列表，q些角色出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可高IDE处理安全信息更ؓҎ?BR>l env-entry env-entry元素声明Web应用的环境项?BR>l ejb-ref ejb-ref元素声明一个EJB的主目录的引用?BR>l ejb-local-ref ejb-local-ref元素声明一个EJB的本C目录的应用?BR>
3 分配名称和定制的UL
在web.xml中完成的一个最常见的Q务是对servlet或JSP面l出名称和定制的URL。用servlet元素分配名称Q用servlet-mapping元素定制的URL与刚分配的名U相兌?BR>3.1 分配名称
Z提供初始化参敎ͼ对servlet或JSP面定义一个定制URL或分配一个安全角Ԍ必须首先lservlet或JSP面一个名U。可通过servlet元素分配一个名U。最常见的格式包括servlet-name和servlet-class子元素（在web-app元素内）Q如下所C：
q表CZ于WEB-INF/classes/moreservlets/TestServlet的servlet已经得到了注册名Test。给servlet一个名U具有两个主要的含义。首先，初始化参数、定制的URL模式以及其他定制通过此注册名而不是类名引用此servlet。其?可在URL而不是类名中使用此名U。因此，利用刚才l出的定义，URL http://host/webAppPrefix/servlet/Test 可用?http://host/webAppPrefix/servlet/moreservlets.TestServlet 的场所?BR>误住：XML元素不仅是大写敏感的，而且定义它们的次序也很重要。例如，web-app元素内所有servlet元素必须位于所有servlet-mapping元素Q下一节介绍Q之前，而且q要位于5.6节和5.11节讨论的与过滤器或文档相关的元素Q如果有的话Q之前。类似地Qservlet的servlet-name子元素也必须出现在servlet-class之前?.2?部v描述W文件内的元素次?详l介l这U必需的次序?BR>例如Q程序清?-1l出了一个名为TestServlet的简单servletQ它ȝ在moreservletsE序包中。因为此servlet是扎根在一个名为deployDemo的目录中的Web应用的组成部分，所以TestServlet.class攑֜deployDemo/WEB-INF/classes/moreservlets中。程序清?-2l出放|在deployDemo/WEB-INF/内的web.xml文g的一部分。此web.xml文g使用servlet-name和servlet-class元素名UTest与TestServlet.class相关联。图5-1和图5-2分别昄利用~省URL和注册名调用TestServlet时的l果?BR>
E序清单5-1 TestServlet.java
package moreservlets;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
/** Simple servlet used to illustrate servlet naming
* and custom URLs.
*
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
* http://www.moreservlets.com/.
* © 2002 Marty Hall; may be freely used or adapted.
*/
public class TestServlet extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String uri = request.getRequestURI();
out.println(ServletUtilities.headWithTitle("Test Servlet") +"\n" +" URI: " + uri + "\n" +"");
}
}
E序清单5-2 web.xmlQ说明servlet名称的摘录）
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
3.2 定义定制的URL
大多数服务器h一个缺省的serlvet URLQ?BR>http://host/webAppPrefix/servlet/packageName.ServletName。虽然在开发中使用q个URL很方便，但是我们常常会希望另一个URL用于部v。例如，可能会需要一个出现在Web应用层的URLQ如Qhttp://host/webAppPrefix/AnynameQ，q且在此URL中没有servletV位于顶层的URL化了相对URL的用。此外，对许多开发h员来_层URL看上L更长更麻烦的~省URL更简短?BR>事实上，有时需要用定制的URL。比如，你可能想关闭~省URL映射Q以便更好地强制实施安全限制或防止用h外地讉K无初始化参数的servlet。如果你止了缺省的URLQ那么你怎样讉Kservlet呢？q时只有使用定制的URL了?BR>Z分配一个定制的URLQ可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet-name元素提供了一个Q意名Uͼ可利用此名称引用相应的servletQurl-pattern描述了相对于Web应用的根目录的URL。url-pattern元素的值必M斜杠Q?Qv始?BR>下面l出一个简单的web.xml摘录Q它允许使用URL http://host/webAppPrefix/UrlTest而不是http://host/webAppPrefix/servlet/Test?BR>http://host/webAppPrefix/servlet/moreservlets.TestServlet。请注意Q仍焉?
]]>