① DispatcherServlet的映射为​​/​​

如果在spring-mvc.xml 拦截方式如下配置(也就是覆盖容器的默认Servlet的映射)：

<servlet>
    <servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 可以自定义servlet.xml配置文件的位置和名称，默认为WEB-INF目录下，名称为[<servlet-name>]-servlet.xml，如spring-servlet.xml
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring-servlet.xml</param-value>&nbsp; 默认
    </init-param>
    -->
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>spring</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>
 //...

② ​​<mvc:default-servlet-handler/>​​解决静态资源访问

如果①中配置实例，那么所有的请求都会被拦截,包括静态资源。

  • ​​'/'​​​ 将会替换掉容器的​​default servlet​​, 将会处理所有其他handler(Servlet)都不处理的访问请求.
  • 如果web.xml没有配置其他特殊路径的servlet, 基本上所有的请求都交由DispatcherServlet处理.
  • 将不会再访问容器中原始默认的servlet(你对静态资源的访问就是通过容器默认servlet处理的)，故而静态资源将不可访问！

例如此时访问vue.js，将提示如下
SpringMVC中单独配置＜mvc:default-servlet-handler/＞ 导致 Controller失效_xml

如果想要解决访问静态资源问题，通常会配置如下标签：

<mvc:default-servlet-handler/>

该标签的xsd文档说明如下：

  • 配置一个handler(​​DefaultServletHttpRequestHandler​​)通过转发到servlet容器的默认servlet来处理静态资源
  • 使用该handler允许​​DispatcherServlet​​​ 的​​url-pattern​​​ 为​​'/'​​，同时仍然使用Servlet容器让其去处理静态资源
  • 该handler将会转发所有的请求到Servlet容器的​​default serlvet​​
  • 因此，它在所有其他URL HandlerMappings的顺序中保持最后一个是很重要的
  • 你可以使用两种方式去保证你的​​handler mapping 的order​​​属性值小于​​DefaultServletHttpRequestHandler​​​ 对应的​​handler mapping​​的order属性值：使用​​<mvc:annotation-driven/>​​标签或者手动配置​​HandlerMapping​​实例并设置其​​order​​属性值
  • 请确保将其order属性设置为低于​​DefaultServletHttpRequestHandler​​​的值，即​​Integer.MAX_VALUE​​。

③ Controller失效

新的问题出现了，你会发现以前的Controller不能访问了！那么为什么会出现这个情况？​​default-servlet-handler​​​将在SpringMVC上下文中定义一个​​DefaultServletHttpRequestHandler​​。

DefaultServletHttpRequestHandler的javadoc：

  • 使用servlet容器的​​default servlet​​处理静态资源
  • 当​​DispatcherServlet url-pattern为 ‘/’​​​时(其会覆盖Servlet容器对静态资源的默认 处理)，该handler将会使用​​‘/*’​​去匹配请求路径。
  • 到该处理程序的映射通常应作为链中的最后一个进行排序，以便它仅在无法匹配其他更具体的映射（例如controller）时执行。

即，当​​DispatcherServlet url-pattern为 ‘/’​​​时，该handler将会使用‘​​/*​​​’去匹配请求路径。参考servlet的url-pattern规则​可知 ​​'/*'​​​可以拦截一切请求。因为​​'/'​​​将servlet定义为默认serlvet，在没有精确匹配servlet出现前，'​​/*'​​将拥有最高的优先级。

这是很严重的，​​/*​​​可以拦截路径和资源型的请求，并转发到默认的serlvet。也就是说，静态资源此时可以由​​默认default servlet​​​进行处理，但是​​default servlet​​不能处理你的业务请求(mapping)。

所以，需要保证该handler对应的handler mapping在执行顺序中为最后！

  • 使用​​<mvc:annotation-driven/>​​标签
  • 手动配置​​HandlerMapping​​​实例并设置其​​order​​​属性值使其小于​​DefaultServletHttpRequestHandler​​​的值，即​​Integer.MAX_VALUE​​

④ ​​<mvc:annotation-driven />​​解决controller失效

解决办法：配置下面标签

<mvc:annotation-driven />

至于为什么这样解决，查看​​<mvc:default-servlet-handler/>​​的xsd说明文档就明白了。

⑤ 不同情况下的HandlerAdapter、HandlerExceptionResolver和HandlerMapping

在springmvc.xml中，经常会配置​​<mvc:annotation-driven/>和<mvc:default-servlet-handler/>​​。那么它们所带来的影响呢？

类

都不配置

仅配置​​<mvc:default-servlet-handler/>​​

仅配置​​<mvc:annotation-driven/>​​

都配置

HttpRequestHandlerAdapter

有

有

有

有

SimpleControllerHandlerAdapter

有

有

有

有

AnnotationMethodHandlerAdapter

有

RequestMappingHandlerAdapter

有

有

ExceptionHandlerExceptionResolver

有

有

AnnotationMethodHandlerExceptionResolver

有

有

ResponseStatusExceptionResolver

有

有

有

有

DefaultHandlerExceptionResolver

有

有

有

有

RequestMappingHandlerMapping

有

有

BeanNameUrlHandlerMapping

有

有

有

有

DefaultAnnotationHandlerMapping

有

SimpleUrlHandlerMapping

有

有

​​<mvc:annotation-driven/>​​注入了:

  • RequestMappingHandlerAdapter(替代了AnnotationMethodHandlerAdapter)，
  • ExceptionHandlerExceptionResolver(替代了AnnotationMethodHandlerExceptionResolver)
  • RequestMappingHandlerMapping(替代了DefaultAnnotationHandlerMapping) 。

其中 ​​AnnotationMethodHandlerAdapter​​​是过期类，​​3.2之后被RequestMappingHandlerAdapter​​替代。

⑥ DispatcherServlet不拦截jsp请求

前面说的当DispatcherServlet配置为’/’, 将会覆盖default servlet, 将会处理所有其他Servlet都不处理的访问请求。所以这里不拦截拦截​​.jsp, .jspx.​​的请求, 一定有其他地方拦截了该请求, 但是仔细查找web.xml并没有发现其他的servlet，那一定是在容器中定义的。

果不其然, 在​​%TOMCAT_HOME%/conf/web.xml​​中继承过来的JspServlet会处理该请求.

该xml配置了两个servlet：

<servlet>
     <servlet-name>default</servlet-name>
     <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
     <init-param>
         <param-name>debug</param-name>
         <param-value>0</param-value>
     </init-param>
     <init-param>
         <param-name>listings</param-name>
         <param-value>false</param-value>
     </init-param>
     <load-on-startup>1</load-on-startup>
 </servlet>
 
<servlet>
     <servlet-name>jsp</servlet-name>
     <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
     <init-param>
         <param-name>fork</param-name>
         <param-value>false</param-value>
     </init-param>
     <init-param>
         <param-name>xpoweredBy</param-name>
         <param-value>false</param-value>
     </init-param>
     <load-on-startup>3</load-on-startup>
 </servlet>

<!-- The mapping for the default servlet -->
 <servlet-mapping>
     <servlet-name>default</servlet-name>
     <url-pattern>/</url-pattern>
 </servlet-mapping>

 <!-- The mappings for the JSP servlet -->
 <servlet-mapping>
     <servlet-name>jsp</servlet-name>
     <url-pattern>*.jsp</url-pattern>
     <url-pattern>*.jspx</url-pattern>
 </servlet-mapping>

这也就是为什么我们直接访问不在​​WEB-INF的jsp​​, 可以直接找到并解析的原因了.