Spring MVC 静态资源的访问

[color=red]问题描述：[/color]
我们在spring mvc框架中为了是URL更符合RESTful风格，通常在web.xml中会配置spring框架servlet 的 url 拦截为 "/" ,也就是拦截所有资源的url请求，这样一来，所有的资源包括， js | css | 图片 | 所有静态资源都将经过框架的servlet拦截。不应该是这样的。所以有了对应servlet的url拦截为“/”的时候，对静态资源访问不应该经过servlet拦截的问题处理。如果 servlet-mapping 的 url-pattern 为 “*.do”,就是只拦截有一定后缀的url，那么就不会有静态资源访问的问题了。


一、spring mvc 下默认访问的三种方式

1>.第一种 访问tomcat容器的默认页面

<welcome-file-list> 
  <welcome-file>/index.html</welcome-file> 
</welcome-file-list>

[color=green]这种方式通常用来访问我们的初始页面[/color]
2>.第二种 spirng mvc 默认index controller 方式
([color=green]如果在tomcat容器没有配置默认页面，怎spring mvc 会主动去寻找/index的controller，如果有则会调用，没有则会显示404页面[/color])

@RequestMapping(value="/index")
public ModelAndView index(HttpServletRequest request, HttpServletResponse response){
       return new ModelAndView("index");
}

3>.第三种 spirng mvc 配置根节点访问“/”方式

@RequestMapping(value="/") 
public ModelAndView index(HttpServletRequest request,HttpServletResponse response){ 
         return new ModelAndView("index"); 
}

或者

<mvc:view-controller path="/" view-name="home"/>

This is a shortcut for defining a ParameterizableViewController that immediately forwards to a view when invoked.

[color=red]※[/color] 三种方法[color=brown]优先级别[/color]是 1>3>2

二、spring mvc 使用RESTFull 的url风格拦截所有资源请求时的静态资源的访问配置，避免被spring mvc框架的匹配，因为这是没有必要的，可恶的。

[color=red]※[/color].如果spring mvc框架的servlet-mapping的url-pattern为 “/” ，若我们没有处理静态资源，就会造成静态资源的访问出现 404

解决方案：
1>.激活web应用服务器（如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>

[color=green]要配置多个，每种文件配置一个
要写在DispatcherServlet的前面， 让defaultServlet先拦截，这个就不会进入Spring了，可能性能是最好的。[/color]

Tomcat, Jetty, JBoss, and GlassFish 默认 Servlet的名字 -- "default"
Google App Engine 默认 Servlet的名字 -- "_ah_default"
Resin 默认 Servlet的名字 -- "resin-file"
WebLogic 默认 Servlet的名字 -- "FileServlet"
WebSphere 默认 Servlet的名字 -- "SimpleFileServlet"

2>.在spring3.0.4以后版本提供了 <mvc:resources />

<mvc:resources mapping="/static/**" location="/static/" />

/static/**映射到 ResourceHttpRequestHandler进行处理，location指定静态资源的位置.可以是web application根目录下、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.

3>.使用<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 是匹配"/**"的，所以一定会匹配上，再响应图片。

[color=red]※[/color] [color=green]加载一个静态资源是却要经过框架servlet的层层pattern，不必要的性能开销。[/color]
[color=red]最后还是特别强调，像一开始说的，如果框架servlet的url-pattern是指定后缀的，如 “*.go” ,那么框架的url拦截就只会匹配后缀带 .go 的request，就不会有静态资源访问的问题了。[/color] 阅读更多