SpringMVC - 处理静态资源的几种方式

【1】第一种示例与解决办法

将DispatcherServlet请求映射设置为 / ，将会拦截所有的请求。不能访问静态资源。

解决办法：

在SpringMVC的配置文件中配置如下标签解决

default-servlet-handler/>

其XSD文档说明如下：

/*配置一个handler通过转发请求到servlet容器的默认servlet来处理静态资源*/
Configures a handler for serving static resources by forwarding to the Servlet container's default Servlet.

/*使用该handler将会允许DispatcherServlet 的url-pattern为'/';同时使用servlet容器的默认servlet处理静态资源*/
Use of this handler allows using a "/" mapping with the DispatcherServlet 
while still utilizing the Servlet container to serve static resources. 

/*该handler将会转发所有请求到默认servlet*/
This handler will forward all requests to the default Servlet. 

/*因此将该handler的执行顺序放到所有请求处理的最后是非常重要的！！！*/
Therefore it is important that it remains last in the order of all other URL HandlerMappings. 

/*使用标签或者设置HandlerMapping instance的order来确保DefaultServletHttpRequestHandler的order最大。*/
That will be the case if you use the "annotation-driven" element 
or alternatively if you are setting up your customized HandlerMapping instance 
be sure to set its "order" property to a value lower than 
that of the DefaultServletHttpRequestHandler, which is Integer.MAX_VALUE.

解释如下：

将在SpringMVC的上下文中定义一个DefaultServletHttpRequestHandler来处理静态资源(其实就是将请求转发给默认的servlet)。

一般WEB服务器默认的servlet的名称为default。若所使用的WEB服务器默认的Servlet名称不是default，则需要通过default-servlet-name 属性指定！

---

不同服务器下默认servlet名字对应如下：

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

---

【Tips：】

使用上述配置，你会发现正常的Controller跳转失效了！

XSD说明最后一段话如下：

/*使用标签或者设置HandlerMapping instance的order来确保DefaultServletHttpRequestHandler的order最大。*/
That will be the case if you use the "annotation-driven" element 
or alternatively if you are setting up your customized HandlerMapping instance 
be sure to set its "order" property to a value lower than 
that of the DefaultServletHttpRequestHandler, which is Integer.MAX_VALUE.

也就是说，要么配置标签，要么手动注册请求映射处理bean于xml中，并设置order属性值，以其实现框架中处理请求映射的bean的order值小于DefaultServletHttpRequestHandler的order属性值！！！

常用的解决方式为配置标签，详情点击查看请求映射失效。

点击查看controller映射失效

---

【2】第二种示例与解决办法

解决静态资源的思路是，在SpringMVC.xml中，拦截设置为”*.do”，而不是”/”。

这样就不会拦截静态资源的请求。

需要注意的是，如果项目中用到了shiro或者其他权限框架。那么需要注意你的shiro.xml配置，示例如下：

  <bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">
        
        <property name="securityManager" ref="securityManager"/>
        
        <property name="loginUrl" value="/login"/>

        
        <property name="filterChainDefinitions">
            <value>
                
                
                /images/** = anon
                /js/** = anon
                /styles/** = anon
                
                /validateCode = anon  
                /doLogin = anon

                
                /**=authc
                
                /logout=logout
            value>
        property>
    bean>

需要注意的是虽然SpringMVC拦截的是.do，但是由于使用了shiro(或者你的其他权限框架)，那么未登录情况下是不能直接访问除shiro配置文件里面允许匿名访问的路径之外的静态资源文件。

举个例子，你把静态资源文件放在了项目根目录，但是参考上面配置文件，显然不在匿名访问路径列表之内，所以会提示你先登录，登录之后才可访问项目根目录的静态资源文件。

• 未登录前访问项目根目录下1.jpg , 跳到登录页面：

• 登录后访问项目根目录下1.jpg :

另外，建议最好参考shiro配置文件，比如1.jpg放到images文件夹下，那么不用登录就可以直接访问。

---

【3】第三种示例与解决办法

通过配置，避免静态资源被拦截，示例如下：

 
    <mvc:resources location="/js/" mapping="/js/**"/>
    <mvc:resources location="/css/" mapping="/css/**"/>
    <mvc:resources location="/images/" mapping="/images/**"/>
    <mvc:resources location="/bootstrap/" mapping="/bootstrap/**"/>

该标签的xsd说明文档如下：

/*配置handler为静态资源，如images，js和CSS文件并进行缓存头优化，以便在Web浏览器中高效加载。*/
Configures a handler for serving static resources such as 
images, js, and, css files with cache headers optimized for efficient loading in a web browser. 
/*允许为任何可以通过spring处理的路径资源提供服务*/
Allows resources to be served out of any path that is reachable via Spring's Resource handling.

注册的handler如下：

org.springframework.web.servlet.resource.ResourceHttpRequestHandler

即，该标签注册ResourceHttpRequestHandler为静态资源的访问提供服务。

该handler的javadoc如下所示：

{@code HttpRequestHandler} that serves static resources in an optimized way according to the guidelines of Page Speed, YSlow, etc.

 * 
The {@linkplain #setLocations "locations"} property takes a list of Spring
 * {@link Resource} locations from which static resources are allowed to
 * be served by this handler. Resources could be served from a classpath location,
 * e.g. "classpath:/META-INF/public-web-resources/", allowing convenient packaging
 * and serving of resources such as .js, .css, and others in jar files.

---

【4】第四种示例与解决办法

确切说这里只解决不通过controller而直接访问jsp的问题。

直接访问view-name对应的jsp

• jsp路径依据视图解析器配置。

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

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

---

【5】第五种示例与解决办法

在web.xml中作手动配置default servlet映射如下：

    <servlet-mapping>
        <servlet-name>defaultservlet-name>
        <url-pattern>*.cssurl-pattern>
    servlet-mapping>
    <servlet-mapping>
        <servlet-name>defaultservlet-name>
        <url-pattern>*.gifurl-pattern>
    servlet-mapping>
    <servlet-mapping>
        <servlet-name>defaultservlet-name>
        <url-pattern>*.mp4url-pattern>
    servlet-mapping>
    <servlet-mapping>
        <servlet-name>defaultservlet-name>
        <url-pattern>*.pngurl-pattern>
    servlet-mapping>
    <servlet-mapping>
        <servlet-name>defaultservlet-name>
        <url-pattern>*.jpgurl-pattern>
    servlet-mapping>
    <servlet-mapping>
        <servlet-name>defaultservlet-name>
        <url-pattern>*.jsurl-pattern>
    servlet-mapping>
    <servlet-mapping>
        <servlet-name>defaultservlet-name>
        <url-pattern>*.htmlurl-pattern>
    servlet-mapping>