一、SpringMVC 概述
- 定义：基于 Java 实现 MVC 设计模型的轻量级 Web 框架，是 Spring Framework 核心模块之一，提供全功能 MVC 支持，简化 Web 应用开发。
- 核心价值：解耦请求处理、业务逻辑与视图展示，提供注解驱动、参数绑定、拦截器等强大功能，开发更优雅高效。
二、三层架构与 MVC 模式
1. 三层架构（B/S 架构核心）
| 层级 | 职责 | 对应技术 |
|---|
| 表现层（WEB 层） | 与客户端交互，接收请求、返回响应 | SpringMVC（MVC 设计） |
| 业务层 | 处理核心业务逻辑 | Spring（Service 层） |
| 持久层 | 数据库操作（CRUD） | MyBatis、JPA 等 |
2. MVC 模型（表现层设计模式）
| 组件 | 职责 | 对应实现 |
|---|
| Model（模型） | 数据封装与业务数据载体 | JavaBean、POJO（含 getter/setter） |
| View（视图） | 数据展示，与用户交互 | JSP、HTML、Thymeleaf 等 |
| Controller（控制器） | 接收请求、调度流程、返回视图 | SpringMVC 注解式 Controller |
三、SpringMVC 入门案例（完整流程）
1. 环境搭建（Maven 依赖）
<properties>
<spring.version>5.0.2.RELEASE</spring.version>
</properties>
<dependencies>
<!-- Spring 核心依赖 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- Spring Web 依赖 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- SpringMVC 核心依赖 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- Servlet 依赖（容器提供，scope=provided） -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
</dependency>
</dependencies>
2. 核心配置
（1）web.xml 配置（前端控制器）
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5">
<!-- 前端控制器 DispatcherServlet（SpringMVC 入口） -->
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 关联 SpringMVC 配置文件 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<!-- 启动服务器时加载（优先级 1） -->
<load-on-startup>1</load-on-startup>
</servlet>
<!-- 拦截所有 .do 后缀请求 -->
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
</web-app>
（2）springmvc.xml 配置（核心配置文件）
<?xml version="1.0" encoding="UTF-8"?>
<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/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 1. 注解扫描（扫描 Controller 所在包） -->
<context:component-scan base-package="cn.tx.demo1" />
<!-- 2. 视图解析器（解析返回的视图名称） -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/pages/" /> <!-- 视图前缀（JSP 所在目录） -->
<property name="suffix" value=".jsp" /> <!-- 视图后缀（文件扩展名） -->
</bean>
</beans>
3. 代码实现
（1）控制器（Controller）
package cn.tx.demo1;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller // 标记为控制器，被 Spring 扫描
@RequestMapping("/user") // 类级 URL 前缀（所有方法路径都带 /user）
public class UserController {
// 方法级 URL：/user/hello.do，接收 GET/POST 请求
@RequestMapping("/hello.do")
public String sayHello() {
System.out.println("入门方法执行了...");
return "suc"; // 对应视图：/pages/suc.jsp（视图解析器拼接前缀+后缀）
}
}
（2）JSP 页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>入门程序</title></head>
<body>
<h3>SpringMVC 入门</h3>
<a href="/user/hello.do">点击访问</a> <!-- 跳转至控制器方法 -->
</body>
</html>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>成功</title></head>
<body>
<h3>操作成功！</h3>
</body>
</html>
4. 运行流程
- 浏览器访问
http://localhost:8080/user/hello.do； - 前端控制器（DispatcherServlet）拦截
.do 请求，通过 HandlerMapping 找到对应 Controller 方法； - 执行
sayHello() 方法，返回视图名称 suc； - 视图解析器将
suc 解析为 /pages/suc.jsp，跳转至成功页。
四、核心功能详解
1. 请求参数绑定（自动类型转换，无需手动解析）
（1）基本数据类型绑定（直接接收请求参数）
@RequestMapping("/save1.do")
public String save(String username, Integer age) {
System.out.println("姓名：" + username + "，年龄：" + age);
return "suc";
}
// 请求示例：/save1.do?username=张三&age=20
（2）实体对象绑定（支持嵌套对象、集合）
public class User {
private String username;
private Integer age;
private Address address; // 嵌套对象
private List<Address> list; // 集合对象
// getter/setter 方法（必须有，否则无法绑定）
}
@RequestMapping("/save2.do")
public String save2(User user) {
System.out.println("用户对象：" + user);
return "suc";
}
<form action="/user/save2.do" method="post">
姓名：<input type="text" name="username" /><br/>
年龄：<input type="text" name="age" /><br/>
地址金额：<input type="text" name="address.money" /><br/> <!-- 嵌套对象绑定 -->
集合1：<input type="text" name="list[0].money" /><br/> <!-- 集合绑定 -->
集合2：<input type="text" name="list[1].money" /><br/>
<input type="submit" value="提交" />
</form>
2. 常用注解详解
| 注解 | 核心作用 | 示例代码 |
|---|
| @Controller | 标记类为 SpringMVC 控制器 | @Controller @RequestMapping("/user") public class UserController { ... } |
| @RequestMapping | 绑定 URL 路径与请求方法（类 / 方法级） | @RequestMapping(path = "/emp", method = RequestMethod.POST) |
| @RequestParam | 绑定请求参数（解决参数名与形参名不一致） | @RequestParam(value = "username", required = false, defaultValue = "abc") String name |
| @PathVariable | 绑定 URL 路径占位符（RESTful 风格） | @RequestMapping("/emp/{id}") public String findById(@PathVariable("id") Integer id) { ... } |
| @RequestHeader | 获取请求头信息 | @RequestHeader("User-Agent") String browserInfo |
| @CookieValue | 获取客户端 Cookie 值 | @CookieValue("JSESSIONID") String sessionId |
| @RequestBody | 获取请求体内容（如 JSON、表单数据） | @RequestBody String requestBody |
3. 文件上传功能
（1）添加依赖
<!-- 文件上传依赖 -->
<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>
（2）配置文件上传解析器（springmvc.xml）
<!-- 文件上传解析器（id 必须为 multipartResolver） -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<property name="maxUploadSize" value="8388608" /> <!-- 最大上传大小：8MB -->
</bean>
（3）控制器方法
@Controller
public class UploadController {
@RequestMapping("/fileupload.do")
public String upload(MultipartFile upload, HttpServletRequest request) throws IOException {
// 1. 获取服务器上传目录（真实路径）
String realPath = request.getSession().getServletContext().getRealPath("/uploads");
File uploadDir = new File(realPath);
if (!uploadDir.exists()) uploadDir.mkdirs(); // 目录不存在则创建
// 2. 处理文件名（UUID 避免重名）
String originalFilename = upload.getOriginalFilename();
String uuid = UUID.randomUUID().toString().replace("-", "").toUpperCase();
String newFilename = uuid + "_" + originalFilename;
// 3. 上传文件到服务器
upload.transferTo(new File(uploadDir, newFilename));
return "upload_success"; // 上传成功页
}
}
4. 拦截器（AOP 思想，横切处理请求）
（1）自定义拦截器（实现 HandlerInterceptor 接口）
public class MyInterceptor implements HandlerInterceptor {
// 1. 请求执行前调用（返回 true 放行，false 拦截）
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("preHandle：请求前拦截（如登录验证）");
return true; // 放行请求
}
// 2. 控制器方法执行后、视图渲染前调用
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle：方法执行后处理（如修改视图数据）");
}
// 3. 视图渲染完成后调用（如资源清理）
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion：请求完成后处理");
}
}
（2）配置拦截器（springmvc.xml）
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**" /> <!-- 拦截所有请求（/** 表示多层路径） -->
<!-- <mvc:exclude-mapping path="/login.do" /> 排除某个请求（如登录页） -->
<bean class="cn.tx.demo4.MyInterceptor" /> <!-- 自定义拦截器 -->
</mvc:interceptor>
</mvc:interceptors>
五、SpringMVC 核心特点
- 注解驱动：减少 XML 配置，注解（如
@Controller、@RequestMapping）简化开发； - RESTful 支持：通过
@PathVariable 实现 URL 路径占位符，风格简洁统一； - 强大参数绑定：支持基本类型、对象、集合、文件等多种参数类型，自动类型转换；
- 灵活视图解析：支持 JSP、Thymeleaf 等多种视图技术，可自定义视图解析器；
- 拦截器机制：无侵入式实现横切逻辑（如登录验证、日志记录、权限控制）；
- 无缝集成 Spring：与 Spring 容器无缝衔接，共享 Bean、事务管理等功能。
扫一扫
14万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
