SpringMVC - 处理静态资源 (转)

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

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

解决办法：

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

<mvc: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. 

/*使用<mvc:annotation-driven/>标签或者设置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.

解释如下：

<mvc:default-servlet-handler/>将在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说明最后一段话如下：

/*使用<mvc:annotation-driven/>标签或者设置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.

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

常用的解决方式为配置<mvc:annotation-driven />标签，详情点击查看请求映射失效。

点击查看controller映射失效

---

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

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

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

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

<bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">
      <!-- Shiro的核心安全接口,这个属性是必须的 -->
      <property name="securityManager" ref="securityManager"/>
      <!-- loginUrl认证提交地址，如果没有认证将会请求此地址进行认证，请求此地址将由formAuthenticationFilter进行表单认证 -->
      <property name="loginUrl" value="/login"/>

      <!-- Shiro连接约束配置,即过滤链的定义 -->
      <property name="filterChainDefinitions">
          <value>
              <!-- /** = anon所有url都可以匿名访问 -->
              <!-- 对静态资源设置匿名访问 -->
              /images/** = anon
              /js/** = anon
              /styles/** = anon
              <!-- 验证码，可匿名访问 -->
              /validateCode = anon  <!--验证码-->
              /doLogin = anon

              <!-- /** = authc 所有url都必须认证通过才可以访问 -->
              /**=authc
              <!--请求logout，shrio擦除sssion-->
              /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.

 * <p>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的问题。

<mvc:view-controller/>直接访问view-name对应的jsp

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

<!-- mvc:view-controller可使其直接访问路径 -->  
<mvc:view-controller path="/i18n" view-name="i18n"/>

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