SpringMVC初始化HandlerMapping浅析

这篇博客详细解析了Spring DispatcherServlet在初始化HandlerMapping的过程,从Servlet的继承关系到初始化方法的调用顺序,特别是如何探测和配置HandlerMapping。当没有定义特定的HandlerMapping时,DispatcherServlet会使用默认的BeanNameUrlHandlerMapping。博客还展示了源代码,说明了如何确保至少存在一个HandlerMapping。

HttpServlet
HttpServletBean
FrameworkServlet
DispatcherServlet

以上是DispatcherServlet的继承关系


初始化HandlerMapper的方法调用过程如下:

org.springframework.web.servlet.HttpServletBean.init()
org.springframework.web.servlet.HttpServletBean.initServletBean()
org.springframework.web.servlet.FrameworkServlet.initServletBean()
org.springframework.web.servlet.FrameworkServlet.initWebApplicationContext()
org.springframework.web.servlet.FrameworkServlet.onRefresh(ApplicationContext)
org.springframework.web.servlet.DispatcherServlet.onRefresh(ApplicationContext)
org.springframework.web.servlet.DispatcherServlet.initStrategies(ApplicationContext)
org.springframework.web.servlet.DispatcherServlet.initHandlerMappings(ApplicationContext)

初始化HandlerMapper函数:

    /**
     * Initialize the HandlerMappings used by this class.
     * <p>If no HandlerMapping beans are defined in the BeanFactory for this namespace,
     * we default to BeanNameUrlHandlerMapping.
     */
    private void initHandlerMappings(ApplicationContext context) {
        this.handlerMappings = null;

        //detectAllHandlerMappings 是否找出所有HandlerMapping
        //如果不是,就只取名为“handlerMapping”的HandlerMapping
        if (this.detectAllHandlerMappings) {
            // Find all HandlerMappings in the ApplicationContext, including ancestor contexts.
            Map<String, HandlerMapping> matchingBeans =
                    BeanFactoryUtils.beansOfTypeIncludingAncestors(context, HandlerMapping.class, true, false);
            if (!matchingBeans.isEmpty()) {
                this.handlerMappings = new ArrayList<HandlerMapping>(matchingBeans.values());
                // We keep HandlerMappings in sorted order.
                OrderComparator.sort(this.handlerMappings);
            }
        }
        else {
            try {
                HandlerMapping hm = context.getBean(HANDLER_MAPPING_BEAN_NAME, HandlerMapping.class);
                this.handlerMappings = Collections.singletonList(hm);
            }
            catch (NoSuchBeanDefinitionException ex) {
                // Ignore, we'll add a default HandlerMapping later.
            }
        }

        //最后,确保有一个HandlerMapping,如果上面都找不到,就拿默认的
        // Ensure we have at least one HandlerMapping, by registering
        // a default HandlerMapping if no other mappings are found.
        if (this.handlerMappings == null) {
            this.handlerMappings = getDefaultStrategies(context, HandlerMapping.class);
            if (logger.isDebugEnabled()) {
                logger.debug("No HandlerMappings found in servlet '" + getServletName() + "': using default");
            }
        }
    }

### Spring MVC 初始化流程详解 Spring MVC 的初始化流程是一个复杂的过程,涉及多个核心组件的加载和配置。以下是对其初始化流程的具体说明: #### 1. DispatcherServlet 加载 `DispatcherServlet` 是 Spring MVC 中的核心前端控制器,在应用程序启动时会自动被加载。它的加载依赖于 `web.xml` 文件中的 `<servlet>` 和 `<servlet-mapping>` 配置[^1]。 当 Web 容器(如 Tomcat)启动时,`DispatcherServlet` 会被实例化并触发其初始化逻辑。这个过程主要包括以下几个阶段: - **读取配置文件**:默认情况下,`DispatcherServlet` 会在类路径下寻找名为 `[servlet-name]-servlet.xml` 的配置文件。如果未找到该文件,则抛出异常。 - **创建上下文环境**:`DispatcherServlet` 创建一个独立的 `WebApplicationContext` 实例,并将其与根上下文(由 `ContextLoaderListener` 或者 `AnnotationConfigWebApplicationContext` 提供)关联起来[^3]。 #### 2. 注册 BeanDefinition 并扫描组件 在 `DispatcherServlet` 初始化完成后,Spring 开始注册各种 BeanDefinition 到 IoC 容器中。这一部分工作主要分为两步: - **Bean 扫描**:通过指定的基础包路径(通常是通过 `@ComponentScan` 注解或者 XML 配置实现),Spring 自动发现所有标注了特定注解(如 `@Controller`, `@Service` 等)的类并将它们注册为 Bean。 - **自定义 Bean 定义**:开发者可以在 XML 配置文件或 Java Config 类中手动声明额外的 Bean,这些也会在此阶段加入到容器中[^5]。 #### 3. 构建 URL 映射表 (HandlerMapping) URL 请求与具体处理器之间的映射关系是由一系列实现了 `HandlerMapping` 接口的对象维护的。在初始化期间,Spring 会按照优先级顺序依次尝试匹配不同的 `HandlerMapping` 实现,直到成功为止。常见的 `HandlerMapping` 包括但不限于: - **RequestMappingHandlerMapping**:用于处理基于 `@RequestMapping` 及其衍生注解的方法级别映射。 - **SimpleUrlHandlerMapping**:支持简单的字符串形式的 URL 路径映射[^2]。 每种类型的 `HandlerMapping` 对象都会构建自己的内部缓存结构——即存储着从 URL 模式到目标 handler 方法之间的一一对应关系的数据结构。 #### 4. 处理器适配器 (HandlerAdapter) 的准备 即使有了清晰的 URL-to-handler 映射规则,还需要一种机制能够实际调用对应的 controller 方法。这就是为什么需要引入 `HandlerAdapter` 这样的概念的原因所在。简单来说,每一个可能成为 handler 的对象都需要有一个专门为其定制的服务代理来完成真正的业务操作执行任务。 对于标准的 spring mvc 应用而言,默认已经内置了几种常用的 adapter ,比如针对 annotation driven controllers 设计出来的 RequestMappingHandlerAdapter 。当然也允许扩展新的 Adapter 来满足特殊需求场景下的功能开发诉求。 --- ```java // 示例代码展示如何配置 DispatcherServlet public class MyWebAppInitializer implements WebApplicationInitializer { @Override public void onStartup(ServletContext container) throws ServletException { AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext(); ctx.register(AppConfig.class); ServletRegistration.Dynamic servlet = container.addServlet("dispatcher", new DispatcherServlet(ctx)); servlet.setLoadOnStartup(1); servlet.addMapping("/"); } } ``` --- ### 总结 综上所述,Spring MVC 的初始化流程涵盖了从基础设置到高级特性的全面覆盖,包括但不限于 dispatcher servlet 启动、bean factory 填充以及 url-pattern 解析等多个重要环节。只有充分理解上述各个组成部分及其相互作用原理才能更好地利用 framework 提供的强大特性去构建高效稳定的应用程序体系架构[^1].
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值