Spring MVC 笔记(二）之web.xml的加载顺序

关注

原创最新推荐文章于 2026-07-11 18:33:24 发布 1.3k 阅读 AI 写同款· GEO 优化 ›

Spring 4 Security MVC 登录登出完整骨架（XML配置版） Spring Security 是 Spring 生态中实现认证与授权的核心框架，其本质是通过 Filter Chain 拦截请求并委托 AuthenticationManager 执行校验。在传统 Spring MVC 架构中，Security 与 DispatcherServlet 协同工作：前者负责安全拦截与会话管理，后者处理控制器分发与视图渲染。这种组合具备强可控性、低侵入性和清晰的调试路径，特别适合遗留系统加固、教学实践及底层机制学习。本文聚焦 Spring 4 原生环境下的最小可行实现——基于阅读详情

启动WEB项目的时候，项目容器首先会去读取web.xml配置文件里的配置，当这一步骤没有出错并且完成之后，项目才能正常的被启动起来。当然，web.xml中配置的各个xml、资源等配置也要一并正确才行。

第一，最新读取的节点是文件中的<listener> </listener>节点和<context-param> </context-param>节点。

在笔记第一章中，我配置的是：

    <!-- Spring和mybatis的配置文件 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring.xml</param-value>
    </context-param>
    <context-param>
        <param-name>webAppRootKey</param-name>
        <param-value>dzcx_management.root</param-value>
    </context-param>
    <!-- logback日志配置 -->
    <context-param>
        <param-name>logbackConfigLocation</param-name>
        <param-value>classpath:logback.xml</param-value>
    </context-param>
    <listener>
        <listener-class>ch.qos.logback.ext.spring.web.LogbackConfigListener</listener-class>
    </listener>

    <session-config>
        <session-timeout>30 </session-timeout>
    </session-config>

    <!--Spring监听器 ApplicationContext 载入 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- 防止Spring内存溢出监听器 -->
    <listener>
        <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
    </listener>

紧接着，容器创建一个ServletContext(application),这个web项目的所有部分都将共享这个上下文。容器以<context-param></context-param>的name作为键，value作为值，将其转化为键值对，存入ServletContext。请参考代码中的事例，以便更容易理解。　　

　　容器创建<listener></listener>中的类实例，根据配置的class类路径<listener-class>来创建监听，在监听中会有初始化方法，启动Web应用时，系统调用Listener的该方法 contextInitialized(ServletContextEvent args)，在这个方法中获得：

　　ServletContext application =ServletContextEvent.getServletContext();

　　context-param的值= application.getInitParameter("context-param的键");

　　得到这个context-param的值之后，你就可以做一些操作了。

　　举例：你可能想在项目启动之前就打开数据库，那么这里就可以在<context-param>中设置数据库的连接方式（驱动、url、user、password），在监听类中初始化数据库的连接。这个监听是自己写的一个类，除了初始化方法，它还有销毁方法，用于关闭应用前释放资源。比如:说数据库连接的关闭，此时，调用contextDestroyed(ServletContextEvent args)，关闭Web应用时，系统调用Listener的该方法。

　　接着，容器会读取<filter></filter>，根据指定的类路径来实例化过滤器。过滤器在第一章中没有写，在此处补充如下：

    <!-- 编码过滤器 -->
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>

    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- Shiro的过滤器 -->
    <filter>
        <filter-name>shiroFilter</filter-name>
        <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
        <init-param>
            <param-name>targetFilterLifecycle</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>shiroFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

　　以上都是在WEB项目还没有完全启动起来的时候就已经完成了的工作。如果系统中有Servlet，则Servlet是在第一次发起请求的时候被实例化的，而且一般不会被容器销毁，它可以服务于多个用户的请求。所以，Servlet的初始化都要比上面提到的那几个要迟。总的来说，web.xml的加载顺序是: <context-param>-> <listener> -> <filter> -> <servlet>。其中，如果web.xml中出现了相同的元素，则按照在配置文件中出现的先后顺序来加载。

web.xml标签详解

　　1.<web-app></web-app>

　　<web-app></web-app>是部署描述的根元素，该元素含23个子元素。如果你用的是Servlet2.3，你会发现，子元素必须按照DTD文件描述中指定的顺序出现。比如：如果部署描述符中的<web-app>元素有<servlet>和<servlet-mapping>两个子元素，则<servlet>子元素必须出现在<servlet-mapping>子元素之前。在Servlet2.4中，顺序并不重要。

　　2.<display-name></display-name>　

　　<display-name></display-name>定义web应用的名称。

　　3.<distributable/>

　　<distributable/>可以使用distributable元素来告诉servlet/JSP容器，Web容器中部署的应用程序适合在分布式环境下运行。

　　4.<context-param></context-param>

　　<context-param>元素含有一对参数名和参数值，用作应用的Servlet上下文初始化参数，参数名在整个Web应用中必须是惟一的，在web应用的整个生命周期中上下文初始化参数都存在，任意的Servlet和jsp都可以随时随地访问它。<param-name>子元素包含有参数名，而<param-value>子元素包含的是参数值。作为选择，可用<description>子元素来描述参数。

　　配置Spring，必须需要<listener>，而<context-param>可有可无，如果在web.xml中不写<context-param>配置信息，默认的路径是/WEB-INF/applicationContext.xml，在WEB-INF目录下创建的xml文件的名称必须是applicationContext.xml。如果是要自定义文件名可以在web.xml里加入contextConfigLocation这个context参数：在<param-value>里指定相应的xml文件名，如果有多个xml文件，可以写在一起并以“,”号分隔.　　

　　配置在同一个容器中的多个web项目，要配置不同的webAppRootKey，web.xml文件中最好定义webAppRootKey参数，如果不定义，将会缺省为“webapp.root”，为防止log4j配置冲突，每个项目配置不同的webAppRootKey。

　　当然也不能重复，否则报类似下面的错误：

　　Web app root system property already set to different value: 'webapp.root' = [/home/user/tomcat/webapps/project1/] instead of 　　[/home/user/tomcat/webapps/project2/] - Choose unique values for the 'webAppRootKey' context-param in your web.xml files!

　　5.<session-config></session-config>

　　<session-config> 用于设置容器的session参数，比如：<session-timeout>用于指定http session的失效时间。默认时间设置(30minutes)。<session-timeout>用来指定默认的会话超时时间间隔，以分钟为单位。该元素值为整数。如果 session-timeout元素的值为零或负数，则表示会话将永远不会超时。

　　6.<filter></filter>见我的博客，这里不在阐述。

　　7.<listener></listener>见我的博客，这里不在阐述。

　　8.<servlet></servlet>

　　8.1.Servlet介绍

　　Servlet通常称为服务端小程序，是服务端的程序，用于处理及响应客户的请求。Servlet是一个特殊的Java类，创建Servlet类自动继承HttpServlet。客户端通常只有GET和POST两种请求方式，Servlet为了响应这两种请求，必须重写doGet()和doPost()方法。大部分时候，Servlet对于所有的请求响应都是完全一样的，此时只需要重写service()方法即可响应客户端的所有请求。另外HttpServlet有两个方法:

　　init(ServletConfig config):创建Servlet实例时，调用该方法初始化Servlet资源。

　　destory():销毁Servlet实例时，自动调用该方法回收资源。

　　通常无需重写init()和destory()两个方法，除非需要在初始化Servlet时，完成某些资源初始化的方法，才考虑重写init()方法。如果重写了init()方法，应该在重写该方法的第一行调用super.init(config),该方法将调用HttpServlet的init()方法。如果需要在销毁Servlet之前，先完先完成某些资源的回收，比如关闭数据库链接，才需要重写destory()方法。

　　8.2.Servlet的生命周期

　　创建Servlet实例有两个时机：

　　客户端第一次请求某个Servlet时，系统创建该Servlet的实例，大部分Servlet都是这种Servlet；

　　web应用启动时立即创建Servlet实例，即<load-on-start>1</laod-on-start>

　　每个Servlet的运行都遵循如下生命周期：

　　（1）创建Servlet实例。

　　（2）Web容器调用Servlet的init()方法，对Servlet进行初始化。

　　（3）Servlet初始化之后，将一直存在与容器之中，用于响应客户端请求，如果客户端发送GET请求，容器调用Servlet的doGet()方法处理并响应请求；如果客户端发送POST请求，容器调用Servlet的doPost()方法处理并响应请求。或者统一使用service()方法处理来响应用户请求。

　　（4）Web容器决定销毁Servlet时，先调用Servlet的destory()方法，通常在关闭Web应用时销毁Servlet实例。

　　8.3.Servlet的配置

　　为了让Servlet能响应用户请求，还必须将Servlet配置在web应用中，配置Servlet需要修改web.xml文件。从Servlet3.0开始，配置Servlet有两种方式：

　　（1）在Servlet类中使用基于注解的方式进行配置：@WebServlet

　　（2）在web.xml文件中进行配置。

　　我们用web.xml文件来配置Servlet，需要配置<servlet>和<servlet-mapping>。<servlet>用来声明一个Servlet。<icon>、<display-name>和<description>元素的用法和<filter>的用法相同。<init-param>元素与<context-param>元素具有相同的元素描述符，可以使用<init-param>子元素将初始化参数名和参数值传递给Servlet，访问Servlet配置参数通过ServletConfig对象来完成，ServletConfig提供如下方法：

　　java.lang.String.getInitParameter(java.lang.String name)：用于获取初始化参数

　　ServletConfig获取配置参数的方法和ServletContext获取配置参数的方法完全一样，只是ServletContex是取得当前Servlet的配置参数，而ServletContext是获取整个web应用的配置参数。

　　8.4.配置Spring MVC的Servlet

　　配置Spring MVC，指定处理请求的Servlet，有两种方式：

　　(1)默认查找MVC配置文件的地址是：/WEB-INF/${servletName}-servlet.xml。

　　(2)可以通过修改配置文件的位置，需要在配置DispatcherServlet时指定MVC配置文件的位置。

　　8.5.classpath与classpath*区别

　　同名资源存在时，classpath只从第一个符合条件的classpath中加载资源，而classpath*会从所有的classpath中加载符合条件的资源。classpath*，需要遍历所有的classpath，效率肯定比不上classpath，因此在项目设计的初期就尽量规划好资源文件所在的路径，避免使用classpath*来加载。

　　8.6.ContextLoaderListener和DispatcherServlet初始化上下文关系和区别

　　从上图可以看出，ContextLoaderListener初始化的上下文加载的Bean是对于整个应用程序共享的，一般如：DAO层、Service层Bean；DispatcherServlet初始化的上下文加载的Bean是只对Spring MVC有效的Bean，如：Controller、HandlerMapping、HandlerAdapter等，该初始化上下文只加载Web相关组件。

　　注意：用户可以配置多个DispatcherServlet来分别处理不同的url请求，每个DispatcherServlet上下文都对应一个自己的子Spring容器，他们都拥有相同的父Spring容器（业务层，持久（dao）bean所在的容器）。

　　9.<welcome-file-list></welcome-file-list>

　　<welcome-file-list>包含一个子元素<welcome-file>，<welcome-file>用来指定首页文件名称。<welcome-file-list>元素可以包含一个或多个<welcome-file>子元素。如果在第一个<welcome-file>元素中没有找到指定的文件，Web容器就会尝试显示第二个，以此类推。

收录于