web.xml的配置及加载顺序

web.xml的配置及加载顺序  

2013-04-16 10:12:58|  分类：web |  标签：web.xml  context-param  listener  filter  |举报|字号 订阅

      

  下载LOFTER我的照片书  |

一web.xml加载过程（步骤）：

1.启动WEB项目的时候,容器(如:Tomcat)会去读它的配置文件web.xml.读两个节点:   

<context-param></context-param>和    <listener></listener> 

2.紧接着,容器创建一个ServletContext(上下文),这个WEB项目所有部分都将共享这个上下文.

3.容器将<context-param></context-param>转化为键值对,并交给ServletContext.

4.容器创建<listener></listener>中的类实例,即创建监听

二 、 load-on-startup：控制servlet的加载顺序

load-on-startup 元素在web应用启动的时候指定了servlet被加载的顺序，它的值必须是一个整数。如果它的值是一个负整数或是这个元素（servlet配置元素）不存在，那么容器会在该 servlet被调用的时候，加载这个servlet 。如果值是正整数或零，容器在配置的时候就加载并初始化这个servlet，正数的值越小，启动该servlet的优先级越高。如果值相等，容器可以自动选择先加载谁。  如果servlet的配置元素中没有load-on-startup元素的配置，则servlet的加载顺序按照servlet-mapping出现的顺序控制

三  、加载顺序

首先可以肯定的是，加载顺序与它们在 web.xml 文件中的先后顺序无关。即不会因为 filter 写在 listener 的前面而会先加载 filter。最终得出的结论是：ServletContext （并没有在web.xml中进行配置，服务器启动创建的容器）-> listener -> filter -> servlet

        同时还存在着这样一种配置节：context-param（加载spring、加载log4j资源文件），它用于向 ServletContext 提供键值对，即应用程序上下文信息。我们的 listener, filter 等在初始化时会用到这些上下文中的信息，那么 context-param 配置节是不是应该写在 listener 配置节前呢？实际上 context-param 配置节可写在任意位置，因此真正的加载顺序为：context-param -> listener -> filter -> servlet

        对于某类配置节而言，与它们出现的顺序是有关的。以 filter 为例，web.xml 中当然可以定义多个 filter，与 filter 相关的一个配置节是 filter-mapping，这里一定要注意，对于拥有相同 filter-name 的 filter 和 filter-mapping 配置节而言，filter-mapping 必须出现在 filter 之后，否则当解析到 filter-mapping 时，它所对应的 filter-name 还未定义。web 容器启动时初始化每个 filter 时，是按照 filter 配置节出现的顺序来初始化的，当请求资源匹配多个 filter-mapping 时，filter 拦截资源是按照 filter-mapping 配置节出现的顺序来依次调用 doFilter() 方法的。

       由此，可以看出，web.xml 的加载顺序是：ServletContext -> context-param -> listener -> filter -> servlet ，而同个类型之间的实际程序调用的时候的顺序是根据对应的 mapping 的顺序进行调用的。

四 、 web.xml文件详解 

我将自己知道的web.xml的元素整理了一下：

1、web.xml首先是肯定要包含它的schema，version="2.4"表示servlet的版本号，对应的jsp版本应该是2.0，tomcat为5，

<web-app 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/web-app_2_4.xsd"

    version="2.4">

。。。。

</web-app>

其它的元素都放在<web-app></web-app>之中。

<discription></discription> 是对站台的描述

<display-name></display-name> 定义站台的名称

<distributable/> 是指定该站台是否可分布式处理

<context-param></context-param> 用来设定web站台的环境参数，它包含两个子元素：

    <param-name></param-name> 用来指定参数的名称

    <param-value></param-value> 用来设定参数值

比如：

<context-param>

    <param-name>my_param</param-name>

    <param-value>hello</param-value>

</context-param>

在此设定的参数，可以在servlet中用 getServletContext().getInitParameter("my_param") 来取得

2、listener

<listener></listener> 用来设定Listener接口，它的主要子元素为

    <listener-class></listener-class> 定义Listener的类名称

比如：

<listener>

    <listener-class>com.myTest.ContextListener</listener-class> 

