web.xml配置

Posted wuchao0508

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了web.xml配置相关的知识，希望对你有一定的参考价值。

1、定义头和根元素 

  • 部署描述符文件就像所有XML文件一样，必须以一个XML头开始。这个头声明可以使用的XML版本并给出文

    件的字符编码。

    DOCYTPE声明必须立即出现在此头之后。这个声明告诉服务器适用的servlet规范的版本（如2.2或2.3）并

    指定管理此文件其余部分内容的语法的DTD(Document Type Definition，文档类型定义)。

    所有部署描述符文件的顶层（根）元素为web-app。请注意，XML元素不像html，他们是大小写敏感的。因

    此，web-App和WEB-APP都是不合法的，web-app必须用小写。

    XML 元素不仅是大小写敏感的，而且它们还对出现在其他元素中的次序敏感。例如，XML头必须是文件中

    的第一项，DOCTYPE声明必须是第二项，而web- app元素必须是第三项。在web-app元素内，元素的次序也

    很重要。服务器不一定强制要求这种次序，但它们允许（实际上有些服务器就是这样做的）完全 拒绝执

    行含有次序不正确的元素的Web应用。这表示使用非标准元素次序的web.xml文件是不可移植的。

    Java代码 

    1. <?xml version="1.0" encoding="UTF-8"?>  
    2. <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">  

 2、元素详解

  •    下面的列表给出了所有可直接出现在web-app元素内的合法元素所必需的次序。例如，此列表说明servlet元素必须出现在所有servlet- mapping元素之前。请注意，所有这些元素都是可选的。因此，可以省略掉某一元素，但不能把它放于不正确的位置。

    Java代码 

    1. icon icon元素指出IDE和GUI工具用来表示Web应用的一个和两个图像文件的位置。  
    2. display-name display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名称。  
    3. description description元素给出与此有关的说明性文本。  
    4. context-param context-param元素声明应用范围内的初始化参数。  
    5. filter 过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。  
    6. filter-mapping 一旦命名了一个过滤器，就要利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联。  
    7. listener servlet API的版本2.3增加了对事件监听程序的支持，事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类。  
    8. servlet 在向servlet或JSP页面制定初始化参数或定制URL时，必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的。  
    9. servlet-mapping 服务器一般为servlet提供一个缺省的URL：<a href="http://host/webAppPrefix/servlet/ServletName">http://host /webAppPrefix/servlet/ServletName</a>。但是，常常会更改这个URL，以便servlet可以访问初 始化参数或更容易地处理相对URL。在更改缺省URL时，使用servlet-mapping元素。  
    10. session- config 如果某个会话在一定时间内未被访问，服务器可以抛弃它以节省内存。可通过使用HttpSession的 setMaxInactiveInterval方法 明确设置单个会话对象的超时值，或者可利用session-config元素制定缺省超时值。  
    11. mime-mapping 如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。  
    12. welcom-file-list welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URL时，使用哪个文件。  
    13. error-page error-page元素使得在返回特定HTTP状态代码时，或者特定类型的异常被抛出时，能够制定将要显示的页面。  
    14. taglib taglib元素对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。  
    15. resource-env-ref resource-env-ref元素声明与资源相关的一个管理对象。  
    16. resource-ref resource-ref元素声明一个资源工厂使用的外部资源。  
    17. security-constraint security-constraint元素制定应该保护的URL。它与login-config元素联合使用  
    18. login-config 用login-config元素来指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。  
    19. security-role security-role元素给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易。  
    20. env-entry env-entry元素声明Web应用的环境项。  
    21. ejb-ref ejb-ref元素声明一个EJB的主目录的引用。  
    22. l ejb-local-ref ejb-local-ref元素声明一个EJB的本地主目录的应用。  

 3、sevlet配置

  • Java代码 

    1. <servlet>  
    2. <servlet-name>Test</servlet-name>  
    3. <servlet-class>moreservlets.TestServlet</servlet-class>  
    4. </servlet>   

       这 表示位于WEB-INF/classes/moreservlets/TestServlet的servlet已经得到了注册名Test。 给 servlet一个名称具有两个主要的含义。首先，初始化参数、定制的URL模式以及其他定制通过此注册名而不是类名引用此servlet。其次,可 在 URL而不是类名中使用此名称。因此，利用刚才给出的定义，URL http://host/webAppPrefix/servlet/Test 可用于 http://host/webAppPrefix/servlet/moreservlets.TestServlet 的场所。

    Java代码 

     

    1. <servlet-mapping>  
    2. <servlet-name>Test</servlet-name>  
    3. <url-pattern>/UrlTest</url-pattern>  
    4. </servlet-mapping>  

     注意：元素出现地次序不是随意的。特别是，需要把所有servlet元素放在所有 servlet-mapping元素之前。

