SpringMVC静态资源配置

最新推荐文章于 2023-10-26 19:35:55 发布

原创最新推荐文章于 2023-10-26 19:35:55 发布 · 260 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#springmvc #spring #java

java后端专栏收录该内容

1 篇文章

订阅专栏

本文介绍了在SSM框架中配置访问静态资源的方法。通过一个淘淘商城项目的实例，阐述了DispatcherServlet的/*拦截规则可能导致静态资源无法访问的问题。解决办法是在springmvc.xml中配置<mvc:default-servlet-handler/>或指定静态资源路径，避免通过Controller跳转，提高效率。建议使用location属性映射静态资源的实际位置，以实现直接访问。

跟着传智的视频在做那个淘淘商城的项目，做到第二天，发现自己以前学习的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还有很多细节问题需要注意，希望读者能够在写代码的时候多多注意。