Web.xml

阅读更多

web.xml文件详解

 

 

 

　　前言：一般的web工程中都会用到web.xml，web.xml主要用来配 置，可以方便的开发web工程。web.xml主要用来配置Filter、Listener、Servlet等。但是要说明的是web.xml并不是必须 的，一个web工程可以没有web.xml文件。

 

1、WEB工程加载web.xml过程

 

　　经过个人测试，WEB工程加载顺序与元素节点在文件中的配置顺序无关。即不会 因为 filter 写在 listener 的前面而会先加载 filter。WEB容器的加载顺序是：ServletContext -> context-param -> listener -> filter -> servlet。并且这些元素可以配置在文件中的任意位置。

 

　　加载过程顺序如下：

 

1. 启动一个WEB项目的时候，WEB容器会去读取它的配置文件web.xml，读取和两个结点。 
2. 紧急着，容创建一个ServletContext（servlet上下文），这个web项目的所有部分都将共享这个上下文。 
3. 容器将转换为键值对，并交给servletContext。 
4. 容器创建中的类实例，创建监听器。 

 

2、web.xml文件元素详解

 

　　1、schema

 

　　web.xml的模式文件是由Sun公司定义的，每个web.xml文件的根元素中，都必须标明这个 web.xml使用的是哪个模式文件。其它的元素都放在之中。

 

xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" 
    xmlns="http://java.sun.com/xml/ns/j2ee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
        http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
web-app>

 

　　2、Web应用图标

 

　　指出IDE和GUI工具用来表示Web应用的大图标和小图标。

 

<icon>
    <small-icon>/images/app_small.gifsmall-icon>
    <large-icon>/images/app_large.giflarge-icon>
icon>

 

　　3、Web应用名称

 

　　提供GUI工具可能会用来标记这个特定的Web应用的一个名称

 

<display-name>Tomcat Exampledisplay-name>

 

　　4、Web应用描述

 

　　给出于此相关的说明性文本

 

<disciption>Tomcat Example servlets and JSP pages.disciption>

 

　　5、上下文参数

 

　　声明应用范围内的初始化参数。它用于向 ServletContext提供键值对，即应用程序上下文信息。我们的listener, filter等在初始化时会用到这些上下文中的信息。在servlet里面可以通过 getServletContext().getInitParameter("context/param")得到。

 

<context-param>
    <param-name>ContextParameterpara-name>
    <param-value>testparam-value>
    <description>It is a test parameter.description>
context-param>

 

　　6、过滤器

 

　　将一个名字与一个实现javaxs.servlet.Filter接口的类相关联。

 

<filter>
    <filter-name>setCharacterEncodingfilter-name>
    <filter-class>com.myTest.setCharacterEncodingFilterfilter-class>
    <init-param>
        <param-name>encodingparam-name>
        <param-value>UTF-8param-value>
    init-param>
