在MyBatis框架中，映射文件（XML）的加载方式直接影响SQL与Java接口的绑定效率。以下是两种常用方式及其原理的详细说明：
一、通过resource属性加载XML映射文件
核心思想
直接通过XML配置文件逐一声明映射文件的相对路径，显式指定资源位置。适用于传统XML配置开发场景。
配置方式
在mybatis-config.xml文件中，使用<mapper>标签的resource属性指定文件路径：
<mappers> <!-- 示例: XML存放在 resources/com/example/mapper 目录下 --> <mapper resource="com/example/mapper/UserMapper.xml"/> </mappers> 特点与约束
- 优点：精确控制单个XML文件的加载位置，灵活放置文件路径。
- 缺点：每个Mapper均需手动配置，项目规模较大时维护成本高。
- 路径规则：路径相对于类路径（
classpath）根目录，通常对应src/main/resources目录结构。
二、通过package扫包加载XML映射文件
核心思想
以包扫描形式批量加载XML，要求接口与XML文件严格遵循命名与路径一致性。适用于注解开发或高度规范化的项目结构。
配置方式
<mappers> <package name="com.example.mapper"/> </mappers> 规则与约束
扫描原理
MyBatis按以下步骤解析：
- 获取包下所有接口：遍历指定包下的
.class文件，识别为Mapper接口。 - 提取接口信息：获取接口全限定名（如
com.example.mapper.UserMapper）。 - 推导XML路径：根据接口路径和名称，拼接出对应XML资源路径（如
com/example/mapper/UserMapper.xml）。 - 验证并加载：检查该路径下是否存在XML文件，若存在则建立绑定关系。
常见问题处理
- 文件缺失：若接口无对应的XML，MyBatis将认为该接口仅使用注解配置。
- 名称/路径不匹配：无法建立绑定关系，导致SQL未定义错误（需严格检查命名）。
- 大小写敏感：在部分操作系统（如Linux）下路径/文件名区分大小写，需确保完全一致。
三、使用场景对比
| 方式 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
resource属性 | XML配置为主、文件布局自由 | 路径灵活，单文件精准控制 | 手动配置繁琐，不易扩展 |
package扫包 | 注解混合开发、项目结构高度统一 | 自动化管理，配置简洁 | 依赖严格命名规范，灵活性低 |
四、混合开发注意事项
若同时使用注解与XML：
- 冲突处理：同一方法若在注解和XML中均定义，优先使用XML中的实现。
- 文件分离：建议将纯注解配置的接口与需要XML的接口分属不同包，便于维护。
通过合理选择加载方式并遵守规范，可显著提升MyBatis的开发效率与维护性。建议根据项目具体需求（如是否以注解为主、团队结构规范程度）灵活选用。
