您好，登录后才能下订单哦！
密码登录
登录注册
点击 登录注册 即表示同意《亿速云用户服务条款》
# SpringMVC中Controller的查找原理是什么
## 引言
SpringMVC作为Java Web开发中最流行的框架之一，其核心功能是将HTTP请求映射到对应的Controller方法进行处理。理解Controller的查找机制对于深入掌握SpringMVC工作原理、排查请求映射问题以及进行框架扩展都至关重要。本文将全面剖析SpringMVC中Controller的查找原理，从请求进入容器到最终方法执行的完整流程。
## 一、SpringMVC请求处理整体流程
### 1.1 请求生命周期概述
```java
// 简化版请求处理流程示意
1. Http请求到达DispatcherServlet
2. 调用doDispatch()方法
3. 通过HandlerMapping获取HandlerExecutionChain
4. 通过HandlerAdapter执行Handler
5. 返回ModelAndView
6. 视图渲染
作为前端控制器，DispatcherServlet是SpringMVC的核心入口，负责协调各组件完成请求处理：
| 实现类 | 适用场景 | 特点 |
|---|---|---|
| RequestMappingHandler | 注解驱动的控制器 | 支持@RequestMapping |
| BeanNameUrlHandler | 基于Bean名称的映射 | 简单但不够灵活 |
| SimpleUrlHandler | 显式URL到Controller的映射 | 需要手动配置映射关系 |
// AbstractHandlerMapping初始化关键代码
public void initApplicationContext() {
// 1. 初始化拦截器
initInterceptors();
// 2. 注册MappedInterceptor
detectMappedInterceptors();
// 3. 模板方法供子类实现
initHandlerMethods();
}
// RequestMappingHandlerMapping的实现
protected void initHandlerMethods() {
// 扫描所有Bean的元数据
for (String beanName : getCandidateBeanNames()) {
// 处理带有@Controller/@RequestMapping的Bean
detectHandlerMethods(beanName);
}
handlerMethodsInitialized(getHandlerMethods());
}
SpringMVC使用多层数据结构存储映射关系：
Map<RequestMappingInfo, HandlerMethod>
MultiValueMap<String, T> urlMap
Map<String, List<HandlerMethod>> nameMap
URL路径匹配：
HTTP方法过滤：
// RequestMappingInfo的methods匹配逻辑
public boolean matches(MockHttpServletRequest request) {
if (this.methods != null && !this.methods.isEmpty()) {
return this.methods.contains(request.getMethod());
}
return true;
}
请求参数条件检查：
内容类型协商：
SpringMVC按照以下优先级确定最终匹配的处理器：
场景1：路径变量冲突
@GetMapping("/users/{id}")
public String getUser(@PathVariable Long id) {...}
@GetMapping("/users/list")
public String listUsers() {...}
处理流程： 1. 优先尝试精确匹配”/users/list” 2. 失败后尝试模式匹配”/users/{id}”
场景2：HTTP方法不匹配
@PostMapping("/submit")
public String submit() {...}
当GET请求访问/submit时： 1. 路径匹配成功 2. 方法检查失败，返回405
// DispatcherServlet中的处理逻辑
protected HandlerExecutionChain getHandler(HttpServletRequest request) {
for (HandlerMapping hm : this.handlerMappings) {
HandlerExecutionChain handler = hm.getHandler(request);
if (handler != null) {
return handler;
}
}
return null;
}
[preHandle1] -> [preHandle2] -> [Controller方法]
-> [postHandle2] -> [postHandle1]
-> [afterCompletion2] -> [afterCompletion1]
// 异常解析流程示意
try {
handlerAdapter.handle(processedRequest, response, handler);
} catch (Exception ex) {
processHandlerException(request, response, handler, ex);
}
SpringMVC采用多级缓存提升查找效率：
ConcurrentMap<RequestMappingInfo, HandlerMethod>PathMatcher的匹配结果缓存// 自定义组件扫描过滤
@ComponentScan(
includeFilters = @Filter(type=FilterType.ANNOTATION,
classes=Controller.class),
useDefaultFilters = false
)
URL路径错误：
注解配置问题：
Bean加载问题：
// 查看所有注册的映射
@RequestMappingHandlerMapping.getHandlerMethods().forEach((k,v) -> {
System.out.println(k + " => " + v);
});
public class CustomHandlerMapping extends AbstractHandlerMapping {
@Override
protected Object getHandlerInternal(HttpServletRequest request) {
// 实现自定义查找逻辑
}
}
@Autowired
private RequestMappingHandlerMapping handlerMapping;
public void registerDynamicHandler() {
HandlerMethod handlerMethod = new HandlerMethod(/*...*/);
RequestMappingInfo mappingInfo = RequestMappingInfo
.paths("/dynamic")
.methods(RequestMethod.GET)
.build();
handlerMapping.registerMapping(mappingInfo, handlerMethod);
}
SpringMVC的Controller查找机制是一个精密的系统工程，涉及多个组件的协同工作。理解这一原理不仅有助于日常开发调试，更能为框架定制和性能优化提供理论基础。随着Spring框架的迭代，底层实现可能会有所变化，但核心设计思想始终保持一致。
附录：相关源码类图
┌───────────────────────┐
│ HandlerMapping │
└──────────┬────────────┘
△
┌──────────┴────────────┐
│ AbstractHandlerMapping │
└──────────┬────────────┘
△
┌──────────┴────────────┐
│ RequestMappingHandler │
│ Mapping │
└───────────────────────┘
参考文献 1. Spring Framework 5.x 官方文档 2. 《Spring源码深度解析》 3. Spring GitHub仓库源码 “`
注：本文实际约3000字，要达到11350字需要扩展以下内容： 1. 每个章节增加更多实现细节和源码分析 2. 添加更多实际案例和示意图 3. 补充性能测试数据 4. 增加与其他框架的对比分析 5. 扩展异常处理场景 6. 添加历史版本演变分析 7. 增加Spring Boot集成部分 需要继续扩展哪些部分可以告诉我。
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。