由于早期的Spring MVC不能很好地处理静态资源,所以在web.xml中配置DispatcherServlet的请求映射,往往使用 .htm 、.do、.action 等方式,以避免拦截controller请求时又拦截了静态资源,这就决定了请求URL必须是一个带后缀的URL。而REST风格的资源URL不希望带 .htm 、.do、.action 等后缀,因而传统的web.xml配置无法采用真正的REST风格的URL。
如果将DispatcherServlet请求映射配置为 '/' 时(REST风格),官方文档对<url-pattern>/</url-pattern>的解释见下图:
将DispatcherServlet请求映射配置为 '/' 后,则Spring MVC将捕获Web容器所有不带后缀的请求和CSS/JS/image等静态资源的请求,Spring MVC会将它们当成一个普通请求处理,因此找不到对应处理器将导致错误。"
如何让Spring MVC既能捕获所有url的请求,又能将静态资源的请求转由web容器处理,是可将DispatcherServlet的请求映射配置为"/"的前提。由于REST是Spring3.0最重要的功能之一,所以Spring团队很看重静态资源处理这项任务,给出了几种解决方案。
方式1:使用spring提供的mvc:resources(适用于spring3.0.4以后版本)
web.xml:
<servlet-mapping>
<servlet-name>spring</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>spring</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring/spring-mvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
<async-supported>true</async-supported>
</servlet>
spring-mvc.xml:
<mvc:annotation-driven />
<mvc:resources location="/static/js/" mapping="/js/**"/>
<mvc:resources location="/static/img/" mapping="/img/**"/>
<mvc:resources location="/static/css/" mapping="/css/**"/>
... ...
方式2:使用defaultServlet处理静态文件
web.xml:
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.jpg</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.css</url-pattern>
</servlet-mapping>
... ...
方式3:<mvc:default-servlet-handler />
web.xml:
<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
spring-mvc.xml:
<mvc:default-servlet-handler />
在springMVC-servlet.xml中配置<mvc:default-servlet-handler />后,会在Spring MVC上下文中定义一个org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler,它类似一个检查员,对进入DispatcherServlet的URL进行筛查,如果发现是静态资源的请求,就将该请求转由Web应用服务器默认的Servlet处理,如果不是静态资源的请求,才由DispatcherServlet继续处理。且<mvc:default-servlet-handler />一定要写在<servlet-mapping>后面,否则controller请求都会被当成静态资源导致报404错误。
注意:
1)<url-pattern>/</url-pattern>不要写成<url-pattern>/*</url-pattern>,/*会拦截所有的请求
2)配置为<url-pattern>/XX/*</url-pattern>时,视图名 和 静态资源存放的路径 最好不要有一致的部分,如:
视图映射:/XX/*
静态路径:webapp/XX/NewFile.html