Spring MVC 核心架构
核心组件
| 组件 | 作用 | 类比 |
|---|---|---|
| DispatcherServlet | 前端控制器，统一接收请求并协调各组件处理 | 一个餐厅的前台 |
| HandlerMapping | 根据请求URL映射到对应的处理器（Controller） | 路由表 |
| HandlerAdapter | 执行处理器方法，处理参数绑定、方法调用等 | 适配器（兼容不同处理器） |
| ViewResolver | 将逻辑视图名解析为物理视图（如JSP、Thymeleaf） | 地图导航 |
| View | 渲染模型数据生成最终响应（HTML/JSON等） | 厨师（加工数据） |
| HandlerExceptionResolver | 统一处理控制器抛出的异常 | 故障应急小组 |
分层架构
客户端 => DispatcherServlet => HandlerMapping
=> Controller => ModelAndView => View => 响应
相当于
客户端 => 前端控制器 => 处理器映射器 => 处理器 =>模型与视图容器 => 响应器 =>响应
请求处理的流程
- 请求到达：客户端发送http请求到前端控制器DispatcherServelt
- 查找处理器：前端控制器DispatcherServlet调用HandlerMapping确定目标控制器Controller
- 获取适配器：通过处理器适配器HandlerAdapter执行控制器方法
- 拦截器预处理：执行拦截器链的preHandle（）
- 参数绑定：适配器解析请求参数（路径变量、表单数据等），传递给控制器方法
- 执行控制器：调用控制器Controller方法执行业务逻辑
- 返回模型与视图：控制器Controller返回ModelAndView（或String视图名、@ResponseBody等）
- 拦截器后处理：执行拦截器链后的postHandle（）
- 视图解析：视图解析器ViewResolver将逻辑视图名转换为具体View对象
- 视图渲染：响应器View渲染模型数据产生响应内容（HTML/JSON）
- 拦截器完成：执行拦截器链的afterCompletion（）
关键环节：HTTP请求 → Java对象
当请求到达控制器方法前，Spring MVC会自动提取请求中的各种数据
@RequestParam：获取URL查询字符串参数
// 请求：/search?keyword=spring
@GetMapping("/search")
public String search(@RequestParam("keyword") String keyword) {
// keyword = "spring"
}@PathVariable：获取URL路径中的变量
// 请求：/users/123/profile
@GetMapping("/users/{userId}/profile")
public String profile(@PathVariable("userId") Long id) {
// id = 123
}@RequestBody：将JSON/XML请求体转换为Java对象
// 请求体：{"name":"John","age":30}
@PostMapping("/users")
public User createUser(@RequestBody User user) {
// user.getName() = "John"
// user.getAge() = 30
}表单绑定：自动将表单字段映射到对象属性
// 表单字段：username=admin&password=123
@PostMapping("/login")
public String login(UserForm form) {
// form.getUsername() = "admin"
}配置视图解析器的流程
（假如控制器返回一个字符串“success”）
控制器返回字符串 => return ‘success’=> 视图解析器=> 检查配置
=> 前缀+字符串success+后缀=> 合成地址/WEB-INF/views/success.jsp=> 返回实际视图文件
应用配置的前缀和后缀：
resolver.setPrefix("/WEB-INF/views/"); // 视图文件目录
resolver.setSuffix(".jsp"); // 文件扩展名配置文件示例：
@Configuration
public class WebConfig {
@Bean
public ViewResolver viewResolver() {
InternalResourceViewResolver resolver = new InternalResourceViewResolver();
resolver.setPrefix("/WEB-INF/views/"); // 视图存放目录
resolver.setSuffix(".jsp"); // 文件扩展名
return resolver;
}
}异常的分层处理
方法级处理（优先级最高）
@Controller
public class UserController {
@ExceptionHandler(UserNotFoundException.class)
public ResponseEntity<String> handleUserNotFound() {
return ResponseEntity.status(404).body("用户不存在");
}
}控制器级处理
@Controller
@ExceptionHandler({IllegalArgumentException.class,
DataAccessException.class})
public ResponseEntity<String> handleControllerExceptions() {
// 处理本控制器所有指定异常
}全局处理（最常用）
@ControllerAdvice // 作用于所有控制器
public class GlobalExceptionHandler {
// 处理特定异常
@ExceptionHandler(ResourceNotFoundException.class)
public ResponseEntity<ErrorResponse> handleResourceNotFound(
ResourceNotFoundException ex) {
ErrorResponse error = new ErrorResponse(
"NOT_FOUND",
ex.getMessage(),
System.currentTimeMillis()
);
return new ResponseEntity<>(error, HttpStatus.NOT_FOUND);
}
// 兜底处理所有未捕获异常
@ExceptionHandler(Exception.class)
public ResponseEntity<ErrorResponse> handleAllExceptions(Exception ex) {
// 返回通用错误响应
}
}关于用户访问个人资料页面的示例
请求：GET /users/123/profile
参数绑定：提取路径变量 userId=123
控制器方法处理：
@GetMapping("/users/{userId}/profile")
public String userProfile(@PathVariable Long userId, Model model) {
User user = userService.findById(userId); // 可能抛出异常
model.addAttribute("user", user);
return "user/profile"; // 逻辑视图名
}处理异常：若用户不存在，抛出UserNotFoundException
视图解析：将"user/profile"转换为/WEB-INF/views/user/profile.jsp
渲染页面并返回响应