web应用的配置描述符--web.xml文件

配置描述符web.xml对于java web应用来说非常重要。

在servlet2.5规范之前，每个Java WEB应用都必须包含个web.xml文件，且必须在WEB-INF路径下。从servlet3.0开始，WEB-INF路径下的web.xml文件不再是必须的，但通常还是建议保留该配置文件。

Servlet2.5之前，Java Web应用的绝大部分组件都通过web.xml文件来配置管理，从servlet3.0开始，也可以通过注解来配置管理wb组件，因此web.xml文件可以变得更简洁。

每个Web容器都会提供一个系统的web.xml文件，用于描述所有web应用共同的配置属性。例如Tomcat的系统web.xml放在Tomcat的conf路径下，而Jetty的系统web.xml文件放在Jetty的etc路径下，文件名为webdefault.xml。

web.xml配置文件的内容主要包括：

1. 配置JSP
2. 配置和管理Servlet
3. 配置和管理Listener
4. 配置和管理Filter
5. 配置标签库

6. 配置JSP属性
   除此之外，web.xml还负责配置，管理如下常用内容：

7. 配置和管理JAAS授权认证

8. 配置和管理资源医用
9. web应用首页

web.xml文件的根元素是元素，在Servlet3.0规范中，该元素新增了如下属性：
metadata-complete:该属性接受true和false两个属性值。当该属性值为true时，该web应用将不会加载注解配置的web组件（如servlet、Filter、Listener等）

在web.xml文件中配置首页使用welcome-file-list元素，该元素能包含多个welcom-file子元素，其中每个welcom-file子元素配置一个首页。

    file-list>
        file>/index.htmlfile>
        file>/index.jspfile>
    file-list>

上面的配置信息指定该web应用的首页依次是index.html、index.jsp。

web.xml中配置前端控制器示例如下：

<servlet>
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
        <async-supported>true</async-supported>
    </servlet>
    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

contextConfigLocation配置Spring MVC加载的配置文件（配置处理器映射器、处理器适配器等）
如果不配置，默认加载的是/WEB-INF/servlet名称-servlet.xml，如springmvc-servlet.xml。

<param-value>classpath:spring-mvc.xmlparam-value>

指定配置文件的配置。

<url-pattern>有两种配置方式。

第一种*.action 访问以.action结尾由DispatcherServlet解析
第二种 / 表示所有访问的地址都由DispatcherServlet解析，对于静态文件的解析需要配置不让 DispatcherServlet解析，使用此方式可以实现RESTful风格的url

如果web应用需要额外加载配置文件，可以如下的配置方式导入所需的配置文件

<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml,classpath:spring-property.xml</param-value>
</context-param>

filter的配置如下：

  <filter>
        <filter-name>UserValidateFilterfilter-name>
        <display-name>UserValidateFilterdisplay-name>
        <filter-class>org.springframework.web.filter.DelegatingFilterProxyfilter-class>
        <init-param>
            <param-name>targetBeanNameparam-name>
            <param-value>userValidateFilterBeanparam-value>
        init-param>
    filter>
    <filter>
        <filter-name>WebAccessAuthorizeFilterfilter-name>
        <display-name>UserValidateFilterdisplay-name>
        <filter-class>org.springframework.web.filter.DelegatingFilterProxyfilter-class>
        <init-param>
            <param-name>targetBeanNameparam-name>
            <param-value>webAccessAuthorizeFilterBeanparam-value>
        init-param>
    filter>


    

    <filter-mapping>
        <filter-name>UserValidateFilterfilter-name>
        <url-pattern>/pages/*url-pattern>
        <url-pattern>*.dourl-pattern>
    filter-mapping>
    <filter-mapping>
        <filter-name>WebAccessAuthorizeFilterfilter-name>
        <url-pattern>/pages/*url-pattern>
        <url-pattern>*.dourl-pattern>
    filter-mapping>

    <filter>
        <filter-name>encodingFilterfilter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
        <async-supported>trueasync-supported>
        <init-param>
            <param-name>encodingparam-name>
            <param-value>UTF-8param-value>
        init-param>
    filter>
    <filter-mapping>
        <filter-name>encodingFilterfilter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>

listener的配置如下：

<listener> 
    <listener-class>org.springframework.web.context.ContextLoaderListenerlistener-class>
listener>

    
<listener>
    <listener-class>org.springframework.web.util.IntrospectorCleanupListenerlistener-class>
listener>

下面说说spring-mvc.xml的配置

mvc:annotation-driven> 

可以代替注解映射器和适配器配置，它默认加载很多的参数绑定方法，比如json转换解析默认加载了。

//在dispatch-content.xml配置打开允许矩阵请求格式
<mvc:annotation-driven enable-matrix-variables="true">
</mvc:annotation-driven>  

对于注解的handler可以单个配置，但一个个配置比较麻烦，则可以使用组件扫描，扫描controller，service，component组件…，指定扫描的包

<context:component-scan base-package="cn.crystal.springdemo.controller" />

文件配置示例

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:cache="http://www.springframework.org/schema/cache"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans  
                            http://www.springframework.org/schema/beans/spring-beans-4.2.xsd  
                            http://www.springframework.org/schema/context  
                            http://www.springframework.org/schema/context/spring-context-4.2.xsd  
                            http://www.springframework.org/schema/mvc  
                            http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd
                            http://www.springframework.org/schema/cache 
                            http://www.springframework.org/schema/cache/spring-cache-4.2.xsd">


    
    <context:component-scan base-package="cn.crystal.crsweb.controller" />

    
    <bean id="handlerMapping"
        class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
    bean>

    
    <bean id="handlerAdapter"
        class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="messageConverters">
            <list>
                <ref bean="customJsonHttpMessageConverter" /> 
                <bean
                    class="org.springframework.http.converter.StringHttpMessageConverter"> 
                    <property name="writeAcceptCharset" value="false">property> 
                bean>
            list>
        property>
    bean>


    
    <mvc:resources mapping="/js/**" location="/js/" /> 
    <mvc:resources mapping="/css/**" location="/css/" />

    
    <mvc:annotation-driven enable-matrix-variables="true" />
    

    <mvc:default-servlet-handler />

    
    <bean
        class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        
        <property name="prefix" value="/pages/" />
        <property name="suffix" value=".jsp" />
    bean>

    
    <bean id="customJsonHttpMessageConverter"
        class="com.crystal.crsweb.controller.converter.GbMappingJackson2HttpMessageConverter">
    bean>
beans>