</listener>

3.1、filter

<filter></filter> 是用来声明filter的相关设定，它包含以下子元素：

    <filter-name></filter-name> 这当然就是指定filter的名字

    <filter-class></filter-class> 这是用来定义filter的类的名称

    <init-param></init-param> 用来定义参数，它有两个子元素：

        <param-name></param-name> 用来指定参数的名称

        <param-value></param-value> 用来设定参数值

比如：

<filter>

        <filter-name>setCharacterEncoding</filter-name>

        <filter-class>com.myTest.setCharacterEncodingFilter</filter-class>

        <init-param>

            <param-name>encoding</param-name>

            <param-value>GB2312</param-value>

        </init-param>

</filter>

3.2、filter-mapping

与<filter></filter>同时使用的是<filter-mapping></filter-mapping> 用来定义filter所对应的URL，它有两个子元素：

    <filter-name></filter-name> 指定filter的名字

    <url-pattern></url-pattern> 指定filter所对应的URL

比如：

<filter-mapping>

        <filter-name>setCharacterEncoding</filter-name>

        <url-pattern>/*</url-pattern>

</filter-mapping>

4.1、servlet

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

    <servlet-name></servlet-name> 指定servlet的名称

    <servlet-class></servlet-class> 指定servlet的类名称

    <jsp-file></jsp-file> 指定web站台中的某个JSP网页的完整路径

    <init-param></init-param> 用来定义参数，和前面的<init-param>差不多

4.2、servlet-mapping

与<servlet></servlet>一起使用的是<servlet-mapping></servlet-mapping> 用来定义servlet所对应的URL，包含两个子元素：

    <servlet-name></servlet-name> 指定servlet的名称

    <url-pattern></url-pattern> 指定servlet所对应的URL

比如：

<servlet>

        <servlet-name>ShoppingServlet</servlet-name>

        <servlet-class>com.myTest.ShoppingServlet</servlet-class>

</servlet>

<servlet-mapping>

        <servlet-name>ShoppingServlet</servlet-name>

        <url-pattern>/shop/ShoppingServlet</url-pattern>

</servlet-mapping>

5、session-config

<session-config></session-config> 用来定义web站台中的session参数，包含一个子元素：

    <session-timeout></session-timeout> 用来定义这个web站台所有session的有效期限，单位为 分钟

6、mime-mapping

<mime-mapping></mime-mapping> 定义某一个扩展名和某一个MIME Type做对映，包含两个子元素：

    <extension></extension> 扩展名的名称

    <mime-type></mime-type> MIME格式

比如：

<mime-mapping>

    <extension>doc</extension>

    <mime-type>application/vnd.ms-word</mime-type>

</mime-mapping> 

<mime-mapping>

    <extension>xls</extension>

    <mime-type>application/vnd.ms-excel</mime-type>

</mime-mapping>

7、welcom-file-list

<welcome-file-list></welcom-file-list> 用来定义首页的列单，包含一个子元素：

    <welcome-file></welcome-file> 指定首页的文件名称

比如：

<welcome-file-list>

    <welcome-file>index.jsp</welcome-file>

    <welcome-file>index.html</welcome-file>

</welcom-file-list>

8、error-page

<error-page></error-page> 用来处理错误代码或异常的页面，有三个子元素：

    <error-code></error-code> 指定错误代码

    <exception-type></exception-type> 指定一个JAVA异常类型

    <location></location> 指定在web站台内的相关资源路径

比如：

<error-page>

    <error-code>404</error-code>

    <location>/error404.jsp</location>

</error-page>

<error-page>

    <exception-type>java.lang.Exception</exception-type>

    <location>/exception.jsp</location>

</error-page>

9、taglib

<taglib></taglib> 用来设定JSP网页所用到的Tag Library路径，有两个子元素：

    <taglib-uri></taglib-uri> 定义TLD文件的URI，在JSP网页中用taglib指令便可取得该URI 的TLD文件

    <taglib-location></taglib-location> 指定TLD文件相对于web站台的存放位置

比如：

<taglib>

      <taglib-uri>myTaglib</taglib-uri>

      <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location>

</taglib>