一、引言
在现代 Java 企业级开发领域，Spring MVC 作为 Spring 框架家族中专注于构建 Web 应用的核心模块，凭借其强大、灵活且高效的特性，占据着举足轻重的地位。它遵循经典的 MVC（Model-View-Controller）设计模式，将业务逻辑、数据展示以及用户交互清晰地分离开来，极大地提升了代码的可维护性、可扩展性与可复用性。无论是小型项目的快速搭建，还是大型分布式系统中的 Web 服务层构建，Spring MVC 都展现出卓越的适配能力，接下来，让我们深入探究其底层原理、细致的配置方式以及基础应用场景。
二、Spring MVC 核心原理剖析
（一）MVC 设计模式基础
MVC 设计模式旨在分离应用程序的输入逻辑（Controller）、业务逻辑（Model）与输出逻辑（View）。在 Spring MVC 架构下，Controller 负责接收用户请求，解析请求参数，并决定调用何种业务逻辑方法；Model 封装应用数据，承载业务处理结果，它可以是简单的 POJO（Plain Old Java Object）类，存储数据库查询结果、计算值等；View 则专注于将 Model 中的数据以特定格式（如 HTML、JSON、XML 等）呈现给用户，常见的视图技术包括 JSP、Thymeleaf、Freemarker 等。这种解耦使得各层可以独立演进，开发人员可以专注于某一层功能优化而不影响其他层。
（二）DispatcherServlet 中央调度器
Spring MVC 的核心枢纽是 DispatcherServlet，作为前端控制器，它掌控着整个请求处理流程。当客户端发送 HTTP 请求时，该请求首先抵达 DispatcherServlet，它依据配置的映射规则（如 URL 映射）将请求分发给对应的 Controller 处理方法。例如，对于 URL "/user/list" 的请求，DispatcherServlet 会在预定义的处理器映射（HandlerMapping）中查找匹配的 Controller 方法，确保请求能精准定位到业务逻辑入口。
（三）HandlerMapping 与 HandlerAdapter
HandlerMapping 负责建立请求 URL 与 Controller 处理方法间的映射关系，Spring MVC 提供多种映射策略，像基于注解的 @RequestMapping 方式，开发人员能轻松将 URL 路径与特定方法绑定，如在 UserController 类中：
java
Copy
@Controller
@RequestMapping("/user")
public class UserController {
@RequestMapping("/list")
public String listUsers(Model model) {
// 业务逻辑，查询用户列表
List<User> userList = userService.findAll();
model.addAttribute("userList", userList);
return "userList";
}
}
此处，"/user/list" 路径对应 listUsers 方法。而 HandlerAdapter 则作为适配层，协调 DispatcherServlet 与不同类型的 Controller 方法调用，它知晓如何调用基于注解、基于接口规范等各类形式定义的 Controller 方法，确保请求执行流程无缝衔接。
（四）ModelAndView 与视图解析
Controller 方法执行完业务逻辑后，常返回 ModelAndView 对象，Model 部分承载数据，View 部分指定视图名称（如 "userList"）。接着，视图解析器（ViewResolver）依据配置规则解析视图名称，定位实际物理视图资源。以 InternalResourceViewResolver 为例，若配置了前缀 "/WEB-INF/views/" 和后缀 ".jsp"，对于视图名称 "userList"，它会找到 "/WEB-INF/views/userList.jsp" 文件作为渲染模板，将 Model 数据填充进去，最终生成 HTML 页面返回客户端。
三、Spring MVC 详细配置解读
（一）基础项目搭建与依赖引入
使用 Spring MVC 首先要搭建 Java Web 项目，在 Maven 项目中，需在 pom.xml 文件引入核心依赖，包括 spring-webmvc、spring-context 等包，示例如下：
xml
Copy
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.22</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.3.22</version>
</dependency>
同时确保项目结构符合 Java Web 规范，有 src/main/java 存放 Java 代码，src/main/resources 放置配置文件，WEB-INF 目录包含 web.xml 等关键文件。
（二）web.xml 配置核心组件
传统方式下，web.xml 是配置 Spring MVC 的关键入口，需定义 DispatcherServlet，如下：
xml
Copy
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/spring-mvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
这里指定 DispatcherServlet 初始参数指向 spring-mvc.xml（后续配置核心文件），并设置 URL 映射为 "/"，意味着所有请求都会先经它处理，仅排除 JSP、静态资源等特定映射（可额外配置排除规则）。
（三）spring-mvc.xml 配置细节
- 开启注解扫描：利用
<context:component-scan>标签扫描指定包下带有注解（如 @Controller、@Service 等）的类，确保相关组件被 Spring 容器管理，示例：
xml
Copy
<context:component-scan base-package="com.example.controller,com.example.service"/>
- 配置视图解析器：以 Thymeleaf 为例，需引入 Thymeleaf 依赖后，在 spring-mvc.xml 配置：
xml
Copy
<bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
<property name="templateEngine">
<bean class="org.thymeleaf.spring5.SpringTemplateEngine">
<property name="templateResolver">
<bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
<property name="prefix" value="/WEB-INF/templates/"/>
<property name="suffix" value=".html"/>
<property name="characterEncoding" value="UTF-8"/>
</bean>
</property>
</bean>
</property>
</bean>
这精确设定了视图模板的前缀、后缀与编码，方便定位与渲染。
- 配置静态资源处理：为使 CSS、JS 等静态资源能正常访问，添加资源处理器，像：
xml
Copy
<mvc:resources mapping="/static/**" location="/static/"/>
允许对 "/static/" 目录下资源以 "/static/**" 路径模式访问，避免被 DispatcherServlet 误拦截。
四、Spring MVC 基础应用实例
（一）构建简单用户管理模块
- 定义数据模型（Model）：创建 User 实体类，包含 id、name、age 等属性及对应 get/set 方法，作为数据库操作与业务逻辑的数据载体。
java
Copy
public class User {
private Long id;
private String name;
private Integer age;
// 构造函数、get/set 方法省略
}
- 编写业务逻辑层（Service）：接口 UserService 定义操作规范，如 saveUser、getUserById 等方法，实现类 UserServiceImpl 借助 DAO 层（数据访问层，此处略）完成数据库交互与业务处理，示例 saveUser 方法：
java
Copy
@Service
public class UserServiceImpl implements UserService {
@Autowired
private UserDAO userDAO;
@Override
public void saveUser(User user) {
userDAO.save(user);
}
}
- 开发 Controller 层：UserController 类接收请求，调用 Service 方法，处理参数传递与视图跳转，如添加用户方法：
java
Copy
@Controller
@RequestMapping("/user")
public class UserController {
@Autowired
private UserService userService;
@RequestMapping("/add")
public String addUser(User user, Model model) {
userService.saveUser(user);
model.addAttribute("msg", "用户添加成功");
return "success";
}
}
这里将前端表单提交的 User 对象参数接收，保存后跳转至 "success" 视图展示提示信息。
（二）表单数据处理与验证
- 表单提交与绑定：在前端 JSP（或其他视图技术）页面，设计用户添加表单，各字段与 User 实体属性对应，提交到 "/user/add" 路径，Spring MVC 自动依据名称匹配将表单数据绑定到 User 对象，简化数据获取流程。
html
Copy
<form action="/user/add" method="post">
<input type="text" name="name" placeholder="姓名"/>
<input type="number" name="age" placeholder="年龄"/>
<input type="submit" value="添加用户"/>
</form>
- 数据验证：利用 Spring 的 Validation 框架（如 Hibernate Validator），在 User 类属性添加注解规范，如 @NotEmpty、@Min 等，在 Controller 方法参数前加 @Valid 启用验证，示例：
java
Copy
public class User {
@NotEmpty(message = "姓名不能为空")
private String name;
@Min(value = 18, message = "年龄需大于等于 18")
private Integer age;
// get/set 方法省略
}
java
Copy
@RequestMapping("/add")
public String addUser(@Valid User user, BindingResult bindingResult, Model model) {
if (bindingResult.hasErrors()) {
model.addAttribute("errors", bindingResult.getAllErrors());
return "addUserForm";
}
userService.saveUser(user);
model.addAttribute("msg", "用户添加成功");
return "success";
}
若验证出错，返回表单页面展示错误信息，确保数据完整性与合法性。
五、总结
Spring MVC 通过精妙的设计原理、细致的配置体系以及贴合实际的应用示例，展现强大 Web 开发能力。理解其原理有助于排查问题、优化性能；掌握配置可灵活定制项目架构；实践应用能快速搭建功能模块。后续我们将深入探究其高级特性，如异常处理、拦截器、异步处理等，进一步挖掘 Spring MVC 潜力，敬请期待。