SpringMVC 框架核心知识点详解与实战

---

引言

SpringMVC 是 Spring 框架中用于构建 Web 应用程序的模块，它基于 MVC（Model-View-Controller）设计模式，能够高效地处理 Web 请求并返回响应。本文将深入探讨 SpringMVC 框架的核心功能，包括响应数据与结果视图、文件上传、异常处理以及拦截器的使用，并结合详细的代码示例进行讲解。

---

一、响应数据和结果视图

1.1 开发环境搭建

在使用 SpringMVC 前，需要通过 Maven 引入相关依赖，包括 Spring 核心上下文、Web 模块和 WebMVC 模块，同时还需添加 Servlet 和 JSP 相关依赖。

<properties><spring.version>5.0.2.RELEASE</spring.version>
</properties>
<dependencies><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-web</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>${spring.version}</version></dependency><dependency><groupId>javax.servlet</groupId><artifactId>servlet-api</artifactId><version>2.5</version><scope>provided</scope></dependency><dependency><groupId>javax.servlet.jsp</groupId><artifactId>jsp-api</artifactId><version>2.0</version><scope>provided</scope></dependency>
</dependencies>

同时，在web.xml中配置前端控制器DispatcherServlet和字符编码过滤器，确保请求能够正确分发和处理中文乱码问题。

<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><servlet><servlet-name>dispatcherServlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc.xml</param-value></init-param><load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping><servlet-name>dispatcherServlet</servlet-name><url-pattern>*.do</url-pattern>
</servlet-mapping>

在springmvc.xml中配置注解扫描、视图解析器和启用注解驱动，完成基础环境搭建。

<beans xmlns="http://www.springframework.org/schema/beans"xmlns:mvc="http://www.springframework.org/schema/mvc"xmlns:context="http://www.springframework.org/schema/context"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd"><context:component-scan base-package="com.qcbyjy" /><bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/pages/" /><property name="suffix" value=".jsp" /></bean><mvc:annotation-driven/>
</beans>

1.2 返回值类型

返回 String：Controller 方法返回字符串时，该字符串会被视为逻辑视图名，结合视图解析器转换为物理视图地址。例如：

@Controller
@RequestMapping("/user")
public class UserController {@RequestMapping("/save1.do")public String save1(){System.out.println("执行了...");return "suc";}
}

返回 void：若返回值为void，默认不会进行视图解析，可能会导致 404 异常。可通过请求转发或直接输出响应内容的方式进行处理。

@RequestMapping("/save2.do")
public void save2(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {System.out.println("执行了...");response.getWriter().print("hello");
}

返回 ModelAndView：ModelAndView对象可同时携带数据和指定视图名称，实现数据与视图的统一管理。

@RequestMapping("/save3.do")
public ModelAndView save3(){System.out.println("执行了...");ModelAndView mv = new ModelAndView();mv.addObject("msg","用户名或者密码已经存在");mv.setViewName("suc");return mv;
}

1.3 转发与重定向

通过在返回的字符串中添加forward:或redirect:前缀，可实现请求转发和重定向。

@RequestMapping("/save4.do")
public String save4(){System.out.println("执行了...");return "forward:/pages/suc.jsp";
}@RequestMapping("/save5.do")
public String save5(){System.out.println("执行了...");return "redirect:/pages/suc.jsp";
}

1.4 响应 json 数据

引入 Jackson 相关依赖后，使用@ResponseBody注解可将 Java 对象自动转换为 JSON 格式并返回。

<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.9.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.9.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.9.0</version>
</dependency>

@RequestMapping("/save6.do")
public @ResponseBody User save6(@RequestBody User user){System.out.println(user);user.setUsername("hello");user.setAge(100);return user;
}

1.5 静态资源处理

为避免DispatcherServlet拦截静态资源，可在springmvc.xml中配置静态资源映射。

<mvc:resources location="/css/" mapping="/css/**"/>
<mvc:resources location="/images/" mapping="/images/**"/>
<mvc:resources location="/js/" mapping="/js/**"/>

二、SpringMVC 实现文件上传

2.1 准备工作

导入commons-fileupload和commons-io依赖，用于处理文件上传操作。

<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.3.1</version>
</dependency>
<dependency><groupId>commons-io</groupId><artifactId>commons-io</artifactId><version>2.4</version>
</dependency>

编写文件上传的 JSP 页面，设置enctype="multipart/form-data"属性。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>文件上传</title>
</head>
<body><h3>文件上传</h3><form action="/fileupload.do" method="post" enctype="multipart/form-data">选择文件：<input type="file" name="upload" /><br/><input type="submit" value="上传" /></form>
</body>
</html>

2.2 传统方式文件上传

在springmvc.xml中配置文件上传解析器，并设置上传文件的最大大小。

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="maxUploadSize" value="8388608" />
</bean>

在 Controller 中使用MultipartFile对象接收上传文件，并实现文件保存逻辑。

@Controller
public class UploadController {@RequestMapping("/fileupload.do")public String upload(MultipartFile upload, HttpServletRequest request) throws IOException {String realPath = request.getSession().getServletContext().getRealPath("/uploads");File file = new File(realPath);if(!file.exists()){file.mkdirs();}String filename = upload.getOriginalFilename();String uuid = UUID.randomUUID().toString().replace("-", "").toUpperCase();filename = uuid+"_"+filename;upload.transferTo(new File(file,filename));return "suc";}
}

三、SpringMVC 的异常处理

3.1 异常处理思路

Controller 调用 service，service 调用 dao 时，异常会向上抛出，最终由DispatcherServlet找到异常处理器进行处理。

3.2 实现异常处理

定义自定义异常类SysException，用于封装特定的异常信息。

public class SysException extends Exception{private String message;@Overridepublic String getMessage() {return message;}public void setMessage(String message) {this.message = message;}public SysException(String message) {this.message = message;}
}

创建自定义异常处理器SysExceptionResolver，实现HandlerExceptionResolver接口，根据异常类型进行相应处理。

public class SysExceptionResolver implements HandlerExceptionResolver {@Overridepublic ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object o, Exception e) {e.printStackTrace();SysException exception = null;if(e instanceof SysException){exception = (SysException)e;}else{exception = new SysException("系统正在维护，请联系管理员");}ModelAndView mv = new ModelAndView();mv.addObject("errorMsg",exception.getMessage());mv.setViewName("error");return mv;}
}

