对于spring的初学者,在采用Spring MVC框架进行web开发,会经常遇到,页面请求或跳转时,无法引用到js,css,jgp等静态文件,表现出来的就是,页面该有的样式无法正常显示出来。究其原因,在进行spring mvc配置时,我们通常会配置一个dispatcherServlet处理相应的请求,dispatcherServlet是根据配置的url映射规则,去进行请求的拦截处理。配置如下:
<servlet>
<servlet-name>spring-mvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServelt</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>spring-mvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
以上配置表示,名为spring-mvc的servlet,会对所有请求进行拦截处理。
解决方法
(1)激活tomcat的defaultServlet来处理静态文件
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.jpg</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.css</url-pattern>
</servlet-mapping>
(2)<mvc:resource location='/static/' mapping='/static/**'>
/static/**映射到ResourceHttpRequestHandler进行处理,location指定静态文件的位置,可以是web application根目录下,classpath下,jar包里里面,这样可以把静态资源压缩到jar中。并可以使用cache-period进行静态资源的缓存。
使用<mvc:resources/>元素,把mapping的URI注册到SimpleUrlHandlerMapping的urlMap中,key为mapping的URI pattern值,而value为ResouceHttpRequestHandler,这样就巧妙的把静态资源的访问由HandlerMapping转到SimpleUrlHandlerMapping处理并返回,所以就支持classpath目录,jar内静态资源的访问。另外值得注意的是,不要对SimpleUrlHandlerMapping设置defaultHandler,因为处理static uri的defaultHandler就是ResourceHttpRequestHandler,否则无法处理static resources request.
(3)<mvc:defaul-servlet-handler>
<default-servlet-handler>会把"/*"url注册到SimpleUrlHandlerMapping的urlMap中,把静态资源的访问由HandlerMapping转到org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler处理并返回。DefaultServletHttpRequestHandler使用的就是各个Servlet容器自己默认的Servlet.
当配置了多个HandlerMapping时,Spring执行其的顺序问题:
DefaultAnnotationHandlerMapping的order属性值是:0
<mvc:resources>自动注册的SimpleUrlHandlerMapping的order属性是:2147483646
<mvc:default-servlet-handler/>自动注册的SimpleUrlHandlerMapping的order属性值是:2147483647.
spring在执行HandlerMapping时,会按照order值从小到大的顺序执行。