小白:spring mvc 对静态资源放行是如何做的

有小伙伴私信说他最近自己在鼓捣spring mvc小项目,但是框架搭起来后无法解决静态文件读取问题,我就整理了一下在spring mvc访问静态资源的几种方式

首先为什么会读取不到静态资源?

如果你的DispatcherServlet拦截 *.do这样的URL,就不存在访问不到静态资源的问题。如果你的DispatcherServlet拦截“/”,拦截了所有的请求,同时对*.js,*.jpg的访问也就被拦截了,这就是问题原因。web.xml下对spring的DispatcherServlet请求url映射的配置,原配置如下:

<servlet>
<servlet-name>spring/<servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet/<servlet-class>
<load-on-startup>1/<load-on-startup>
/<servlet>
<servlet-mapping>
<servlet-name>spring/<servlet-name>
<url-pattern>//<url-pattern>
/<servlet-mapping>

分析原因:<servlet-mapping>的<url-pattern>//<url-pattern>把所有的请求都交给spring去处理了,而所有available的请求url都是在Constroller里使用类似@RequestMapping(value = "/login/{user}", method = RequestMethod.GET)这样的注解配置的,这样的话对js/css/jpg/gif等静态资源的访问就会得不到。/<servlet-mapping>

所以我们的的目的:可以正常访问静态文件,不要找不到静态文件报404。

方案一:激活Tomcat的defaultServlet来处理静态文件

在web.xml里添加如下配置

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

要配置多个,每种文件配置一个。

要写在DispatcherServlet的前面, 让defaultServlet先拦截,这个就不会进入Spring了,性能应该是最好的吧。

Tomcat, Jetty, JBoss, and GlassFish 默认 Servlet的名字 -- "default"

Google App Engine 默认 Servlet的名字 -- "_ah_default"

Resin 默认 Servlet的名字 -- "resin-file"

WebLogic 默认 Servlet的名字 -- "FileServlet"

WebSphere 默认 Servlet的名字 -- "SimpleFileServlet"

方案二: 在spring3.0.4以后版本提供了mvc:resources

<resources> 的使用方法:/<resources>

<resources> 

/images /**映射到 ResourceHttpRequestHandler 进行处理,location指定静态资源的位置.可以是web application根目录下、jar包里面,这样可以把静态资源压缩到jar包中。cache-period可以使得静态资源进行web cache。

如果出现下面的错误,可能是没有配置 <annotation-driven> 的原因。

报错WARNING: No mapping found for HTTP request with URI [/mvc/user/findUser/lisi/770] in DispatcherServlet with name 'springMVC'

使用 <resources> 元素,把 mapping 的 URI 注册到 SimpleUrlHandlerMapping的urlMap 中,key 为 mapping 的 URI pattern值,而value为 ResourceHttpRequestHandler,这样就巧妙的把对静态资源的访问由 HandlerMapping 转到ResourceHttpRequestHandler 处理并返回,所以就支持 classpath 目录, jar 包内静态资源的访问.另外需要注意的一点是,不要对 SimpleUrlHandlerMapping 设置 defaultHandler. 因为对 static uri 的 defaultHandler 就是ResourceHttpRequestHandler,否则无法处理static resources request.

mapping:映射

location:本地资源路径,注意必须是webapp根目录下的路径。

两个*,它表示映射resources/下所有的URL,包括子路径(即接多个/)

配置的location一定要是webapp根目录下才行,如果你将资源目录,放置到webapp/WEB-INF下面的话,则就会访问失败。这个问题常常会犯。

错误方式:

小白:spring mvc 对静态资源放行是如何做的

WEB-INF目录作用

WEB-INF是Java的WEB应用的安全目录。所谓安全就是客户端无法访问,只有服务端可以访问的目录。

如果想在页面中直接访问其中的文件,必须通过web.xml文件对要访问的文件进行相应映射才能访问。

当然,你非要放在WEB-INF中,则必须修改resources映射,如:

<resources>

推荐方式:maven项目的目录结构为如下图所示。

小白:spring mvc 对静态资源放行是如何做的

方案三 ,使用<default-servlet-handler>

<default-servlet-handler>会把 "/**" url,注册到 SimpleUrlHandlerMapping 的 urlMap 中,把对静态资源的访问由 HandlerMapping 转到 org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler 处理并返回.DefaultServletHttpRequestHandler 使用就是各个 Servlet 容器自己的默认 Servlet.

补充说明:多个HandlerMapping的执行顺序问题:

DefaultAnnotationHandlerMapping 的 order 属性值是:0

<resources>自动注册的 SimpleUrlHandlerMapping 的 order 属性值是: 2147483646/<resources>

<default-servlet-handler>自动注册的 SimpleUrlHandlerMapping 的 order 属性值是:2147483647

spring 会先执行 order 值比较小的。当访问一个 a.jpg 图片文件时,先通过 DefaultAnnotationHandlerMapping 来找处理器,一定是找不到的,我们没有叫 a.jpg 的 Action。再按 order 值升序找,由于最后一个 SimpleUrlHandlerMapping 是匹配 "/**" 的,所以一定会匹配上,再响应图片。


分享到:


相關文章: