mybatis源码分析之Mapper初始化过程（1）

最新推荐文章于 2025-03-20 11:39:17 发布

原创最新推荐文章于 2025-03-20 11:39:17 发布 · 1k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #mapper #xml

源码同时被 3 个专栏收录

7 篇文章

订阅专栏

mybatis

3 篇文章

订阅专栏

ORM

1 篇文章

订阅专栏

本文详细解析了MyBatis中Mapper的初始化过程，包括如何通过MapperRegistry的addMapper方法注册Mapper，以及MapperAnnotationBuilder的parse方法如何解析XML配置文件、缓存注解等。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

通过分析MapperRegistry类的addMapper方法，可以看出mapper的生成过程以及初始化的机制：

public <T> void addMapper(Class<T> type) {
    if (type.isInterface()) {
      if (hasMapper(type)) {
        throw new BindingException("Type " + type + " is already known to the MapperRegistry.");
      }
      boolean loadCompleted = false;
      try {
        // 每一个mapper，创建一个MapperProxyFactory, 创建一个MapperProxyFactory用于创建自定义mapper接口的代理类
        knownMappers.put(type, new MapperProxyFactory<T>(type));
        // It's important that the type is added before the parser is run
        // otherwise the binding may automatically be attempted by the
        // mapper parser. If the type is already known, it won't try.
        MapperAnnotationBuilder parser = new MapperAnnotationBuilder(config, type);
        // 解析type的class name对于的所有的信息
        parser.parse();
        // 在末尾设一个标志位，用来判断程序是否执行到此处
        loadCompleted = true;
      } finally {
        if (!loadCompleted) {
          knownMappers.remove(type);
        }
      }
    }
  }

从源码中我们可以看出该方法中的parser.parse();的方法是生成和初始化mapper的主要入口，下面是MapperAnnotationBuilder的parse方法：

public void parse() {
    // type是mapper的class信息
    String resource = type.toString();
    if (!configuration.isResourceLoaded(resource)) {
      // 1、解析mapper的xml配置文件信息
      loadXmlResource();
      configuration.addLoadedResource(resource);
      // type.getName=xml文件中的mapper的namespace
      assistant.setCurrentNamespace(type.getName());
      // 2、解析mapper的cache注解
      parseCache();
      // 3、解析mapper中cache的引用
      parseCacheRef();
      // 4、解析mapper类型的所有的方法
      Method[] methods = type.getMethods();
      for (Method method : methods) {
        try {
          // issue #237
          if (!method.isBridge()) {
              // 解析mapper接口的方法的注解信息
            parseStatement(method);
          }
        } catch (IncompleteElementException e) {
          configuration.addIncompleteMethod(new MethodResolver(this, method));
        }
      }
    }
    parsePendingMethods();
  }