1 定义头和根元素
　　
　　部署描述符文件就像所有XML文件一样，必须以一个XML头开始。这个头声明可以使用的XML版本并给出文件的字符编码。
　　
　　DOCYTPE声明必须立即出现在此头之后。这个声明告诉服务器适用的servlet规范的版本（如2.2或2.3）并指定管理此文件其余部分内容的语法的DTD(Document Type Definition，文档类型定义)。
　　
　　所有部署描述符文件的顶层（根）元素为web-app。请注意，XML元素不像HTML，他们是大小写敏感的。因此，web-App和WEB-APP都是不合法的，web-app必须用小写。
　　
　　2 部署描述符文件内的元素次序
　　
　　XML 元素不仅是大小写敏感的，而且它们还对出现在其他元素中的次序敏感。例如，XML头必须是文件中的第一项，DOCTYPE声明必须是第二项，而web- app元素必须是第三项。在web-app元素内，元素的次序也很重要。服务器不一定强制要求这种次序，但它们允许（实际上有些服务器就是这样做的）完全拒绝执行含有次序不正确的元素的Web应用。这表示使用非标准元素次序的web.xml文件是不可移植的。
　　
　　下面的列表给出了所有可直接出现在web-app元素内的合法元素所必需的次序。例如，此列表说明servlet元素必须出现在所有servlet-mapping元素之前。请注意，所有这些元素都是可选的。因此，可以省略掉某一元素，但不能把它放于不正确的位置。
　　
　　l icon icon元素指出IDE和GUI工具用来表示Web应用的一个和两个图像文件的位置。
　　
　　l display-name display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名称。
　　
　　l description description元素给出与此有关的说明性文本。
　　
　　l context-param context-param元素声明应用范围内的初始化参数。
　　
　　l filter 过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。
　　
　　l filter-mapping 一旦命名了一个过滤器，就要利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联。
　　
　　l listener servlet API的版本2.3增加了对事件监听程序的支持，事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类。
　　
　　l servlet 在向servlet或JSP页面制定初始化参数或定制URL时，必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的。
　　
　　l servlet-mapping 服务器一般为servlet提供一个缺省的URL：http://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URL，以便servlet可以访问初始化参数或更容易地处理相对URL。在更改缺省URL时，使用servlet-mapping元素。
　　
　　l session-config 如果某个会话在一定时间内未被访问，服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveInterval方法明确设置单个会话对象的超时值，或者可利用session-config元素制定缺省超时值。
　　
　　l mime-mapping 如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。
　　
　　l welcom-file-list welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URL时，使用哪个文件。
　　
　　l error-page error-page元素使得在返回特定HTTP状态代码时，或者特定类型的异常被抛出时，能够制定将要显示的页面。
　　
　　l taglib taglib元素对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。
　　
　　l resource-env-ref resource-env-ref元素声明与资源相关的一个管理对象。
　　
　　l resource-ref resource-ref元素声明一个资源工厂使用的外部资源。
　　
　　l security-constraint security-constraint元素制定应该保护的URL。它与login-config元素联合使用
　　
　　l login-config 用login-config元素来指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。
　　
　　l security-role security-role元素给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易。
　　
　　l env-entry env-entry元素声明Web应用的环境项。
　　
　　l ejb-ref ejb-ref元素声明一个EJB的主目录的引用。
　　
　　l ejb-local-ref ejb-local-ref元素声明一个EJB的本地主目录的应用。
　　
　　3 分配名称和定制的UL
　　
　　在web.xml中完成的一个最常见的任务是对servlet或JSP页面给出名称和定制的URL。用servlet元素分配名称，使用servlet-mapping元素将定制的URL与刚分配的名称相关联。
　　
　　3.1 分配名称
　　
　　为了提供初始化参数，对servlet或JSP页面定义一个定制URL或分配一个安全角色，必须首先给servlet或JSP页面一个名称。可通过 servlet元素分配一个名称。最常见的格式包括servlet-name和servlet-class子元素（在web-app元素内），如下所示：
　　
　　
　　Test
　　moreservlets.TestServlet
　　
　　
　　这表示位于WEB-INF/classes/moreservlets/TestServlet的servlet已经得到了注册名Test。给 servlet一个名称具有两个主要的含义。首先，初始化参数、定制的URL模式以及其他定制通过此注册名而不是类名引用此servlet。其次,可在 URL而不是类名中使用此名称。因此，利用刚才给出的定义，URL http://host/webAppPrefix/servlet/Test 可用于 http://host/webAppPrefix/servlet/moreservlets.TestServlet 的场所。
　　
　　请记住：XML元素不仅是大小写敏感的，而且定义它们的次序也很重要。例如，web-app元素内所有servlet元素必须位于所有servlet- mapping元素（下一小节介绍）之前，而且还要位于5.6节和5.11节讨论的与过滤器或文档相关的元素（如果有的话）之前。类似地，servlet 的servlet-name子元素也必须出现在servlet-class之前。5.2节"部署描述符文件内的元素次序"将详细介绍这种必需的次序。
　　
　　例如，程序清单5-1给出了一个名为TestServlet的简单servlet，它驻留在moreservlets程序包中。因为此servlet是扎根在一个名为deployDemo的目录中的Web应用的组成部分，所以TestServlet.class放在deployDemo/WEB- INF/classes/moreservlets中。程序清单5-2给出将放置在deployDemo/WEB-INF/内的web.xml文件的一部分。此web.xml文件使用servlet-name和servlet-class元素将名称Test与TestServlet.class相关联。图 5-1和图5-2分别显示利用缺省URL和注册名调用TestServlet时的结果。
　　
　　程序清单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" +
　　"");
　　}
　　}
　　
　　程序清单5-2 web.xml（说明servlet名称的摘录）
　　
　　
　　　　PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
　　"http://java.sun.com/dtd/web-app_2_3.dtd">
　　
　　
　　
　　
　　Test
　　moreservlets.TestServlet
　　
　　
　　
　　
　　3.2 定义定制的URL
　　
　　大多数服务器具有一个缺省的serlvet URL：
　　
　　http://host/webAppPrefix/servlet/packageName.ServletName。虽然在开发中使用这个URL很方便，但是我们常常会希望另一个URL用于部署。例如，可能会需要一个出现在Web应用顶层的URL（如，http: //host/webAppPrefix/Anyname），并且在此URL中没有servlet项。位于顶层的URL简化了相对URL的使用。此外，对许多开发人员来说，顶层URL看上去比更长更麻烦的缺省URL更简短。
　　
　　事实上，有时需要使用定制的URL。比如，你可能想关闭缺省URL映射，以便更好地强制实施安全限制或防止用户意外地访问无初始化参数的servlet。如果你禁止了缺省的URL，那么你怎样访问servlet呢？这时只有使用定制的URL了。
　　
　　为了分配一个定制的URL，可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet- name元素提供了一个任意名称，可利用此名称引

