SpringMVC - 静态资源放行

什么是静态资源?

css、js、图片、html等都是静态资源

放行静态资源

1、不使用 springmvc 框架分析

不使用 springmvc 框架,这些静态资源请求都会由 tomcat 的默认的 default 进行处理。

2、使用了 springmvc 框架分析

当配置的 DispatcherServlet 的映射路径不为 / 时,对静态资源的请求最终会由 tomcat 的默认配置来处理,所以不影响静态资源的正常访问。
如果配置的 DispatcherServlet 的映射路径为 / 时,会覆盖掉tomcat的默认的 default 配置,所以需要在 springmvc 文件中进行配置,对静态资源进行放行。

一、在 springmvc.xml 中放行 - 需要开启 <mvc:annotation-driven /> 注解驱动

1、对全部资源放行

在springmvc文件中配置上 <mvc:default-servlet-handler/> ,发出静态资源请求后,请求传到 DispatcherServlet,DispatcherServlet 调用 RequestMappingHandlerMapping 进行映射匹配,匹配不成功,DispatcherServlet 最终会将请求转交给 tomcat 默认 default 进行处理。

<mvc:default-servlet-handler/>

2、对指定目录下的资源放行 - <mvc:resources/>

如果配置了拦截器,需要在拦截器中进行过滤,否则会被拦截;

* 代表一级目录,** 代表多级目录

<mvc:resources location="/css/" mapping="/css/**" />
<mvc:resources location="/js/" mapping="/js/**" />
<mvc:resources location="/fonts/" mapping="/fonts/**" />
<mvc:resources location="/picture/" mapping="/picture/**" />
<mvc:resources location="/admin/" mapping="/admin/**" />

补充说明多个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 是匹 "/**"的,所以一定会匹配上,再响应图片。 

二、在web.xml中放行:

1、在 web.xml 配置前端控制器 DispatcherServlet 的时候指定 url-pattern 以扩展名结尾;例如:*.do,*.html 等;

<servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 
        contextConfigLocation不是必须的, 如果不配置contextConfigLocation, 
        springmvc的配置文件默认找:WEB-INF/servlet的name+"-servlet.xml"
     -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring/springmvc.xml</param-value>
    </init-param>
    <!-- 配置springmvc什么时候启动,参数必须为整数 -->
    <!-- 如果等于0或大于0,则springmvc随服务器的启动而启动 -->
    <!-- 小于0,则在第一次访问的时候启动 -->
    <load-on-startup>1</load-on-startup>
</servlet>
 
<servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <!-- 
        1. /*  拦截所有   jsp  js png .css
        2. *.action *.do 拦截以do action 结尾的请求
        3. /  拦截所有 (不包括jsp) (包含.js .png.css)
     -->
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

2、激活 Tomcat 的 defaultServlet 来处理静态文件

在 web.xml 配置 default servlet-mapping 的 url-pattern ,以目录形式和扩展名形式。要写在DispatcherServlet的前面,让 defaultServlet 先拦截,这个就不会进入Spring了; 

不同的 servlet 容器/应用服务器,处理这些静态资源的 servlet 的名字不大一样: 

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

* 代表一级目录,** 代表多级目录

<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>/admin/*</url-pattern>
    <url-pattern>*.css</url-pattern>
    <url-pattern>*.tff</url-pattern>
    <url-pattern>*.woff</url-pattern>
    <url-pattern>*.js</url-pattern>
    <url-pattern>*.png</url-pattern>
</servlet-mapping>

其他请求不到静态资源的可能原因

一、jsp 或者 html 界面引用 js 文件错误

编写script时没有写完整,有些浏览器还不报错。

错误:<script type="text/javascript" src="${pageContext.request.contextPath }/css/main.min.css" />
正确:<script type="text/javascript" src="${pageContext.request.contextPath }/css/main.min.css"></script>

二、在WEB-INF目录下的静态资源只有服务器能访问,客户端无法直接访问

众所周知,WEB-INF 是被保护的目录,不允许客户端进行访问,这里就涉及两个概念:

请求转发 和 重定向

SpringMVC - 静态资源放行 

请求转发会间接的由服务器去访问WEB-INF,所以可以访问, 

重定向请求静态资源属于客户端进行请求,所以不能访问静态资源。

相关推荐