SpringMVC中单独配置<mvc:default-servlet-handler/> 导致 Controller失效

简介: SpringMVC中单独配置<mvc:default-servlet-handler/> 导致 Controller失效

① 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,将提示如下

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

<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和HandlerMappin

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



9.png


<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, 可以直接找到并解析的原因了.


目录
相关文章
|
4月前
|
设计模式 前端开发 Java
了解 Spring MVC 架构、Dispatcher Servlet 和 JSP 文件的关键作用
Spring MVC 是 Spring 框架的一部分,是一个 Web 应用程序框架。它旨在使用 Model-View-Controller(MVC) 设计模式轻松构建Web应用程序。
63 0
|
4月前
|
前端开发 安全 Java
SpringMVC基础篇:第一个MVC程序和细节分析
SpringMVC基础篇:第一个MVC程序和细节分析
|
18天前
|
前端开发 Java 应用服务中间件
Springboot对MVC、tomcat扩展配置
Springboot对MVC、tomcat扩展配置
|
4月前
|
前端开发 Java 应用服务中间件
SpringMVC基础篇:MVC基础知识
vSpringMVC基础篇:MVC基础知识
|
3天前
|
设计模式 存储 前端开发
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式
|
30天前
|
前端开发 JavaScript Java
MVC框架:SpringMVC(三)
MVC框架:SpringMVC
30 0
|
30天前
|
JSON 前端开发 JavaScript
MVC框架:SpringMVC(二)
MVC框架:SpringMVC
37 0
|
30天前
|
前端开发 Java 应用服务中间件
MVC框架:SpringMVC(一)
MVC框架:SpringMVC
60 0
|
2月前
spring3 springfox报错Type javax.servlet.http.HttpServletRequest not present
spring3 springfox报错Type javax.servlet.http.HttpServletRequest not present
42 0
|
2月前
|
Java 应用服务中间件 数据库连接
Spring5源码(51)-Servlet知识点回顾以及SpringMVC分析入口
Spring5源码(51)-Servlet知识点回顾以及SpringMVC分析入口
36 0