springmvc配置静态资源

跟着传智的视频在做那个淘淘商城的项目，做到第二天，发现自己以前学习的SSM框架还有一些东西没有完全弄懂，很多东西只是会用，但是完全不知道为什么而用，通过这个项目练手，也是对SSM框架的一种补充。

今天就来说一说如何在一个SSM框架中配置访问静态资源的问题。

首先，必须要有一个SSM环境呗，这里我就以淘淘商城为例子。

贴一下web.xml的配置：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    version="2.5">
    <display-name>taotao-manager-web</display-name>
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>
    <!-- 配置dispatcherservlet -->
    <!-- url拦截形式 -->
    <!-- 加载springmvc -->
    <!-- springmvc的前端控制器 -->
    <servlet>
        <servlet-name>taotao-manager-web</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>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>taotao-manager-web</servlet-name>
        <!-- /*表示拦截所有，包括转发的JSP页面  这是错误的，不能用 -->
        <!-- /表示拦截所有的静态资源，不包括转发的JSP -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <filter>
        <filter-name>CharacterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>utf-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>CharacterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>

可以看到在spring前端控制器DispatcherServlet中配置的是 / 拦截规则，这里配置 / 的意思是说，所有的请求都需要经过前端控制器，自然也会拦截所有的css、jsp、js等静态资源。注意千万不能配置成 /* 否则包括jsp在内的静态资源的请求都会被拦截。

这个时候如果你在spring的配置文件中没有配置静态资源拦截的话那么就会出现诸如css、js文件加载不出来的问题，你需要在springmvc.xml文件中加上<mvc:default-servlet-handler/>这样一句。

springmvc.xml:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:dubbo="http://code.alibabatech.com/schema/dubbo" 
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd
        http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd
        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd
        ">
    <context:component-scan base-package="com.taotao.controller" />
   <!-- 这里配置使用servlet默认的静态资源处理方式-->
    <mvc:default-servlet-handler/>
    <mvc:annotation-driven />
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/" />
        <property name="suffix" value=".jsp" />
    </bean> 
    <!-- 引用dubbo -->
    <dubbo:application name="taotao-manager-web" />
    <dubbo:registry protocol="zookeeper" address="192.168.25.128:2181" />
    <dubbo:reference interface="com.taotao.service.TestService" id="testService" />
    <dubbo:reference interface="com.taotao.service.ItemService" id="itemService" />
</beans>

在注释处使用了默认的servlet静态资源处理方式，这样就是说让tomcat自己处理，如果你是这样配置的话。那么会很麻烦，因为你所有的请求都会被springmvc捕捉，然后传递请求到controller，你需要写一个页面跳转控制器

PageController.java:

package com.taotao.controller;
/**
 * 
 * @author Administrator
 *
 */

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class PageController {
    
    @RequestMapping("/")
    public String showIndex() {
        return "index";
    }
    
    @RequestMapping("/{page}")
    public String showPage(@PathVariable String page) {
        
        return page;
    }
}

有了这个之后，你在访问静态jsp的时候可以使用 /page名 的方式来访问，css、img资源也会正常的加载。也就是说你请求jsp的话就是通过这个controller来进行跳转的。这里需要springmvc的视图解析器配置正确。

但是不推荐这种，因为需要访问controller，耗费时间。推荐在springmvc中这样修改。

springmvc.xml:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:dubbo="http://code.alibabatech.com/schema/dubbo" 
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd
        http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd
        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd
        ">

    <context:component-scan base-package="com.taotao.controller" />
    <mvc:annotation-driven />
    <bean
        class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/" />
        <property name="suffix" value=".jsp" />
    </bean> 
    <!-- 配置静态资源映射 -->
    <!-- 指定/WEB-INF/js  /WEB-INF/css/ 下的所有的静态资源包括子目录下的静态资源  都不被拦截 -->
    <!-- mapping = /js/**   表示访问静态资源的路劲的形式  可以访问/js/下的所有子目录下的资源 -->
        <mvc:resources location="/WEB-INF/js/" mapping="/js/**"/>
        <mvc:resources location="/WEB-INF/css/" mapping="/css/**"/>
    
    <!-- 引用dubbo -->
    <dubbo:application name="taotao-manager-web" />
    <dubbo:registry protocol="zookeeper" address="192.168.25.128:2181" />
    <dubbo:reference interface="com.taotao.service.TestService" id="testService" />
    <dubbo:reference interface="com.taotao.service.ItemService" id="itemService" />
</beans>

可以看到就是将<mvc:default-servlet-handler/>换成了以下的代码：

<!-- 配置静态资源映射 -->
    <!-- 指定/WEB-INF/js  /WEB-INF/css/ 下的所有的静态资源包括子目录下的静态资源  都不被拦截 -->
    <!-- mapping = /js/**   表示访问静态资源的路劲的形式  可以访问/js/下的所有子目录下的资源 -->
        <mvc:resources location="/WEB-INF/js/" mapping="/js/**"/>
        <mvc:resources location="/WEB-INF/css/" mapping="/css/**"/>

其中 location属性是你的静态资源放置的真实位置，也就是WEN-INF下面的js文件夹和css文件夹，然后将其映射到 /js/** 和 /css/** 路径，也就是说使用 /js/** 这样的路径不会被前端控制器处理，直接访问的是静态资源。

关于SSM还有很多细节问题需要注意，希望读者能够在写代码的时候多多注意。