5 初始化和预装载servlet与JSP页面

  • 这里讨论控制servlet和JSP页面的启动行为的方法。特别是，说明了怎样分配初始化参数以及怎样更改服务器生存期中装载servlet和JSP页面的时刻。

        利 用init-param元素向servlet提供初始化参数，init-param元素具有param-name和param-value子元素。例 如， 在下面的例子中，如果initServlet servlet是利用它的注册名（InitTest）访问的，它将能够从其方法中调用 getServletConfig(). getInitParameter("param1")获得"Value 1"，调用 getServletConfig().getInitParameter("param2")获得"2"。

    Java代码 

    1. <servlet>  
    2. <servlet-name>InitTest</servlet-name>  
    3. <servlet-class>moreservlets.InitServlet</servlet-class>  
    4. <init-param>  
    5. <param-name>param1</param-name>  
    6. <param-value>value1</param-value>  
    7. </init-param>  
    8. <init-param>  
    9. <param-name>param2</param-name>  
    10. <param-value>2</param-value>  
    11. </init-param>  
    12. </servlet>  

     在涉及初始化参数时，有几点需要注意：

       l  返回值。GetInitParameter的返回值总是一个String

       l JSP中的初始化。JSP页面使用jspInit而不是init。JSP页面还需要使用jsp-file元素代替servlet-class。

       l 缺省URL。初始化参数只在通过它们的注册名或与它们注册名相关的定制URL模式访问Servlet时可以使用。

    Java代码 

    1. 程序清单5-7 InitServlet.java  
    2. package moreservlets;  
    3.   
    4. import java.io.*;  
    5. import javax.servlet.*;  
    6. import javax.servlet.http.*;  
    7.   
    8. /** Simple servlet used to illustrate servlet 
    9. * initialization parameters. 
    10. * <P> 
    11. * Taken from More Servlets and JavaServer Pages 
    12. * from Prentice Hall and Sun Microsystems Press, 
    13. * http://www.moreservlets.com/. 
    14. * © 2002 Marty Hall; may be freely used or adapted. 
    15. */  
    16.   
    17. public class InitServlet extends HttpServlet   
    18. private String firstName, emailAddress;  
    19.   
    20. public void init()   
    21. ServletConfig config = getServletConfig();  
    22. firstName = config.getInitParameter("firstName");  
    23. emailAddress = config.getInitParameter("emailAddress");  
    24.   
    25.   
    26. public void doGet(HttpServletRequest request,  
    27. HttpServletResponse response)  
    28. throws ServletException, IOException   
    29. response.setContentType("text/html");  
    30. PrintWriter out = response.getWriter();  
    31. String uri = request.getRequestURI();  
    32. out.println(ServletUtilities.headWithTitle("Init Servlet") +  
    33. "<BODY BGCOLOR=\\"#FDF5E6\\">\\n" +  
    34. "<H2>Init Parameters:</H2>\\n" +  
    35. "<UL>\\n" +  
    36. "<LI>First name: " + firstName + "\\n" +  
    37. "<LI>Email address: " + emailAddress + "\\n" +  
    38. "</UL>\\n" +   
    39. "</BODY></HTML>");  
    40.   
    41.   

     5.2 分配JSP初始化参数

    给JSP页面提供初始化参数在三个方面不同于给servlet提供初始化参数。

    1）使用jsp-file而不是servlet-class。因此，WEB-INF/web.xml文件的servlet元素如下所示：

    Java代码 

    1. <servlet>  
    2. <servlet-name>PageName</servlet-name>  
    3. <jsp-file>/RealPage.jsp</jsp-file>  
    4. <init-param>  
    5. <param-name>...</param-name>  
    6. <param-value>...</param-value>  
    7. </init-param>  
    8. ...  
    9. </servlet>  

     2) 几乎总是分配一个明确的URL模式。对servlet，一般相应地使用以http://host/webAppPrefix /servlet/ 开始的缺省URL。只需记住，使用注册名而不是原名称即可。这对于JSP页面在技术上也是合法的。例如，在上面给出的例子中，可用 URL http://host/webAppPrefix/servlet/PageName 访问RealPage.jsp的对初始化参数具有访问权 的版本。但在用于JSP页面时，许多用户似乎不喜欢应用常规的servlet的URL。此外，如果 JSP页面位于服务器为其提供了目录清单的目录中 （如，一个既没有index.html也没有index.jsp文件的目录），则用户可能会连接到此 JSP页面，单击它，从而意外地激活未初始化的页 面。因此，好的办法是使用url-pattern（5.3节）将JSP页面的原URL与注册的 servlet名相关联。这样，客户机可使用JSP页面的 普通名称，但仍然激活定制的版本。例如，给定来自项目1的servlet定义，可使用下面的 servlet-mapping定义：

    Java代码 

    1. <servlet-mapping>  
    2. <servlet-name>PageName</servlet-name>  
    3. <url-pattern>/RealPage.jsp</url-pattern>  
    4. </servlet-mapping>  

    3）JSP页使用jspInit而不是init。自动从JSP页面建立的servlet或许已经使用了inti方法。因此，使用JSP声明提供一个init方法是不合法的，必须制定jspInit方法。

    为 了说明初始化JSP页面的过程，程序清单5-9给出了一个名为InitPage.jsp的JSP页面，它包含一个jspInit方法且放置 于 deployDemo Web应用层次结构的顶层。一般，http://host/deployDemo/InitPage.jsp 形式的URL将 激活此页面的不具有初始化参数访问权的版本，从而将对firstName和emailAddress变量显示null。但是， web.xml文件（程序 清单5-10）分配了一个注册名，然后将该注册名与URL模式/InitPage.jsp相关联。

    Java代码 

    1. 程序清单5-9 InitPage.jsp  
    2. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">  
    3. <HTML>  以上是关于web.xml配置的主要内容，如果未能解决你的问题，请参考以下文章

      java——springmvc——注册中央调度器

      springmvc配置文件

      SSH 框架整合（maven版本 xml配置方式）

      java web监听器和过滤器

      如何在 web.xml 和 log4j.properties 中配置 log4j 输出文件路径？

      如何在一个 Spring 应用程序的 web.xml 中注册多个 servlet