Spring MVC 请求处理全流程：DispatcherServlet 到 View

protected void doDispatch(HttpServletRequest request,
                          HttpServletResponse response) throws Exception {

    HandlerExecutionChain mappedHandler = null;
    ModelAndView mv = null;
    Exception dispatchException = null;

    try {
        // ① 通过 HandlerMapping 找到处理器
        mappedHandler = getHandler(request);

        // ② 通过 HandlerAdapter 调用处理器
        HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());

        // ③ 执行拦截器 preHandle
        if (!mappedHandler.applyPreHandle(request, response)) { return; }

        // ④ 真正调用 Controller 方法
        mv = ha.handle(request, response, mappedHandler.getHandler());

        // ⑤ 执行拦截器 postHandle
        mappedHandler.applyPostHandle(request, response, mv);
    } catch (Exception ex) {
        dispatchException = ex;
    }

    // ⑥ 处理结果（渲染视图 / 写 JSON / 处理异常）
    processDispatchResult(request, response, mappedHandler, mv, dispatchException);
}

// Spring 启动时扫描所有 @Controller / @RestController
// 解析 @RequestMapping，注册到内部映射表：

// 映射表结构（简化）
Map<RequestMappingInfo, HandlerMethod>

// RequestMappingInfo 包含：
//   - URL patterns:    ["/api/users/{id}"]
//   - HTTP methods:    [GET]
//   - headers:         ["Accept=application/json"]
//   - params:          ["type=admin"]
//   - consumes:        ["application/json"]
//   - produces:        ["application/json"]

// HandlerMethod 包含：
//   - bean:            UserController 实例
//   - method:          getUserById() 方法对象

public class HandlerExecutionChain {
    private final Object handler;             // 处理器（HandlerMethod）
    private HandlerInterceptor[] interceptors; // 匹配的拦截器数组
}

protected ModelAndView handleInternal(...) {
    // ① 解析方法参数
    //    @RequestParam → 从 query string / form 取值
    //    @PathVariable → 从 URL 模板变量取值
    //    @RequestBody  → 用 HttpMessageConverter 反序列化
    //    @RequestHeader → 从请求头取值

    // ② 反射调用 Controller 方法
    Object returnValue = method.invoke(bean, args);

    // ③ 处理返回值
    //    @ResponseBody → 用 HttpMessageConverter 序列化为 JSON
    //    String       → 当作视图名交给 ViewResolver
    //    ModelAndView → 包含模型数据和视图名
}

// 常见的参数解析器（按优先级排列）
1. RequestParamMethodArgumentResolver    // @RequestParam
2. PathVariableMethodArgumentResolver    // @PathVariable
3. RequestResponseBodyMethodProcessor    // @RequestBody（兼做返回值）
4. RequestHeaderMethodArgumentResolver   // @RequestHeader
5. ServletRequestMethodArgumentResolver  // HttpServletRequest
6. ModelAttributeMethodProcessor         // @ModelAttribute

@RestController            // = @Controller + @ResponseBody
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.findById(id);
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.save(user);
    }
}

@Controller  // 注意：不是 @RestController
public class PageController {

    @GetMapping("/dashboard")
    public String dashboard(Model model) {
        model.addAttribute("user", currentUser);
        return "dashboard";  // 返回视图名
    }
}

// ViewResolver 解析过程：
// "dashboard" → InternalResourceViewResolver
//             → prefix + "dashboard" + suffix
//             → "/WEB-INF/views/dashboard.html"
//             → 渲染 HTML 写入响应体

spring:
  thymeleaf:
    prefix: classpath:/templates/
    suffix: .html
    cache: false  # 开发时关闭缓存

// 优先级 1：Controller 内的 @ExceptionHandler
@RestController
public class UserController {
    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFound(UserNotFoundException ex) {
        return ResponseEntity.status(404).body(ex.getMessage());
    }
}

// 优先级 2：@ControllerAdvice 全局异常处理
@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleAll(Exception ex) {
        return ResponseEntity.status(500).body(new ErrorResponse(ex));
    }
}

// 优先级 3：HandlerExceptionResolver（框架级别）
// - DefaultHandlerExceptionResolver → 处理 Spring 内部异常
// - ResponseStatusExceptionResolver → 处理 @ResponseStatus

public class LoggingInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest req,
                               HttpServletResponse res,
                               Object handler) {
        // Controller 方法执行前调用
        // 返回 false → 终止请求，不再往下执行
        // 返回 true  → 继续执行下一个拦截器或 Handler
        log.info("Request: {} {}", req.getMethod(), req.getRequestURI());
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest req,
                             HttpServletResponse res,
                             Object handler, ModelAndView mv) {
        // Controller 方法执行后、视图渲染前调用
        // 注意：@ResponseBody 场景下 mv 为 null
    }

    @Override
    public void afterCompletion(HttpServletRequest req,
                                  HttpServletResponse res,
                                  Object handler, Exception ex) {
        // 请求完成后调用（包括异常情况）
        // 适合做资源清理、日志记录
    }
}