SpringMVC访问静态文件的三种方式

最新推荐文章于 2024-08-14 17:43:49 发布

Java小宝

最新推荐文章于 2024-08-14 17:43:49 发布

阅读量1.3k

点赞数

如何你的DispatcherServlet配置的是拦截 *.do或者.action这样的URL，就不存在访问不到静态资源的问题。

如果你的DispatcherServlet为了实现restful风格的URL，配置的是拦截“/”，拦截了所有的请求，这样同时对*.js,*.jpg的访问也就被拦截了。

那么我们就需要解决这个问题，可以正常访问静态文件，不要找不到静态文件报404。

方案一：激活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>

要配置多个，每种文件配置一个
要写在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

<mvc:resources 的使用方法：

<mvc:resources mapping="/images/**" location="/images/" />
/images /**映射到 ResourceHttpRequestHandler 进行处理，location指定静态资源的位置.可以是webapps根目录下、jar包里面，这样可以把静态资源压缩到jar包中。还有cache-period 属性可以使得静态资源进行web cache 。

如果出现下面的错误，可能是没有配置 <mvc:annotation-driven /> 的原因。请自行配置好
报错WARNING: No mapping found for HTTP request with URI [/mvc/user/findUser/lisi/770] in DispatcherServlet with name 'springMVC'

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

方案三，使用<mvc:default-servlet-handler/>（推荐）

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

补充说明：多个HandlerMapping的执行顺序问题：
DefaultAnnotationHandlerMapping 的 order 属性值是：0
<mvc:resources/ >自动注册的 SimpleUrlHandlerMapping 的 order 属性值是： 2147483646
<mvc:default-servlet-handler/>自动注册的 SimpleUrlHandlerMapping 的 order 属性值是：2147483647
spring 会先执行 order 值比较小的。当访问一个 a.jpg 图片文件时，先通过 DefaultAnnotationHandlerMapping 来找处理器，一定是找不到的，我们没有叫 a.jpg 的 Action。再按 order 值升序找，由于最后一个 SimpleUrlHandlerMapping 是匹配 "/**" 的，所以一定会匹配上，再响应图片。
访问一个图片，还要走层层匹配，性能会差一些。

最后再说明一下，如果你的 DispatcherServlet 拦截 *.do 或者.action这样的 URL，就不存上述问题了。