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 里写 resultType、parameterType 时,直接写类名就行,不用带包名。"

相关推荐
文丑颜不良啊7 分钟前
LeetCode1461~1480题目解析
java·leetcode
2301_780789668 小时前
跨平台适配!SDK 游戏盾兼容全终端游戏场景
java·网络·ddos
学长毕设9 小时前
基于springboot的食品仓库管理系统
java·spring boot·后端
步行cgn9 小时前
FormHttpMessageConverter 详解:Spring MVC 中表单数据的读写转换器
java·spring·mvc
龙亘川9 小时前
构建城市公共安全数字底座:亘川智城智慧安防系统全维度解读
java·大数据·开发语言·人工智能·信息可视化
金銀銅鐵9 小时前
[Java] 用 CLI 展示 EnumMap 增删键值对时的内部变化
java·源码·ai编程
秋天的怀念_David10 小时前
第二十二夜 · 数字迷雾
java·程序人生·算法
Raas10010 小时前
AI网关部署方案?从部署到上线全流程
java·开发语言·人工智能·gateway·ai网关·企业级ai网关·企业级ai产品
niucloud-admin10 小时前
NIUCLOUD PHP SAAS上门家政使用文档:城市管理
java·前端·php
霸道流氓气质11 小时前
智能客服组件:分层意图识别、RAG Advisor 与人工转接状态机的 Vue3 + Spring AI 生产级实战
java·人工智能·spring