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"/>

赞赏

感谢鼓励