MyBatis“别名扫描”功能

type-aliases-package 是 MyBatis 的一个"别名扫描"功能,作用一句话就能说完:

让你在 XML 映射文件里写类名时,可以省略全限定名(包名),只写简单类名。


✅ 举个例子(没有配置时)

假设你有这个实体类:

java 复制代码
package com.sky.entity;

public class Employee {
    private Long id;
    private String userName;
}

你在 EmployeeMapper.xml 里写 SQL 时,必须写全类名

xml 复制代码
<select id="getById" resultType="com.sky.entity.Employee">
    SELECT * FROM employee WHERE id = #{id}
</select>

✅ 配置了 type-aliases-package: com.sky.entity

MyBatis 会在 项目启动时 自动扫描 com.sky.entity 包下的所有类,并把它们注册成"别名"------别名就是类名本身(首字母不区分大小写)。

于是 XML 里就可以简写成:

xml 复制代码
<select id="getById" resultType="Employee">
    SELECT * FROM employee WHERE id = #{id}
</select>

✅ 效果:省掉包名,写起来更短,可读性更好。


⚠️ 注意事项

  1. 只能扫描指定包及其子包
  2. 类名必须唯一(不同包下不能有同名类,否则别名冲突);
  3. 如果你用了注解 @Alias("Emp") 显式指定别名,MyBatis 会优先使用注解里的值。

✅ 一句话总结

type-aliases-package: com.sky.entity 就是告诉 MyBatis:

"以后在 XML 里写 resultTypeparameterType 时,直接写类名就行,不用带包名。"

相关推荐
龙虾PRO1 小时前
能源与股票量化核心差异,AI全链路落地实操手册
java·面试·职场和发展
llwszx1 小时前
【Java/Go后端手撸原生Agent(第九篇):Plan-and-Execute规划模式——从“走一步看一步“到“先谋后动“】
java·python·golang·agent开发·plan模式·规划执行模式
ZJH__GO2 小时前
网络编程v2--多客户端互通
java·运维·服务器·开发语言·计算机网络
霸道流氓气质2 小时前
SpringBoot中基于 AES-GCM + KMS 密钥管理的数据加解密 Starter 实践
java·数据库·spring boot
Gofarlic_OMS2 小时前
NX浮动许可调度黑名单机制,对比两款谁更合理
java·大数据·运维·开源·制造
乐观的Terry2 小时前
8、发布系统-完整流水线的核心
java·spring boot·spring·spring cloud
Alexalbb2 小时前
从角色过滤到可审计授权:单体系统数据权限设计复盘与演进
java
万亿少女的梦1683 小时前
基于Spring Boot的游戏交易管理系统设计与实现
java·spring boot·mysql·系统设计·交易管理
闲猫3 小时前
Agent工程实践:从WorkFlow到多Agent协作的落地笔记
java·服务器·前端
笨蛋不要掉眼泪3 小时前
Java虚拟机:常用参数
java·开发语言·python