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


目录
相关文章
|
7月前
|
前端开发 Java 应用服务中间件
Springboot对MVC、tomcat扩展配置
Springboot对MVC、tomcat扩展配置
|
3月前
|
前端开发 Java Spring
关于spring mvc 的 addPathPatterns 拦截配置常见问题
关于spring mvc 的 addPathPatterns 拦截配置常见问题
266 1
|
7月前
|
XML Java 应用服务中间件
Tomcat_servlet部署、编译、配置、打包
Tomcat_servlet部署、编译、配置、打包
108 0
|
6月前
|
XML 数据格式
XML配置Servlet文件,不使用注解配置路径的方法
XML配置Servlet文件,不使用注解配置路径的方法
|
6月前
|
设计模式 前端开发 Java
【Spring MVC】快速学习使用Spring MVC的注解及三层架构
【Spring MVC】快速学习使用Spring MVC的注解及三层架构
96 1
|
5月前
|
前端开发 Java 应用服务中间件
Spring Boot 2.x 嵌入式 Servlet 容器
Spring Boot使用内嵌Tomcat,默认端口8080,可通过`application.properties`配置端口、上下文路径等。配置方式有两种:1) 直接在配置文件中添加`server.port`和`server.servlet.context-path`;2) 创建`WebServerFactoryCustomizer` Bean来自定义配置,如设置端口`factory.setPort(8083)`,这种方式优先级更高。
|
6月前
|
前端开发 Java 关系型数据库
在Spring3 MVC中五步配置集成注解方式Hibernate3
在Spring3 MVC中五步配置集成注解方式Hibernate3
46 3
|
6月前
|
应用服务中间件
Servlet urlPattern配置,和不要在Servlet中配置任何匹配的原因
Servlet urlPattern配置,和不要在Servlet中配置任何匹配的原因
序-Servlet和SpringMVC的联系和区别-配置路径先想好使用的使用的方法,然后匹配的需要的技术
序-Servlet和SpringMVC的联系和区别-配置路径先想好使用的使用的方法,然后匹配的需要的技术
|
7月前
|
设计模式 存储 前端开发
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式