【12.MyBatis源码剖析与架构实战】12.SqlSource解析源码剖析-注解的解析⽅式

MyBatis 注解方式 SqlSource 解析源码剖析

除了传统的 XML 配置方式，MyBatis 也支持通过注解（如@Select、@Insert等）直接在 Mapper 接口方法上定义 SQL。在初始化阶段，这些注解会被解析并创建对应的SqlSource和MappedStatement。本文将聚焦于注解方式的 SqlSource 解析过程，完整剖析 MyBatis 初始化阶段如何处理注解配置的 SQL 语句。

一、注解方式整体的解析流程图

MyBatis 初始化阶段，注解方式解析SqlSource的整体流程如下图所示。

二、入口：Mapper 接口的注册

MyBatis 启动时，XMLConfigBuilder会解析mybatis-config.xml中的mappers标签。当遇到mapper标签的class属性时，会走注解解析的路径：

// XMLConfigBuilder.mapperElement()elseif(resource==null&&mapperClass!=null){Class<?>mapperInterface=Resources.classForName(mapperClass);configuration.addMapper(mapperInterface);}

Configuration.addMapper最终调用MapperRegistry.addMapper，为 Mapper 接口创建代理工厂并解析注解：

// MapperRegistry.addMapper()public<T>voidaddMapper(Class<T>type){if(type.isInterface()){if(hasMapper(type)){thrownewRuntimeException("Type "+type+" is already known to the MapperRegistry.");}// 注册映射器代理工厂knownMappers.put(type,newMapperProxyFactory<>(type));// 解析注解类语句配置MapperAnnotationBuilderparser=newMapperAnnotationBuilder(config,type);parser.parse();}}

三、MapperAnnotationBuilder.parse()：主入口

MapperAnnotationBuilder负责解析 Mapper 接口上的注解配置，其parse方法流程如下：

publicvoidparse(){Stringresource=type.toString();// 1. 尝试加载同名的XML配置文件（若有，XML会覆盖注解）if(!configuration.isResourceLoaded(resource)){loadXmlResource();configuration.addLoadedResource(resource);assistant.setCurrentNamespace(type.getName());// 2. 解析 @CacheNamespace 注解parseCache();// 3. 解析 @CacheNamespaceRef 注解parseCacheRef();// 4. 遍历接口中的每个方法，解析方法上的注解Method[]methods=type.getMethods();for(Methodmethod:methods){try{if(!method.isBridge()){