查看本文来源

　　5.3 提供应用范围内的初始化参数
　　
　　一般，对单个地servlet或JSP页面分配初始化参数。指定的servlet或JSP页面利用ServletConfig的getInitParameter方法读取这些参数。但是，在某些情形下，希望提供可由任意servlet或JSP页面借助ServletContext的getInitParameter方法读取的系统范围内的初始化参数。
　　
　　可利用context-param元素声明这些系统范围内的初始化值。context-param元素应该包含param-name、param-value以及可选的description子元素，如下所示：
　　
　　
　　support-email
　　blackhole@mycompany.com
　　
　　
　　可回忆一下，为了保证可移植性，web.xml内的元素必须以正确的次序声明。但这里应该注意，context-param元素必须出现任意与文档有关的元素（icon、display-name或description）之后及filter、filter-mapping、listener或 servlet元素之前。
　　
　　5.4 在服务器启动时装载servlet
　　
　　假如servlet或JSP页面有一个要花很长时间执行的init （servlet）或jspInit（JSP）方法。例如，假如init或jspInit方法从某个数据库或ResourceBundle查找产量。这种情况下，在第一个客户机请求时装载servlet的缺省行为将对第一个客户机产生较长时间的延迟。因此，可利用servlet的load-on- startup元素规定服务器在第一次启动时装载servlet。下面是一个例子。
　　
　　
　　 …
　　 …
　　
　　
　　
　　可以为此元素体提供一个整数而不是使用一个空的load-on-startup。想法是服务器应该在装载较大数目的servlet或JSP页面之前装载较少数目的servlet或JSP页面。例如，下面的servlet项（放置在Web应用的WEB-INF目录下的web.xml文件中的web-app元素内）将指示服务器首先装载和初始化SearchServlet，然后装载和初始化由位于Web应用的result目录中的index.jsp文件产生的 servlet。
　　
　　
　　Search
　　myPackage.SearchServlet
　　1
　　
　　
　　Results
　　/results/index.jsp
　　2
　　
　　
　　6 声明过滤器
　　
　　servlet版本2.3引入了过滤器的概念。虽然所有支持servlet API版本2.3的服务器都支持过滤器，但为了使用与过滤器有关的元素，必须在web.xml中使用版本2.3的DTD。
　　
　　过滤器可截取和修改进入一个servlet或JSP页面的请求或从一个servlet或JSP页面发出的相应。在执行一个servlet或JSP页面之前，必须执行第一个相关的过滤器的doFilter方法。在该过滤器对其FilterChain对象调用doFilter时，执行链中的下一个过滤器。如果没有其他过滤器，servlet或JSP页面被执行。过滤器具有对到来的ServletRequest对象的全部访问权，因此，它们可以查看客户机名、查找到来的cookie等。为了访问servlet或JSP页面的输出，过滤器可将响应对象包裹在一个替身对象（stand-in object）中，比方说把输出累加到一个缓冲区。在调用FilterChain对象的doFilter方法之后，过滤器可检查缓冲区，如有必要，就对它进行修改，然后传送到客户机。
　　
　　例如，程序清单5-11帝国难以了一个简单的过滤器，只要访问相关的servlet或JSP页面，它就截取请求并在标准输出上打印一个报告（开发过程中在桌面系统上运行时，大多数服务器都可以使用这个过滤器）。
　　
　　程序清单5-11 ReportFilter.java
　　
　　package moreservlets;
　　
　　import java.io.*;
　　import javax.servlet.*;
　　import javax.servlet.http.*;
　　import java.util.*;
　　
　　/** Simple filter that prints a report on the standard output
　　* whenever the associated servlet or JSP page is accessed.
　　*

　　* 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 ReportFilter implements Filter {
　　public void doFilter(ServletRequest request,
　　ServletResponse response,
　　FilterChain chain)
　　throws ServletException, IOException {
　　HttpServletRequest req = (HttpServletRequest)request;
　　System.out.println(req.getRemoteHost() +
　　" tried to access " +
　　req.getRequestURL() +
　　" on " + new Date() + ".");
　　chain.doFilter(request,response);
　　}
　　
　　public void init(FilterConfig config)
　　throws ServletException {
　　}
　　
　　public void destroy() {}
　　}
　　
　　一旦建立了一个过滤器，可以在web.xml中利用filter元素以及filter-name（任意名称）、file-class（完全限定的类名）和（可选的）init-params子元素声明它。请注意，元素在web.xml的web-app元素中出现的次序不是任意的；允许服务器（但不是必需的）强制所需的次序，并且实际中有些服务器也是这样做的。但这里要注意，所有filter元素必须出现在任意filter-mapping元素之前， filter-mapping元素又必须出现在所有servlet或servlet-mapping元素之前。
　　
　　例如，给定上述的ReportFilter类，可在web.xml中作出下面的filter声明。它把名称Reporter与实际的类ReportFilter（位于moreservlets程序包中）相关联。
　　
　　
　　Reporter
　　moresevlets.ReportFilter
　　
　　
　　一旦命名了一个过滤器，可利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联。关于此项工作有两种选择。
　　
　　首先，可使用filter-name和servlet-name子元素把此过滤器与一个特定的servlet名（此servlet名必须稍后在相同的 web.xml文件中使用servlet元素声明）关联。例如，下面的程序片断指示系统只要利用一个定制的URL访问名为SomeServletName 的servlet或JSP页面，就运行名为Reporter的过滤器。
　　
　　
　　Reporter
　　SomeServletName
　　
　　
　　其次，可利用filter-name和url-pattern子元素将过滤器与一组servlet、JSP页面或静态内容相关联。例如，相面的程序片段指示系统只要访问Web应用中的任意URL，就运行名为Reporter的过滤器。
　　
　　
　　Reporter
　　/*
　　
　　
　　例如，程序清单5-12给出了将ReportFilter过滤器与名为PageName的servlet相关联的web.xml文件的一部分。名字 PageName依次又与一个名为TestPage.jsp的JSP页面以及以模式http: //host/webAppPrefix/UrlTest2/ 开头的URL相关联。TestPage.jsp的源代码已经JSP页面命名的谈论在前面的3节"分配名称和定制的URL"中给出。事实上，程序清单5- 12中的servlet和servlet-name项从该节原封不动地拿过来的。给定这些web.xml项，可看到下面的标准输出形式的调试报告（换行是为了容易阅读）。
　　
　　audit.irs.gov tried to access
　　http://mycompany.com/deployDemo/UrlTest2/business/tax-plan.html
　　on Tue Dec 25 13:12:29 EDT 2001.
　　
　　程序清单5-12 Web.xml（说明filter用法的摘录）
　　
　　
　　　　PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
　　"http://java.sun.com/dtd/web-app_2_3.dtd">
　　
　　
　　
　　Reporter
　　moresevlets.ReportFilter
　　
　　
　　
　　Reporter
　　PageName
　　
　　
　　
　　PageName
　　/RealPage.jsp
　　
　　
　　
　　 PageName
　　/UrlTest2/*
　　
　　
　　
　　
　　7 指定欢迎页
　　
　　假如用户提供了一个像http: //host/webAppPrefix/directoryName/ 这样的包含一个目录名但没有包含文件名的URL，会发生什么事情呢？用户能得到一个目录表？一个错误？还是标准文件的内容？如果得到标准文件内容，是 index.html、index.jsp、default.html、default.htm或别的什么东西呢？
　　
　　Welcome-file-list 元素及其辅助的welcome-file元素解决了这个模糊的问题。例如，下面的web.xml项指出，如果一个

查看本文来源