在springmvc.xml中配置异常处理器。

<bean id="sysExceptionResolver" class="cn.tx.demo3.SysExceptionResolver" />

在 Controller 中模拟异常抛出，触发异常处理流程。

@Controller
@RequestMapping("/role")
public class RoleController {@RequestMapping("/findAll.do")public String findAll(){System.out.println("执行了...");int a = 10/0;return "suc";}
}

四、SpringMVC 框架中的拦截器

4.1 拦截器概述

拦截器用于对处理器进行预处理和后处理，与过滤器功能类似，但拦截器是 SpringMVC 框架独有的，且只会对控制器中的方法进行拦截，是 AOP 思想的一种实现方式。

4.2 自定义拦截器

创建实现HandlerInterceptor接口的拦截器类，重写preHandle、postHandle和afterCompletion方法。

public class MyInterceptor2 implements HandlerInterceptor{@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {System.out.println("拦截器preHandle方法执行了...");return true;}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {System.out.println("postHandle方法执行了...");}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {System.out.println("afterCompletion方法执行了...");}
}

在springmvc.xml中配置拦截器，指定拦截路径。

<mvc:interceptors><mvc:interceptor><mvc:mapping path="/dept/**"/><bean class="cn.tx.demo4.MyInterceptor2" /></mvc:interceptor>
</mvc:interceptors>

4.3 多个拦截器配置

配置多个拦截器时，可通过mvc:interceptor标签依次定义，拦截器的执行顺序与配置顺序一致。

<mvc:interceptors><mvc:interceptor><mvc:mapping path="/dept/**"/><bean class="cn.tx.demo4.MyInterceptor2" /></mvc:interceptor><mvc:interceptor><mvc:mapping path="/**"/><bean class="cn.tx.demo4.MyInterceptor3" /></mvc:interceptor>
</mvc:interceptors>

多个拦截器执行顺序

• preHandle 方法的执行：当一个请求进入 SpringMVC 框架并找到对应的处理器（Controller 方法）后，会先调用 Interceptor1 的 preHandle 方法，然后再调用 Interceptor2 的 preHandle 方法，即按照拦截器在配置文件中配置的顺序依次执行它们的 preHandle 方法。如果其中某个拦截器的 preHandle 方法返回 false，则后续拦截器的 preHandle 方法以及处理器都不会被执行。
• postHandle 方法的执行：在处理器（Controller 方法）执行完成后，视图渲染之前，会先调用 Interceptor2 的 postHandle 方法，然后再调用 Interceptor1 的 postHandle 方法。也就是说，postHandle 方法的执行顺序与拦截器的配置顺序相反。这是因为 Interceptor2 是后配置的，它更接近处理器的执行，所以在处理器执行完后，先从它开始逆向执行 postHandle 方法。
• afterCompletion 方法的执行：在视图渲染完成后，会先调用 Interceptor2 的 afterCompletion 方法，然后再调用 Interceptor1 的 afterCompletion 方法。同样，afterCompletion 方法也是按照与配置顺序相反的顺序执行的。这是为了保证在整个请求处理流程结束后，按照与拦截器介入时相反的顺序进行一些资源清理、状态恢复等操作。

4.4过滤器与拦截器的区别

对比项	过滤器（Filter）	拦截器（Interceptor）
所属规范	Servlet 规范的一部分	SpringMVC 框架特有
作用范围	处理 Servlet 容器所有请求和响应，含静态和动态资源	仅针对 SpringMVC 控制器方法
初始化	Servlet 容器启动时初始化	SpringMVC 容器初始化时加载
执行顺序	按 web.xml 配置顺序依次执行，响应反向	按配置顺序执行 preHandle，postHandle 和 afterCompletion 逆序
核心方法	init()、doFilter()、destroy()	preHandle()、postHandle()、afterCompletion()
应用场景	通用 Web 请求处理，如编码、权限、日志等	SpringMVC 业务流程处理，如数据加工、性能监控等
技术实现	实现 javax.servlet.Filter 接口，web.xml 或注解配置	实现 org.springframework.web.servlet.HandlerInterceptor 接口，SpringMVC 配置文件配置

---

总结

本文全面介绍了 SpringMVC 框架的核心功能，从响应数据和结果视图的处理，到文件上传、异常处理以及拦截器的使用，通过详细的代码示例展示了各功能的实现方式。这些知识点是构建高效、稳定的 SpringMVC Web 应用的基础，熟练掌握它们有助于开发者更好地应对实际项目中的各种需求。