filter>
<filter-mapping>
    <filter-name>setCharacterEncodingfilter-name>
    <url-pattern>/*url-pattern>
filter-mapping>

 

　　7、监听器

 

<listener> 
    <listerner-class>com.listener.SessionListenerlistener-class> 
listener>

 

　　8、

 

　　 用来声明一个servlet的数据，主要有以下子元素：

 

• 指定servlet的名称
• 指定servlet的类名称
• 指定web站台中的某个JSP网页的完整路径
• 用来定义参数，可有多个init-param。在servlet类中通过getInitParamenter(String name)方法访问初始化参数
• 指定当Web应用启动时，装载Servlet的次序。当值为正数或零时：Servlet容器先加载数值小的servlet，再依次 加载其他数值大的servlet。当值为负或未定义：Servlet容器将在Web客户首次访问这个servlet时加载它。
• 用来定义servlet所对应的URL，包含两个子元素
• 指定servlet的名称
• 指定servlet所对应的URL

 

<servlet>
    <servlet-name>snoopservlet-name>
    <servlet-class>SnoopServletservlet-class>
servlet>
<servlet-mapping>
    <servlet-name>snoopservlet-name>
    <url-pattern>/snoopurl-pattern>
servlet-mapping>

<servlet>
    <servlet-name>snoopservlet-name>
    <servlet-class>SnoopServletservlet-class>
    <init-param>
        <param-name>fooparam-name>
        <param-value>barparam-value>
    init-param>
    <run-as>
        <description>Security role for anonymous accessdescription>
        <role-name>tomcatrole-name>
    run-as>
servlet>
<servlet-mapping>
    <servlet-name>snoopservlet-name>
    <url-pattern>/snoopurl-pattern>
servlet-mapping>

 

　　9、会话超时配置

 

　　单位为分钟。

 

<session-config>
    <session-timeout>120session-timeout>
session-config>

 

　　10、

 

<mime-mapping>
    <extension>htmextension>
    <mime-type>text/htmlmime-type>
mime-mapping>

 

　　11、欢迎文件页

 

<welcome-file-list>
    <welcome-file>index.jspwelcome-file>
    <welcome-file>index.htmlwelcome-file>
    <welcome-file>index.htmwelcome-file>
welcome-file-list>

 

　　12、错误页面

 

<error-page>
    <error-code>404error-code>
    <location>/NotFound.jsplocation>
error-page>

<error-page>
    <exception-type>java.lang.NullExceptionexception-type>
    <location>/error.jsplocation>
error-page>

 

　　13、设置jsp

 

　　 包 括  和  两个子元素。其中 元素在 JSP 1.2 时就已经存在；而 是JSP 2.0 新增的元素。

 

　　 元素主要有八个子元素，它们分别为：

 

• ：设定的说明 
• ：设定名称 
• ：设定值所影响的范围，如： /CH2 或 /*.jsp
• ：若为 true，表示不支持 EL 语法 
• ：若为 true，表示不支持 <% scripting %>语法 
• ：设定 JSP 网页的编码 
• ：设置 JSP 网页的抬头，扩展名为 .jspf
• ：设置 JSP 网页的结尾，扩展名为 .jspf

 

<jsp-config>
    <taglib>
        <taglib-uri>Taglibtaglib-uri>
        <taglib-location>/WEB-INF/tlds/MyTaglib.tldtaglib-location>
    taglib>
    <jsp-property-group>
        <description>Special property group for JSP Configuration JSP example.description>
        <display-name>JSPConfigurationdisplay-name>
        <url-pattern>/jsp/* url-pattern>
        <el-ignored>trueel-ignored>
        <page-encoding>GB2312page-encoding>
        <scripting-invalid>truescripting-invalid>
        <include-prelude>/include/prelude.jspfinclude-prelude>
        <include-coda>/include/coda.jspfinclude-coda>
    jsp-property-group>
jsp-config>

 

　　对于Web 应用程式来说，Scriptlet 是个不乐意被见到的东西，因 为它会使得HTML 与Java 程式码交相混杂，对于程式的维护来说相当的麻烦，必要的时候，可以在web.xml 中加上 标签，设定所有的JSP 网页都不可以使用Scriptlet。

 

3、Mapping规则

 

　　当一个请求发送到servlet容器的时候，容器先会将请求的url减去当前 应用上下文的路径作为servlet的映射url，比如我访问的是http://localhost/test/aaa.html，我的应用上下文是 test，容器会将http://localhost/test去掉，剩下的/aaa.html部分拿来做servlet的映射匹配。这个映射匹配过程是 有顺序的，而且当有一个servlet匹配成功以后，就不会去理会剩下的servlet了。

 

　　其匹配规则和顺序如下：

 

1. 精确路径匹配。例子：比如servletA 的url-pattern为 /test，servletB的url-pattern为 /* ，这个时候，如果我访问的url为http://localhost/test ，这个时候容器就会先 进行精确路径匹配，发现/test正好被servletA精确匹配，那么就去调用servletA，也不会去理会其他的servlet了。
2. 最长路径匹配。例子：servletA的url-pattern为/test /*，而servletB的url-pattern为/test/a/*，此时访问http://localhost/test/a时，容器会选择路径最 长的servlet来匹配，也就是这里的servletB。
3. 扩展匹配，如果url最后一段包含扩展，容器将会根据扩展选择合适的servlet。例子：servletA的url-pattern：*.action

　　以”/’开头和以”/*”结尾的是用来做路径映射的。以前缀”*.”开头的是用来做扩展映射的。所以，为什么定义”/*.action”这样一个看起来很正常的匹配会错？因为这个匹配即属于路径映射，也属于扩展映射，导致容器无法判断