SpringMVC 笔记——注解方式声明控制器及资源访问

最新推荐文章于 2025-06-28 10:05:18 发布

Liekkas_BX

最新推荐文章于 2025-06-28 10:05:18 发布

阅读量1.9k

点赞数

CC 4.0 BY-SA版权

分类专栏： Spring 文章标签： spring mvc dispatcherServlet

本文链接：https://blog.youkuaiyun.com/qq_19865749/article/details/75105462

Spring 专栏收录该内容

17 篇文章

订阅专栏

本文详细介绍了SpringMVC项目的搭建过程，包括web.xml配置、DispatcherServlet配置及其映射文件配置，探讨了Controller定义方法及页面访问方式。同时，深入讨论了资源访问问题，对比了不同配置下的效果。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、新建动态Web 工程

工程名: TestSpringMVC

1、配置web.xml

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
  	<display-name>Test Web Application</display-name>
  	<description>A simple SpringMVC project.</description>
        <!-- 配置log4j.properties -->
        <context-param>  
            <param-name>log4jConfigLocation</param-name>  
            <param-value>classpath:log4j.properties</param-value>  
        </context-param>  
        <context-param>  
            <param-name>log4jRefreshInterval</param-name>  
            <param-value>60000</param-value>  
        </context-param>  
  	<!-- 配置 Spring 上下文-->
  	<context-param>
  		<param-name>contextConfigLocation</param-name>
  		<param-value>/WEB-INF/spring-context.xml</param-value>
  	</context-param>
  	<!-- 编码过滤器 -->
  	<filter>
		<filter-name>encodingFilter</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>encodingFilter</filter-name>

            <url-pattern>/*</url-pattern>

        </filter-mapping>

       <listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  	</listener>
  	<listener>  
            <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>  
        </listener>
  	<!-- 初始化 SpringMVC 有效的bean Controller、HandlerMapping、HandlerAdapter 终继承httpServlet，需有rest-servlet.xml -->
  	<servlet>
		<servlet-name>dispatcher</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<load-on-startup>1</load-on-startup>
  	</servlet>
  	<servlet-mapping>
		<servlet-name>dispatcher</servlet-name>
		<url-pattern>/</url-pattern>
  	</servlet-mapping>
	<welcome-file-list>
	    <welcome-file>index.html</welcome-file>
	</welcome-file-list>
</web-app>

2、配置DispatcherServlet 对应的映射文件

此处使用默认的名字，即dispatcher-servlet.xml，放于WEB-INF下。

<beans xmlns="http://www.springframework.org/schema/beans"
      	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     	xmlns:context="http://www.springframework.org/schema/context"
     	xmlns:mvc="http://www.springframework.org/schema/mvc"
     	xsi:schemaLocation="http://www.springframework.org/schema/beans 
     			http://www.springframework.org/schema/beans/spring-beans.xsd
         		http://www.springframework.org/schema/context 
         		http://www.springframework.org/schema/context/spring-context-4.0.xsd
        		http://www.springframework.org/schema/mvc 
        		http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
         
         <!-- 配置自动扫描的基础包，该包下子包也会被扫描 -->
         <context:component-scan base-package="com.milan.web"></context:component-scan>
         <!-- 配置视图解析器 如何把Controller 组件的方法返回值解析为实际的物理视图 -->
         <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
             <property name = "prefix" value="/views/"></property>
             <property name = "suffix" value = ".jsp"></property>
         </bean>
 </beans>

说明：
DispatcherServlet 的配置文件的beans 声明部分都是相同的，只是版本号的区别，所以对于不同版本，只需修改上面的版本号（保留2位，上面为4.0）

Spring 中定义组件的注解：

@Component：最普通组件，比之下三种，没太多语义

@Repository: 持久层组件，即DAO 组件

@Service：业务层组件

@Controller：控制层组件

3、以注解方式定义 Controller 及页面访问

此处以注解方式定义控制器。新建 com.milan.web 包，里面定义Controller 组件TestController。

TestController.java：

package com.milan.web.controller;

import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/request")
public class TestController {
	
	@RequestMapping("/testController")
	public String testMethod(){
		System.out.println("hello world");
		return "success";
	}
}

说明：根据web.xml 中对DispatcherServlet 的映射路径"/"，及dispatcher-servlet.xml 中视图解析器的路径配置（prefix="/views/"，suffix=".jsp"），结合@RequestMapping注解值

则下面的请求路径将返回webapp/views目录下success.jsp（需先定义目录结构与文件）

localhost:8080/TestSpringMVC/request/testController

而实际上，此路径会提示：HTTP ERROR 500 错误

控制台输出错误信息为：

hello world

[ERROR] /test_c3p0/request/testController

java.lang.NoSuchMethodError: javax.servlet.ServletContext.getEffectiveMajorVersion()I

打印了字符串，可见已经进入了 testMethod 方法，但却没返回与显示success.jsp页面。

修改访问路径，直接访问success.jsp

localhost:8080/TestSpringMVC/views/success.jsp

控制台提示错误信息为：

[ERROR] /test_c3p0/views/success.jsp
java.lang.NoSuchMethodError: javax.servlet.ServletContext.getEffectiveMajorVersion()I

可见并没有被DispatcherServlet 拦截处理。

修改web.xml中dispatcher映射路径为/* （注意原来为/）

请求路径：

localhost:8080/TestSpringMVC/request/testController

控制台提示错误信息：

hello world
WARN 2017-07-14 14:44:28 [PageNotFound:947] - No mapping found for HTTP request with URI [/test_c3p0/views/success.jsp] in DispatcherServlet with name 'dispatcherServlet'

请求路径：

localhost:8080/TestSpringMVC/views/success.jsp

错误信息：

WARN 2017-07-14 14:46:46 [PageNotFound:947] - No mapping found for HTTP request with URI [/test_c3p0/views/success.jsp] in DispatcherServlet with name 'dispatcherServlet'

解决此访问问题，只需在web.xml 中增加下面配置（web.xml中映射路径仍还原为/，且不需要声明名为default的servlet），就可以正确访问，但效果不同

<servlet-mapping>
		<servlet-name>default</servlet-name>
		<url-pattern>*.jsp</url-pattern>
</servlet-mapping>

通过以下路径返回页面，控制台会打印helloworld，但页面出现乱码：

localhost:8080/TestSpringMVC/request/testController

而此路径控制台不会打印Helloworld ，但页面没有乱码：

localhost:8080/TestSpringMVC/views/success.jsp

参考：http://www.cnblogs.com/bigdataZJ/p/springmvc1.html

二、SpringMVC 资源访问问题

1、DispatcherServlet 的路径映射"/" 与"/*"的区别？

/ 只拦截不带后缀名的请求，/* 会处理所有请求。

但是，当dispatcherServlet 中增加了处理.jsp 的default的映射时，映射为/ 的dispatcherServlet 能返回页面（上面实验中乱码的页面），而没有增加此default 映射时，无法进入Controller。简言之，直接访问静态资源能返回的，Controller方式访问也能返回，但却没有经过Controller的方法。对此有点不解，先放着。

2、最好将全部资源访问交由SpringMVC 处理

DispacherServlet对应的配置文件中：

使用<mvc:default-servlet-handler />:

将会在Spring MVC上下文中定义一个org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，它会像一个检查员，对进入DispatcherServlet的URL进行筛查，如果发现是静态资源的请求，就将该请求转由Web应用服务器默认的Servlet处理，如果不是静态资源的请求，才由DispatcherServlet继续处理。

此servlet 默认名字为default，也可修改：

<mvc:default-servlet-handler default-servlet-name="名字" />

使用<mvc:resources />：

使用mvc:default-servlet-handler 将静态资源的处理经由Spring MVC框架交回Web应用服务器处理。而mvc:resources 更进一步，由Spring MVC框架自己处理静态资源，并添加一些有用的附加值功能。

首先，mvc:resources 允许静态资源放在任何地方，如WEB-INF目录下、类路径下等，你甚至可以将JavaScript等静态文件打到JAR包中。通过location属性指定静态资源的位置，由于location属性是Resources类型，因此可以使用诸如”classpath:”等的资源前缀指定资源位置。传统Web容器的静态资源只能放在Web容器的根路径下mvc:resources 完全打破了这个限制。

其次，mvc:resources 依据当前著名的Page Speed、YSlow等浏览器优化原则对静态资源提供优化。你可以通过cacheSeconds属性指定静态资源在浏览器端的缓存时间，一般可将该时间设置为一年，以充分利用浏览器端的缓存。在输出静态资源时，会根据配置设置好响应报文头的Expires 和 Cache-Control值。

在接收到静态资源的获取请求时，会检查请求头的Last-Modified值，如果静态资源没有发生变化，则直接返回303相应状态码，提示客户端使用浏览器缓存的数据，而非将静态资源的内容输出到客户端，以充分节省带宽，提高程序性能。

配置示例：

<mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>

以上配置将Web根路径”/”及类路径下 /META-INF/publicResources/ 的目录映射为/resources路径。假设Web根路径下拥有images、js这两个资源目录,在images下面有bg.gif图片，在js下面有test.js文件，则可以通过 /resources/images/bg.gif 和 /resources/js/test.js 访问这二个静态资源。

假设WebRoot还拥有images/bg1.gif 及 js/test1.js，则也可以在网页中通过 /resources/images/bg1.gif 及 /resources/js/test1.js 进行引用。

参考： http://www.cnblogs.com/fangqi/archive/2012/10/28/2743108.html 原文值得一看（关于REST 服务）