Spring MVC 中请求处理流程及核心组件解析

在 Spring MVC 中，请求从客户端发送到服务器后，需要经过一系列组件的处理才能最终到达具体的 Controller 方法。这个过程涉及多个核心组件和复杂的映射机制，下面详细解析其工作流程：

1. 核心组件与请求流程

Spring MVC 的请求处理流程主要涉及以下核心组件：

DispatcherServlet：前端控制器，接收所有 HTTP 请求，是整个请求处理的入口。

HandlerMapping：请求映射处理器，负责将请求 URL 映射到对应的 Handler（即 Controller 方法）。

HandlerAdapter：处理器适配器，将不同类型的 Handler 统一为可执行的接口。

Controller：具体的业务控制器，处理请求并返回 ModelAndView。

ViewResolver：视图解析器，将逻辑视图名解析为具体的 View 对象。

View：视图对象，负责将模型数据渲染到客户端。

请求处理流程：

客户端请求 → DispatcherServlet → HandlerMapping → HandlerAdapter →

Controller → ModelAndView → ViewResolver → View → 响应客户端

2. HandlerMapping 的请求映射机制

HandlerMapping 是实现 URL 到 Controller 方法映射的核心组件，Spring MVC 提供了多种实现：

RequestMappingHandlerMapping ：处理 @RequestMapping 注解的映射（最常用）。

BeanNameUrlHandlerMapping ：根据 Bean 名称映射请求（如 /hello → helloController Bean）。

SimpleUrlHandlerMapping：通过配置文件手动指定 URL 与 Handler 的映射关系。

基于注解的映射流程

当使用 @RequestMapping 或其派生注解（如 @GetMapping）时：

启动时扫描 ：Spring MVC 在启动时会扫描所有带有 @Controller 或 @RestController 注解的 Bean。

解析方法映射 ：提取这些 Bean 中所有标注了 @RequestMapping 的方法，构建映射关系。

生成 HandlerMethod 对象 ：将每个映射方法封装为 HandlerMethod 对象，包含控制器实例、方法反射信息和请求匹配条件（如 URL、请求方法、请求参数等）。

注册到映射器 ：将 HandlerMethod 对象注册到 RequestMappingHandlerMapping 的内部映射表中。

3. DispatcherServlet 的请求分发

当接收到请求时，DispatcherServlet 会按以下步骤处理：

获取 HandlerExecutionChain：

HandlerExecutionChain handler = getHandler(request);

DispatcherServlet 调用 HandlerMapping 的 getHandler(request) 方法，根据请求 URL 查找匹配的 Handler。

HandlerMapping 返回一个 HandlerExecutionChain 对象，包含 Handler（即 Controller 方法）和相关的拦截器（Interceptor）。

获取 HandlerAdapter：

HandlerAdapter ha = getHandlerAdapter(handler.getHandler());

DispatcherServlet 根据 Handler 的类型，从已注册的 HandlerAdapter 中选择合适的适配器。

例如，RequestMappingHandlerAdapter 用于处理基于注解的 Controller 方法。

执行 Handler：

ModelAndView mv = ha.handle(request, response, handler.getHandler());

HandlerAdapter 调用 Controller 方法，并传递请求参数，获取返回的 ModelAndView。

4. 参数解析与返回值处理

参数解析

HandlerAdapter 通过 HandlerMethodArgumentResolver 解析请求参数：

内置解析器：Spring MVC 提供多种解析器，例如：

RequestParamMethodArgumentResolver：解析 @RequestParam 注解的参数。

PathVariableMethodArgumentResolver：解析路径变量（如 /users/{id}）。

RequestBodyArgumentResolver：解析请求体（如 JSON、XML），需配合 @RequestBody 注解。

自定义解析器 ：可实现 HandlerMethodArgumentResolver 接口自定义参数解析逻辑。

返回值处理

HandlerAdapter 通过 HandlerMethodReturnValueHandler 处理返回值：

内置处理器：例如：

ViewNameMethodReturnValueHandler：处理返回视图名的方法。

ModelAndViewMethodReturnValueHandler：处理返回 ModelAndView 的方法。

ResponseBodyEmitterReturnValueHandler：处理异步返回值（如 ResponseEntity）。

@ResponseBody 注解 ：若方法标注了 @ResponseBody，则通过 HttpMessageConverter 将返回值序列化为响应体（如 JSON）。

5. 示例：从请求到 Controller 的完整流程

假设存在以下 Controller：

@RestController

@RequestMapping("/api/users")

public class UserController {

   @Autowired

   private UserService userService;

   @GetMapping("/{id}")

   public UserDTO getUser(@PathVariable Long id) {

       return userService.getUserById(id);

   }

}

请求流程：

客户端发送请求 GET /api/users/123。

DispatcherServlet 接收请求，调用 RequestMappingHandlerMapping。

HandlerMapping 根据 URL /api/users/123 和请求方法 GET，匹配到 UserController.getUser() 方法。

DispatcherServlet 获取 HandlerAdapter（即 RequestMappingHandlerAdapter）。

HandlerAdapter 解析路径变量 id=123，并调用 UserController.getUser(123)。

Controller 方法返回 UserDTO 对象。

由于 @RestController 隐含 @ResponseBody，HandlerAdapter 通过 HttpMessageConverter 将 UserDTO 序列化为 JSON。

DispatcherServlet 将 JSON 响应返回给客户端。

6. 拦截器与异常处理

拦截器（Interceptor）

在请求到达 Controller 前后，可通过拦截器执行额外逻辑：

实现 HandlerInterceptor 接口：

public class LoggingInterceptor implements HandlerInterceptor {

   @Override

   public boolean preHandle(HttpServletRequest request,

                           HttpServletResponse response,

                           Object handler) {

       // 请求处理前执行（如日志记录、权限校验）

       return true; // 继续执行后续流程

   }

  

   @Override

   public void postHandle(HttpServletRequest request,

                         HttpServletResponse response,

                         Object handler,

                         ModelAndView modelAndView) {

       // 请求处理后、视图渲染前执行

   }

  

   @Override

   public void afterCompletion(HttpServletRequest request,

                               HttpServletResponse response,

                               Object handler,

                               Exception ex) {

       // 完成请求处理（如资源清理）

   }

}

注册拦截器：

@Configuration

public class WebConfig implements WebMvcConfigurer {

   @Override

   public void addInterceptors(InterceptorRegistry registry) {

       registry.addInterceptor(new LoggingInterceptor())

               .addPathPatterns("/api/**"); // 拦截所有 API 请求

   }

}

异常处理

通过 @ControllerAdvice 和 @ExceptionHandler 统一处理异常：

@ControllerAdvice

public class GlobalExceptionHandler {

   @ExceptionHandler(NotFoundException.class)

   public ResponseEntity<String> handleNotFoundException(NotFoundException ex) {

       return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ex.getMessage());

   }

}

总结

Spring MVC 通过 HandlerMapping 实现 URL 到 Controller 方法的映射，通过 HandlerAdapter 统一调用不同类型的 Handler，并借助 参数解析器 和 返回值处理器 完成请求参数和响应数据的转换。整个过程由 DispatcherServlet 协调，配合拦截器和异常处理机制，形成了一个完整的请求处理体系。理解这些机制，有助于更高效地开发和调试 Spring MVC 应用。