Merge branch 'main' of gitee.com:mybatis-flex/mybatis-flex into main

Signed-off-by: 王帅 <1474983351@qq.com>
2025-12-07 00:58:24 +08:00 · 2023-07-15 09:58:01 +00:00 · 2023-07-15 09:58:01 +00:00 · d8aa667ee6
commit d8aa667ee6
parent 3575c6894b 2ce818fae7
28 changed files with 1033 additions and 141 deletions
--- a/changes.md
+++ b/changes.md
@ -1,4 +1,4 @@
-# ChangeLog
+# MyBatis-Flex ChangeLog


 ## v1.4.9 20230713:
@ -251,7 +251,7 @@
 - 优化：Page.java 在传入为 0 的 pageNumber 时添加错误提示
 - 优化：RawValue.java 修改为 RawFragment 以适应更多场景
 - 优化：修改 WrapperUtil.getChildSelect() 方法为 getChildQueryWrapper
- 优化：修改 BaseMapper.selectListByQueryAs 以支持获取 List<Number> 和 List<String>
+- 优化：修改 BaseMapper.selectListByQueryAs 以支持获取 `List<Number>` 和 `List<String>`
 - 优化：工具类添加 private 构造方法。感谢 @王帅
 - 修复：在修改和删除时，schema 配置无效的问题
 - 修复：update 方法应该替换 CachePut 注解为 CacheEvict。感谢 @王帅
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@ -28,7 +28,7 @@ export default defineConfig({
            {text: '帮助文档', link: '/zh/intro/what-is-mybatisflex'},
            {text: '🔥常见问题', link: '/zh/faq'},
            {text: '周边', link: '/zh/awesome-things'},
-            {text: 'ChangeLog', link: 'https://gitee.com/mybatis-flex/mybatis-flex/blob/main/changes.md'},
+            {text: 'ChangeLog', link: '/zh/changes'},
            {
                text: '获取源码', items: [
                    {text: 'Gitee', link: 'https://gitee.com/mybatis-flex/mybatis-flex'},
--- a/docs/deploy.sh
+++ b/docs/deploy.sh
@ -3,6 +3,9 @@
 # abort on errors
 set -e

+# copy changes.md
+cp ../changes.md ./zh/
+
 # build
 npm run docs:build
 #vuepress build .
--- a/docs/zh/awesome-things.md
+++ b/docs/zh/awesome-things.md
@ -5,14 +5,17 @@
 | 项目名称         | 描述                                                                                                                                        | 开源网址                                    |
 |--------------|-------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------|
 | hh-vue       | 这是基于ruoyi-vue改造的项目，对flex完整封装可以参考此项项目                                                                                                      | https://gitee.com/min290/hh-vue         |
-| youcan-solon | 基于solon框架做的一个类似Rouyi的项目，使用flex自带的mybatis-flex-solon-plugin插件做集成，集成方式非常简单，属于即拿即用                                                           | https://gitee.com/gollyhu/youcan-solon  |
+| youcan-solon | 基于 solon 框架做的一个类似 Ruoyi 的项目，使用flex自带的 mybatis-flex-solon-plugin 插件做集成，集成方式非常简单，属于即拿即用                                                           | https://gitee.com/gollyhu/youcan-solon  |
 | Ruoyi-Flex   | Ruoyi-Flex是基于RuoYi-Vue v3.8.6进行的扩展，集成MyBatis-Flex、JDK17、lombok、Sa-Token、PowerJob、Hutool、OSS、ureport-keep、Flowable、vue3、TypeScript等优秀开源软件。 | https://gitee.com/dataprince/ruoyi-flex |

 ## 开发插件

 **Mybatis-Flex IDEA**

-这是一款高度自定义的mybatis-flex idea 代码生成插件，详情：https://www.bilibili.com/video/BV1yV411g7Yd
+这是一款高度自定义的 Mybatis-Flex IDEA 代码生成插件：
+
+- 开源地址：https://gitee.com/djxchi/mybatis-flex-code-gen.git
+- 视频简介：https://www.bilibili.com/video/BV1yV411g7Yd

 ## 视频教程

--- a/docs/zh/base/relations-query.md
+++ b/docs/zh/base/relations-query.md
@ -201,7 +201,28 @@ SELECT `id`, `account_id`, `title`, `content` FROM `tb_book`
 WHERE account_id IN (1, 2, 3, 4, 5)
 ```

+**Map 映射**

+若 `Account.books` 是一个 `Map`，而非 `List`，那么，我们需要通过配置 `mapKeyField` 来指定使用用个列来充当 `Map` 的 `Key`，
+如下代码所示：
+
+```java 9
+public class Account implements Serializable {
+
+    @Id(keyType = KeyType.Auto)
+    private Long id;
+
+    private String userName;
+
+    @RelationOneToMany(selfField = "id", targetField = "accountId"
+        , mapKeyField = "id") //使用 Book 的 id 来填充这个 map 的 key
+    private Map<Long, Book> books;
+
+    //getter setter
+}
+```
+
+> 多对多注解 `@RelationManyToMany` 也是如此。



@ -484,7 +505,12 @@ RelationManager.addIgnoreRelations("idCard","books");
 List<Account> accounts = accountMapper.selectAllWithRelations();
 ```

->`addIgnoreRelations()` 方法的配置，只在当前第一次查询有效，查询后会清除设置。
+>`addIgnoreRelations()` 方法的配置，只在当前第一次查询有效，查询后会清除设置。另外需要注意的是：
+> `addIgnoreRelations()` 的设置，是会影响其所有嵌套的 Relations 配置的。在嵌套的场景中，如果存在同名的属性，
+> 比如 `class A ` 和 `class B` 都有相同的属性 `x`，假设我们想忽略 `class A` 中的 `x` 而 `class B` 的 `x` 不忽略，
+> 那么我们需要添加上类名的前缀，例如：`addIgnoreRelations("A.x")`。
+
+


 ## 附加条件
--- a/docs/zh/changes.md
+++ b/docs/zh/changes.md
@ -0,0 +1,754 @@
+# MyBatis-Flex ChangeLog
+
+
+## v1.4.9 20230713:
+- 新增：Relation 注解支持递归查询的功能及递归深度设置的功能
+- 新增：Relation 注解添加对 vo、dto 等进行关联查询时，可以指定表的配置支持
+- 新增：Relation 注解支持通过中间表进行 join 场景的支持
+- 新增：Relation 注解添加自定义条件 extraCondition 配置的支持
+- 新增：Relation 注解添加可以忽略某个注解查询的支持
+- 新增：数据方言新增对 星瑞格数据库 的支持，感谢 @wujl
+- 新增：BaseMapper.updateByMap() 方法，感谢 @Suomm
+- 新增：QueryWrapper 构建添加 ture、false 常量函数，感谢 @Suomm
+- 优化：静态常量使用 final 修饰，感谢 @meng.liu3
+- 优化：为项目添加 .editorconfig 文件，统一不同作者协助的代码格式化
+- 优化：UpdateWrapper 添加 of 方法，用于替代强转更新
+- 优化：重构 BaseMapper 的文档生成器，感谢 @Suomm
+- 优化：添加码生成器 tableDef 字段排序，感谢 @Suomm
+- 修复：使用 SqlServer 2005 方言查询时出错的问题
+- 修复：selectListWithRelationsByQueryAs 出现数据类型转换异常的问题
+- 修复：Relations 注解在用户定义包装类型时可能导致结果出错的问题
+- 修复：代码生成器配置 setListenerClass 时，结果不正确的问题，感谢 @cainiao3853
+- 修复：APT 功能在使用 gradle 时无法读取配置文件的问题，感谢 @Suomm
+- 文档：更新 Relations 注解的相关文档
+- 文档：调整 ChangeLog 放到首页菜单
+- 文档：完善代码生成器的相关配置文档，感谢 @Suomm
+
+
+
+## v1.4.8 20230709:
+- 新增：`@RelationXXX` 相关注解添加可以指定 dataSource 的配置功能
+- 新增：添加 BaseMapper.insertSelectiveWithPk() 方法
+- 新增：QueryWrapper 构建的 SQL 添加 If, IfNull 支持，感谢 @Suomm
+- 新增：添加 FlexAssert 类，用于常见的异常条件断言，感谢 @Suomm
+- 优化：为 APT 添加 final 关键字以及字段排序的功能，感谢 @Suomm
+- 优化：APT 的 large 字段或者 logicDelete 字段不应被添加在 default_column 中，感谢 @Suomm
+- 优化：移动 BaseMapper.doPaginate 到 MapperUtil，感谢 @Suomm
+- 优化：完善 EntitySqlProvider、RowSqlProvider 等的相关 javadoc 内容，感谢 @Suomm
+- 优化：重构逻辑删除和多租户代码，在必要时其条件应该往前移动 #I7IVCR
+- 优化：移除 RowSqlProvider 不必要的重复的方法
+- 修复：执行 updateByQuery() 未调用 Entity 的 OnUpdate 监听的问题 #I7JDJ2
+- 修复：QueryWrapper 在构建 `属性.in(select from...)` 时出错的问题
+- 文档：补充增删改查新添加的 BaseMapper 的相关方法
+
+
+
+## v1.4.7 20230707:
+- 新增：`@RelationManyToMany` `@RelationManyToOne` `@RelationOneToMany` `@RelationOneToOne` 4 个注解用于关联查询
+- 新增：为 QueryMethods 添加更多的 SQL 函数重载，感谢 @Suomm
+- 新增：代码生成器添加 @Mapper 主键的启用配置，感谢 @Suomm
+- 新增：BaseMapper 添加 selectRowsByQuery() 方法
+- 优化：重构 selectCountByQuery 方法，移除不必要的实现类，感谢 @Suomm
+- 优化：重构 TableInfo.buildResultMap()，防止在某些极端情况出现赋值错误的问题
+- 修复：代码生成器 ControllerGenerator 的 OverwriteEnable 配置不生效的问题
+- 文档：添加关于 QueryMethods 的一些用法和示例，感谢 @Suomm
+- 文档：修改 apt 配置错误的问题，感谢 @Suomm
+- 文档：添加关于 sql 函数的一些函数说明
+- 文档：添加关于关联查询注解的相关文档
+
+
+
+## v1.4.6 20230704:
+- 新增：新增 UpdateWrapper 类，可以通过 entity 转换为 UpdateWrapper 进行数据更新
+- 新增：添加 QueryWrapper.select(QueryColumn[]... queryColumns) 方法
+- 新增：添加 BaseMapper.updateNumberAddByQuery 重载方法，感谢 @Suomm
+- 新增：添加 110+ SQL 常见的函数构建，满足日常开发所需，感谢 @Suomm
+- 优化：对分页查询的 groupby 和 distinct 进一步优化，感谢 @Suomm
+- 优化：对 Row 进行优化，使之更加简单、好用
+- 修复：有父子继承时，如果有相同属性，生成的类中也会有相同的2个属性的问题，感谢 @piggsoft
+- 修复：在某些极端的情况下，由于 MappedStatement 缓存造成的类型转换异常的问题
+- 修复：逻辑删除有 groupBy 和 join 的分页查询时，计算的总量包含已删除数据的问题 #I7HVXT
+- 文档：优化 Field Query 的相关文档
+- 文档：添加关于 UpdateWrapper 使用的相关文档
+- 文档：更新关于 SQL 函数的相关文档
+
+
+
+## v1.4.5 20230703:
+- 新增：添加 sql "CONCAT" 函数的使用支持，感谢 @Suomm
+- 新增：添加 BaseMapper.selectObjectByQueryAs 方法，感谢 @Suomm
+- 新增：添加 @ColumnAlias 注解，并解决在 join query 下可能出现的错误赋值的问题，感谢 @Suomm
+- 新增：添加 MybatisFlexAdminAutoConfiguration 对自动进行 SQL 审计发送的支持，感谢 @Suomm
+- 优化：BaseMapper.selectOne 添加对 map、condition 等自动添加 limit 1 的支持
+- 优化：重构 FunctionQueryColumn 已适配更多的函数，感谢 @Suomm
+- 优化：在某些情况下，执行 SQL 出错没有抛出原生错误的问题
+- 优化：移动 DefaultMessageFactory.getHostIp 到 HttpUtil，感谢 @Suomm
+- 优化：重构 APT 的配置名称。 !!! 破坏性更新
+- 文档：优化由于版本造成的一些错误文档
+- 文档：添加列计算的使用文档和示例
+- 文档：修改某些细节错别字
+
+**APT 配置名称修改如下：**
+- processor.allInTables ---> processor.allInTables.enable
+- processor.tablesPackage ---> processor.allInTables.package
+- processor.tablesClassName ----> processor.allInTables.className
+- processor.mappersGenerateEnable ----> processor.mapper.generateEnable
+- processor.baseMapperClass ---> processor.mapper.baseClass
+- processor.mappersPackage ---> processor.mapper.package
+- processor.tablesNameStyle ---> processor.tableDef.propertiesNameStyle
+- processor.tablesDefSuffix ---> processor.tableDef.instanceSuffix
+- processor.entity.ignoreSuffixes ---> processor.tableDef.ignoreEntitySuffixes
+
+
+## v1.4.4 20230628:
+- 新增：在 SpringBoot 下添加 `@UseDataSource` 对 IService 和 Controller 支持的功能，感谢 @Suomm
+- 优化：IService 中的 saveOrUpdate 保存逻辑应该与同类 save 逻辑保持一致； #I7G8MC
+- 优化：为更多的 Java 代码完善代码注释已经添加  package-info.java，感谢 @Suomm
+- 修复：当使用 ArrayTypeHandler 配置时，出现 NPE 的问题
+- 修复：Brackets 的 containsTable 方法验证错误，导致分页时 count 优化不准确的问题，感谢 @Suomm
+- 文档：优化多数据源的相关文档
+
+
+
+## v1.4.3 20230624:
+- 修复：紧急修复 v1.4.2 Push 到中央仓库无法同步的问题
+
+
+
+## v1.4.2 20230624:
+- 新增：新增数据源加密内容的解密器配置功能
+- 新增：QueryWrapper 添加 with 的 SQL 构建方法;  #I7E19B
+- 新增：新增 MyBatisFlexCustomizer.java 方便用户对 MyBatisFlex 进行初始化配置
+- 新增：AbstractLogicDeleteProcessor 接口，方便用户自定义逻辑删除处理器，感谢 @Suomm
+- 新增：添加 Boolean/Integer/Datetime/TimeStamp 类型的逻辑删除功能，感谢 @Suomm
+- 新增：FlexGlobalConfig 支持通过 Spring 的 application.yml 进行配置的功能，感谢 @Suomm
+- 新增：动态表名添加对 Spring @Configuration 自动配置的支持
+- 新增：多租户 TenantFactory 添加对 Spring @Configuration 自动配置的支持
+- 新增：逻辑删除处理器添加对 Spring @Configuration 自动配置的支持
+- 优化：APT 功能的配置文件由 `mybatis-flex.properties` 移动到根目录下的 `mybatis-flex.config`, !!!破坏性更新
+- 优化：移除部分无用的、注释掉的代码块以及一些未使用的常量等，感谢 @Suomm
+- 优化：完善接口、类或方法相关注释，感谢 @Suomm
+- 优化：maven 编辑添加 latten-maven-plugin + reversion 机制
+- 优化：代码生成器生成辅助类与 APT 生成的类名保持一致，感谢 @Suomm
+- 优化：重构 apt 功能，以及修复可能存在的 NPE 问题，感谢 @Suomm
+- 修复：逻辑删除、多租户等子表过滤应该在 join 不应该在 where 的问题，#I7F03L
+- 修复：禁止全表更新失效的问题，感谢 @Suomm
+- 修复：代码生成器生成策略中的 schema 和 tableConfig 中的 schema 冲突问题，感谢 @Suomm
+- 文档：使用 Spring Boot 项目构建快速开始示例。
+- 文档：更新 pagehelper 配合 mybatis-flex 使用的相关文档，感谢 @Suomm
+- 文档：添加关于 SpringBoot 配置的相关文档，感谢 @Suomm
+- 文档：添加关于数据源加密使用的相关文档
+
+
+
+## v1.4.1 20230620:
+- 新增：分页查询 Page 对象添加否优化 count 查询的选项，感谢 @王帅
+- 新增：添加 LogicDeleteProcessor.java 用于构建自定义的逻辑删除功能
+- 优化：完善后添加类的相关注释、版权信息等内容，感谢 @王帅
+- 优化：QueryColumn 添加构造方法 QueryColumn(String tableName, String name)
+- 修复：Oracle 下的 as 关键字错误的问题
+- 修复：多表联查时，逻辑删除字段和租户字段，只过滤主表，未过滤子表的问题 #I7EV67
+- 修复：低版本 spring-cloud 使用 bootstrap.yml 拉取不到 nacos 中多数据源配置的问题，感谢 @王帅
+- 修复：使用 druid-spring-boot-starter 时 mybatis-flex 多数据源不生效，感谢 @王帅
+- 文档：更新 APT 文档，添加实体类不在同一个包说明，感谢 @王帅
+- 文档：添加找不到依赖 faq 说明，感谢 @王帅
+- 文档：逻辑删除添加关于 LogicDeleteProcessor 的相关文档
+
+
+
+## v1.4.0 20230618:
+- 新增：LogicDeleteManager，用于处理跳过逻辑删除的场景
+- 新增：BaseMapper 新增 insertWithPk 方法，用于插入带有主键的 Entity 数据
+- 新增：left join 等添加对基本类型集合属性的支持，感谢 @王帅
+- 优化：重命名 MaskManager.withoutMask() 方法为 "execWithoutMask"
+- 修复：通过方言动态添加 queryWrapper 条件，出现 No value specified for param 错误的问题
+- 修复：GroupBy FunctionColumns 出现 sql 构建错误的问题
+- 修复：CacheableServiceImpl 无法获取正确的 TableInfo 的问题
+- 修复：远程数据源配置（比如 Nacos）无法正确拉取的问题，感谢 @王帅
+
+
+
+## v1.3.9 20230617:
+- 新增：Db.txWithResult 方法，用于执行有返回结果的事务
+- 优化：更新 OracleDialect 的相关关键字
+- 优化：Page.java 允许传入小于 0 TotalRow 数据
+- 修复：SqlConsts 函数名出错的问题，感谢 @王帅
+- 修复：当 Entity 有泛型的 BaseEntity 时，表构建出错的问题，感谢 @王帅
+- 修复：当 Entity 在不同的包里，APT 生成在一个包的 bug，感谢 @王帅
+- 文档：更新关于事务相关的文档
+- 文档：更新关于数据权限的相关文档
+- 文档：更新关于多表查询的相关文档
+- 文档：新增关于 QueryWrapper 函数构建的相关文档
+
+
+
+## v1.3.8 20230614:
+- 新增：添加 FlexDataSource.removeDatasource() 方法，#I7CQU9
+- 新增：代码生成器添加 Schema 配置的支持，感谢 @Font_C
+- 新增：SQL 构建添加 year/month/day 等更多的函数方法 #I7A7ZA
+- 新增：添加 package-info.java 方便开发者理解包内容，感谢 @王帅
+- 优化：重构 FlexResultSetHandler，使代码更加轻量易懂
+- 优化：重构 TableInfo.buildResultMap，使之在 left join 等场景下减少错误的可能性
+- 优化：likeLeft 和 likeRight 行为替换，使之更加符合查询直觉。!!! 破坏性更新
+- 优化：移除 TableInfo 的 joinTypes 内容
+- 优化：添加 SQL 常量字符串 SqlConsts，对方言等 SQL 进行优化，感谢 @王帅
+- 修复：某些分页场景下出现 "Every derived table must have its own alias" 错误的问题，#I7CUE8
+- 修复：在某些场景下 EnumWrapper.java 出现 NPE 的问题, #I7CWTE
+- 修复：selectListByQueryAs 使用实体类对象导致查询不出来数据，感谢 @王帅
+- 修复：实体类不支持父类为泛型主键的问题，感谢 @王帅 #I7CZGP
+- 修复：代码生成器当配置空的 coment 导致 setTableCommentFormat 出错的问题，感谢 @Font_C
+- 修复：QueryWrapper.clone 并为对 elseValue 进行深度克隆的问题，感谢 @王帅
+- 修复：数据库字段已下划线 _ 开头或者结尾时，生成的 entity 字段配置不正确的问题
+- 文档：添加游标查询的相关文档
+- 文档：faq 新增更多的常见问题
+- 文档：添加更多代码生成器相关的文档
+
+
+
+## v1.3.7 20230612:
+- 新增：添加 QueryWrapper.select(String) 和 QueryWrapper.select(lambda) 方法
+- 新增：添加 UseDataSource 注解对 mapper 类作用的支持
+- 新增：QueryWrapper 的 clone() 方法，方便用于深度复制当前的 QueryWrapper，感谢 @王帅
+- 优化：在 id 没有 setter 的情况下，错误信息不明确的问题，感谢 @chenjian835
+- 优化：修改 CPI 注释内容错别字的问题，感谢 @Alex
+- 优化：修改 QueryCondition 的 "before" 属性为 "prev"
+- 优化：重构 case when 的构建功能，方便其进行序列化
+- 优化：DistinctQueryColumn 构建 SQL 多出一个空格的问题
+- 优化：使用 QueryWrapper.select() 无参方法时，方法调用不明确的问题，感谢 @王帅
+- 优化：代码生成器提取 lombok 的配置到模板，方便用户自定义模板功能，感谢 @王帅
+- 修复：field query 方式不支持集合子类型的问题，感谢 @王帅
+- 修复：分页查询中有 group by 和 distinct 的 count 查询有误的问题，感谢 @王帅
+- 修复：在 select ... from(select...) 中，子查询没有括号导致 sql 解析错误的问题，感谢 @王帅
+- 修复：updateNumberAddByQuery 在传入小数点数据时，出错的问题
+- 文档：修改 QueryWrapper 的部分错别字，感谢 @锟斤拷
+- 文档：更新一对多、多对一的相关文档
+- 文档：更新多数据源的相关文档
+
+
+
+## v1.3.6 20230609:
+- 新增：QueryWrapper 添加对 Lambda 构建的支持
+- 新增：APT 添加 processor.tablesDefSuffix 配置 Table 后缀的支持
+- 新增：多表查询支持自动映射实体类中的 association 和 collection 类型，感谢 @王帅
+- 新增：BaseMapper.selectCursorByQuery() 用于游标查询的支持
+- 优化：QueryColumn 添加一个 QueryTable 参数的构造器
+- 优化：移动 BaseMapper.__queryFields() 方法到 MapperUtil
+- 优化：修改 QueryWrapper 的 leftJoinIf 方法为 leftJoin
+- 修复：代码生成器 EnjoyTemplate 出现 IllegalAccessException 错误的问题
+- 修复：修复 Oracle 批量新增出现 SQL 语法错误的问题
+- 修复：QueryWrapper 不能使用超过一次的问题 https://github.com/mybatis-flex/mybatis-flex/issues/49
+- 文档：QueryWrapper 文档添加关于 APT 的说明
+- 文档：QueryWrapper 文档添加 Lambda 构建的代码示例
+- 文档：一对多添加关于自动映射的相关文档，感谢 @王帅
+
+
+
+## v1.3.5 20230606:
+- 新增：代码生成器添加生成 spring-cache 缓存模板配置。感谢 @王帅
+- 新增：Db + Row 添加 schema 的支持。感谢 @Font_C
+- 新增：IService 添加 pageAs 方法。感谢 @王帅
+- 新增：添加更多 column 工具方法
+- 优化：Page.java 在传入为 0 的 pageNumber 时添加错误提示
+- 优化：RawValue.java 修改为 RawFragment 以适应更多场景
+- 优化：修改 WrapperUtil.getChildSelect() 方法为 getChildQueryWrapper
+- 优化：修改 BaseMapper.selectListByQueryAs 以支持获取 `List<Number>` 和 `List<String>`
+- 优化：工具类添加 private 构造方法。感谢 @王帅
+- 修复：在修改和删除时，schema 配置无效的问题
+- 修复：update 方法应该替换 CachePut 注解为 CacheEvict。感谢 @王帅
+- 修复：代码生成器生成的缓存 Service 缓存 key 错误的问题。感谢 @王帅
+- 修复：错别字 taked 修改为 took。感谢 @王帅
+- 文档：完善代码生成器的相关文档。感谢 @王帅
+- 文档：同步 IService 最新的文档，删除旧版本的一些方法。感谢 @王帅
+- 文档：修复 sqlSessionTemplate 错别字的问题。感谢 @阿志同学
+- 文档：添加关于 QueryWrapper 序列化的相关文档
+- 文档：继续完善 "常见问题" 的相关文档
+
+
+
+## v1.3.4 20230601:
+- 新增：添加 Spring 下的 CacheableServiceImpl 实现类，方便用户缓存。感谢 @王帅
+- 优化：重构 IService，使之有更好的方法服用。感谢 @王帅
+- 优化：重命名 QueryWrapper 的 "toDebugSQL()" 方法名为 "toSQL()"
+- 修复：当使用 QueryWrapper 未指定 from 时，schema 出错的问题
+- 修复：当配置 config-location 时，出现 IllegalArgumentException 错误的问题
+- 修复：case when else 中出现的 column 无法转换的问题 #I7A0B0
+- 文档：添加关于 CacheableServiceImpl 使用的一些文档。感谢 @王帅
+
+
+
+## v1.3.3 20230530:
+- 新增：添加动态表名和动态 Schema 的支持 #I6VRMF #I6WS3E #I72X21
+- 新增：添加 @Table(schema=xxx) 配置的支持 #I6VD6U
+- 新增：Left join 等关联查询时，支持直接赋值对象属性的功能
+- 新增：添加 QueryWrapper.toDebugSQL() 方法，方便用于调试
+- 优化：Entity 父子类定义了相同字段时，应已子类优先
+- 优化：对逻辑删除定义的非 Number 和 Bool 类型的 SQL 构建优化
+- 优化：升级 MyBatis 到 3.5.13 最新版本
+- 优化：升级 MyBatis 后，删除冗余的 FlexXMLConfigBuilder 实现
+- 优化：升级 solon 版本，以支持原生编译功能，感谢 @西东
+- 修复：分页查询在 left join 优化是，错误移除的问题
+- 文档：优化 多表查询 的相关文档
+- 文档：添加枚举属性构建 QueryWrapper 的相关文档
+- 文档：添加自定义 MyBatis 的 Configuration 的文档
+- 文档：添加动态表名和动态 Schema 的相关文档
+
+
+
+## v1.3.2 20230528:
+- 新增：select (field1 * field2 * 100) as xxx from ... 的 SQL 构建场景
+- 优化：ClassUtil.wrap 方法修改为 getWrapType
+- 优化：重构 BaseMapper.selectListByQueryAs() 方法，使其更加通用
+- 优化：重构 EnumWrapper.java，使之方法和变量更加明确易读
+- 优化：WrapperUtil.buildAsAlias 方法，使之在多种场景下有统一行为
+- 优化：优化 Row，添加 prepareAttrs() 等方法
+- 修复：EnumWrapper 对其 getter 方法判断错误的问题
+- 文档：更新一对多、多对一的子查询相关文档
+
+
+
+## v1.3.1 20230526:
+- 新增：分页查询添加关联字段查询功能；
+- 新增：Mapper 添加 updateNumberAddByQuery 方法，用于 update table set xxx = xxx + 1 的场景；
+- 优化：添加 FieldWrapper 使得关联字段查询拥有更高的性能
+- 优化：优化 EnumWrapper 使之逻辑更加清晰简单
+- 优化：字段子查询不在需要配置 type
+- 优化：代码生成器 remarks 修改为 comment; 感谢 @王帅
+- 优化：代码生成器 GlobalConfig 拆分，使之更加直观; 感谢 @王帅
+- 优化：代码生成器新增注释生成配置； 感谢 @王帅
+- 优化：代码生成器新增 mapper xml 生成功能； 感谢 @王帅
+- 优化：代码生成器新增 package-info.java 生成功能； 感谢 @王帅
+- 优化：代码生成器新增 Controller 生成功能； 感谢 @王帅
+- 优化：代码生成器每个生成的文件，单独支持是否覆盖已生成的文件； 感谢 @王帅
+- 优化：代码生成器新增设置模板文件位置，可以使用指定的模板生成文件； 感谢 @王帅
+- 修复：select max(select(...)) 等函数内部有参数时，无法获取的问题；
+- 文档：更新代码生成器文档。感谢 @王帅
+- 文档：优化 QueryWrapper 的相关文档
+
+
+
+## v1.3.0 20230525:
+- 新增：新增 一对多、多对一 查询功能
+- 新增：为 SqlServer 添加独立的 LimitOffset 处理器
+- 新增：QueryWrapper 新增 "for update" 的 SQL 构建支持
+- 新增：QueryWrapper 新增 select convert(...) 的 SQL 构建支持
+- 新增：QueryWrapper 新增 select case when ... then 的 SQL 构建支持
+- 优化：APT 默认生成独立文件，之前所有 APT 生成在同一个文件修改为可配置
+- 修复：Table.camelToUnderline 注解在 APT 上配置不生效的问题
+- 修复：多租户设置 TenantId 时，在某些极端情况下出现异常的问题
+- 文档：新增 一对多、多对一 的相关文档
+- 文档：新增 select case when ... then 的 QueryWrapper 示例
+- 文档：添加关于 hint 的相关描述
+
+
+
+## v1.2.9 20230523:
+- 新增：字段添加对 Byte.class 类型的支持 #I76GNW
+- 修复："select * ,(select ...) from ..." 第二个 select 有参数时出错的问题
+- 修复：QueryCondition 在 left join 查询是出现 NPE 的问题
+- 修复：修改 QueryWrapper 添加 limit(1) 时，SQLServer 方言构建 SQL 出错的问题
+- 修复：修改 TDENGINE 方言出错的问题
+- 修复：baseMapper.selectOneByQueryAs() 查询出错的问题
+- 修复：当自定义 TypeHandler 时，通过 UpdateEntity 更新时，TypeHandler 无效的问题
+- 优化：重构 TableInfo.appendConditions() 代码
+- 优化：修改错别字 "那些" 为 "哪些"
+- 文档：更新 "Mybatis" 为 "MyBatis" #I72DWO
+- 文档：添加使用 druid-spring-boot-starter 出错到常见问题里
+
+
+
+## v1.2.8 20230522:
+- 新增：新增 select id,(select...) from 的支持
+- 优化：Solon 插件增加 RowMapperInvoker 注入和 FlexGlobalConfig 可事件扩展的支持，感谢 @西东
+- 优化：分页的 count 查询默认去掉 left join 和 order by 等
+- 优化：APT 的 ALL_COLUMNS 修改 table.*
+- 文档：添加 hint 的相关文档
+- 文档：优化 mybatis-flex-solon-plugin 的使用文档
+- 文档：优化 queryWrapper 的相关文档
+
+
+
+## v1.2.7 20230520:
+- 新增：添加 solon 关于 ServiceImpl 的实现
+- 新增：left join 等 join 查询添加 as(lambda) 的支持
+- 优化：优化 EnumWrapper.java 使之具有更高的性能
+- 优化：迁移 IService 到 core 目录
+- 优化：重命名 Db.updateBatchEntity 为 Db.updateEntitiesBatch
+- 修复：逻辑删除设置 bool 类型在 postgresql 下出错的问题
+- 文档：添加批量操作的相关文档说明
+- 文档：添加关联查询的相关文档
+
+
+
+## v1.2.6 20230518:
+- 新增：IService 添加 updateBatch 方法，感谢 @Saoforest
+- 优化：findById 默认返回 isLarge 的字段 #I73SJY
+- 优化：WrapperUtil.getValues() 并直接读取枚举内容
+- 修复：ClassUtil 修复无法正确读取 JDK 动态代理超类问题，感谢 @Saoforest
+- 修复：批量执行每一个批次会少 1 条数据的问题，感谢 @笨小孩
+- 文档：添加数据权限的相关文档
+
+
+
+## v1.2.5 20230517:
+- 新增：Db.executeBatch 方法，用于批量操作
+- 新增：Db 工具类添加基于 Entity 的 updateBatch 方法，感谢 @黄沐鸿
+- 新增：KeyGenerators.java 方便进行主键生成策略配置
+- 新增：APT 的 mybatis-flex.properties 文件添加使用 ClassLoader 读取，方便读取 jar 的内容，感谢 @XiaoLin
+- 新增：QueryWrapper 新增 hash join 的支持
+- 新增：QueryWrapper 新增 sql hint 的支持
+- 优化：添加 configuration-processor，实现 yaml 配置自动提示，感谢 @tan90
+- 修复：v1.2.4 新增的 paginateAs 异常问题 #I73BP6
+- 修复：v1.2.4 版本造成的 Db.paginate 出错的问题
+- 文档：优化 id 主键生成器的相关文档
+
+
+
+## v1.2.4 20230515:
+- 新增：Db.updateBatch() 方法，用于批量修改或者插入等场景
+- 新增：通过雪花算法生成数据库主键，内置雪花算法，感谢 @王帅
+- 新增：QueryCondition 可以直接传入枚举变量，自动读取 @EnumValue
+- 新增：代码生成器添加 Service、ServiceImpl、Controller 的生成功能，感谢 @王帅
+- 新增：Db 和 BaseMapper 添加 selectObject 和 selectObjectList 等方法
+- 新增：BaseMapper 添加 selectOneByQueryAs 等方法，方便在 left join 等场景直接转换为 dto vo 等;
+- 优化：不变属性添加 final 关键字，感谢 @庄佳彬
+- 优化：修改拼写错误，processer->processor， 感谢 @庄佳彬
+- 优化：Page.of() 方法
+- 优化：为 IService.java 添加常用的方法
+- 优化：修改 SqlUtil.retBool 为 SqlUtil.toBool
+- 修复：orderBy 参数里传入 null 或者 空值，就会抛出异常的问题 #23
+- 文档：优化 mybatis-flex.com 的目录结构
+- 文档：新增内置主键生成器说明文档，感谢 @王帅
+- 文档：修正数据脱敏中的一些描述错误
+- 文档：IService 文档添加代码示例
+- 文档：优化 "部分字段更新" 的相关文档
+- 文档：更新代码生成器的相关文档，感谢 @王帅
+- 文档：添加关于 BaseMapper 进行关联查询的相关文档
+- 文档：添加在 Spring 的场景下使用 @Transactional 注解的注意事项
+
+
+
+## v1.2.3 20230511:
+- 新增：MaskManager 添加 withoutMask 模板方法，感谢 @pengpeng
+- 新增：TenantManager 添加 withoutTenantCondition 模板方法，感谢 @pengpeng
+- 新增：代码生成器添加 GlobalConfig.others 属性，方便自定义 generator 的配置
+- 修复：v1.2.2 使用 @Transactional 出现的 Can't call commit 的问题 #I71X6X
+- 文档：纠正错别字 "事物" 为 "事务"
+- 文档：更新代码生成器的相关文档
+
+
+
+## v1.2.2 20230510:
+- 新增：增强 Service 及其实现类，感谢 @王帅
+- 修复：where子句无任何符合的条件时，逻辑删除字段处理错误 #I70OIA
+- 修复：在使用事务的情况下，无法切换数据源的问题 #I70QWU
+- 修复：Entity 有配置 typeHandler 时，通过 RowUtil.toEntity 转换异常的问题 #I70XGX
+- 文档：代码生成器添加生成其他产物的相关文档
+- 文档：新增顶级 Service 接口说明文档，感谢 @王帅
+- 文档：常见问题添加关于 PageHelper 集成的相关文档
+
+
+
+## v1.2.1 20230506:
+- 新增：代码生成器添加 tableDef 的生成功能；感谢 @笨小孩
+- 新增：增指定批次批量删除的方法，防止请求时间过长异常；感谢 @笨小孩
+- 优化：Mapper 配置所对应的 XML 文件 增加默认值；感谢 @lhzsdnu
+- 优化：拆分APT模块, 优化APT配置说明；感谢 @snow
+- 优化：添加  ClassUtil.isArray  方法用于重构
+- 优化：重命名 UpdateEntity.wrap 为 UpdateEntity.of #I6Z7HK
+- 优化：重构 OracleDialect 默认不加双引号；感谢 @MyronLi
+- 优化：重构代码生成器模块，新增 IGenerator 接口
+- 优化：修改 BaseMapper 的一些注释错误
+- 修复：Oracle 下查询报错的问题 #I6Z7K4
+- 修复：insertSelective 报错的问题 #12
+- 修复：全局监听器父类注册是接口时无法触发监听器 #17
+- 修复：因 @NotBlank(message = "xxx") 到 QueryColumn 无法生成的问题 #I6ZPD1
+- 修复：不支持自己扩展 mapper 的问题 #I6ZTS3
+- 修复：Db + Row 工具的使用枚举映射异常问题 #I6ZW2G
+- 修复：批量新增逻辑删除字段有问题 #I6ZX5N
+- 修复：left join (select ...) 子查询参数解析错误 #I709S1
+
+
+
+## v1.2.0 20230426:
+- 新增：FlexGlobalConfig.setDefaultConfig 方法，使其扩展更加灵活，用于适配 solon
+- 新增：BaseMapper.insertBatch(entities,size) 方法，自定义分批插入；感谢 @庄佳彬
+- 新增：Entity 的监听器可以配置为父类 BaseEntity 的支持
+- 新增：Apt 添加自定义 字段名命名风格 的支持 #I6YGRG
+- 修复：processor.tablesClassName 配置不起作用的问题；感谢 @玩具猫
+- 修复：left join 关联查询 on 有第二个条件赋值错误的问题； #I6YT2R
+- 修复：审计日志中赋值异常的问题 #I6Z1R8
+- 修复：修复 createIdKeyGenerator 对 keyType.None 判断错误的问题
+- 优化：修改 @Table 注解，删除其 @Inherited
+- 文档：重构文档结构、使之更加清晰；感谢 @snow
+- 文档：同步新版本 apt 功能文档
+
+
+
+## v1.1.9 20230424:
+- 新增：根据 id 查询数据时，返回默认字段而非全部字段；感谢 @wnp
+- 新增：APT 添加忽略 entity 后缀的配置支持
+- 修复：where 中第一个括号处理不正确的问题  #I6XXWR
+- 修复：批量插入且配置 onInsert 时，出现错误的问题
+- 修复：批量插入 row，且为 row 设置主键时，出错的问题 #I6Y8ZU
+- 修复：Oracle 在某些情况下出现 SQLSyntaxErrorException 错误的问题 #I6Y6MZ
+- 修复：RowUtil.printPretty 在某些情况下显示数据不正确的问题
+- 修复：APT 无法生成 @NotBlank 注解字段的问题
+- 优化：更新 apt 的 mappersGenerateEnable 默认值为 false
+- 文档：优化 APT 的相关文档
+- 文档：优化 快速开始 的相关文档
+- 文档：添加 column 全局配置的相关文档
+
+
+
+## v1.1.8 20230422:
+- 新增：添加 RowUtil.printPretty() 方法，用于调试
+- 新增：代码生成器生成代码默认添加注释的功能
+- 新增：添加 BaseEntity.insertSelective() 方法  #I6XS9Z
+- 修复：子查询时，逻辑删除字段的未添加逻辑删除字段 #I6X4U8
+- 修复：TransactionTemplate.execute 失效的问题 #I6XSHH
+- 修复："EXIST" 关键字错误的问题 #I6XTVB
+- 优化：Row 添加列序号的功能，数据库返回结果相同列不再覆盖
+- 文档：添加 使用 Mybatis 原生功能的相关文档
+- 文档：添加 支持的数据库类型 的相关文档
+- 文档：Db + Row 添加 left join 转换 entity 的文档
+- 文档：优化 快速开始 的相关文档
+- 文档：APT 文档添加关于 Gradle 构建的一些内容
+
+
+
+## v1.1.7 20230421:
+- 优化：将 ConsoleMessageCollector 的 getFullSql 方法移入 AuditMessage，方便重用 感谢 @pengpeng
+- 修复：配置 mybatis-flex.mapper-locations 在某些场景下会出现 NPE 的问题 #I6X59V
+- 修复：子查询时，子 SQL 的逻辑删除字段未添加 #I6X4U8
+- 修复：启用乐观锁 和 逻辑删除时，在某些极端情况下会出现 argument type mismatch 异常的问题 感谢 @pengpeng
+- 文档：APT 添加和 Lombok、Mapstruct 整合的文档
+- 文档：完善补充 "打印SQL" 的相关文档
+
+
+
+## v1.1.6 20230419:
+- 新增：QueryCondition 添加 when(Predicate) 方法，感谢 @落羽er
+- 新增：代码生成器 ColumnConfig 添加 tenantId 字段配置，用于代码生成时添加 @Column(tenantId=true) 注解，感谢 @pengpeng
+- 新增：代码生成器 TableConfig 添加 mapperGenerateEnable 配置，感谢 @pengpeng
+- 新增：代码生成器添加 IDialect.MYSQL 方言
+- 优化：FlexEnumTypeHandler.java 完善对 public field 的读取
+- 优化：代码生成器生成 java 文件时，打印生成目录
+- 修复：flex 和 lombok 以及 mapstruct 同时使用时，APT 配置文件不生效的问题。 #I6WTN6
+- 修复：使用 QueryMethods.count() 时出错的问题。#I6X2M6
+- 文档：修改 SQL 审计模块的文档错误，感谢 @lhzsdnu
+
+
+
+## v1.1.5 20230418:
+- 新增：增加对 @Table 自动生成 Mapper 的控制属性 mapperGenerateEnable。感谢 @草语
+- 新增：QueryCondition 自动忽略 null 值的功能 #I6WCS9
+- 新增：增加 APT Mapper 自动生成时，可通过 mybatis-flex.properties 自定义父类的支持。感谢 @草语
+- 新增：代码生成添加自定义 BaseMapper 的支持
+- 优化：重构移除 RowSessionManager
+- 优化：重命名 DbAutoConfiguration 为 FlexTransactionAutoConfiguration
+- 优化：优化 FlexEnumTypeHandler 未找到 getter 方法时的错误提示
+- 优化：优化自定义逻辑删除内容可能存在错误的一些问题
+- 修复：在某些场景下，动态条件时，生成的 SQL 错误  #I6W89G
+- 修复：在某些情况下，枚举属性出现异常的问题 #I6WGSA
+- 文档：优化事务相关的文档
+- 文档：添加枚举属性的相关文档
+- 文档：修改 SQL 打印的文档错误
+- 文档：APT 添加关于关闭 mapper 生成的文档
+- 文档：queryWrapper 添加特别注意事项的内容
+
+
+
+## v1.1.4 20230417:
+- 新增：添加逻辑删除的自定义内容配置功能
+- 新增：Entity 添加枚举属性的支持
+- 新增：BaseMapper 新增 insertOrUpdate() 方法
+- 新增：事务添加 Propagation 参数配置的支持
+- 新增：为 Spring 适配 @Transactional 注解的支持
+- 修复：租户模式下，deleteBatchByIds 报错的问题
+- 修复：ProviderUtil NPE 的问题
+- 修复：APT 和 TableInfo 构建多出静态变量的问题
+- 文档：完善逻辑删除的相关文档
+- 文档：修改 ignoreNulls 描述错误的问题
+
+
+
+## v1.1.3 20230414:
+- 新增：代码生成器生成的 entity 可以支持配置父类和实现的接口
+- 修复：在某些场景下出现 Recursive update 错误的问题
+- 修复：Entity 继承父类，但是 APT 生成的代码没有父类字段的问题
+- 修复：QueryWrapper unionAll 报错的问题
+- 修复：修复多租户的场景下 union 的子查询不添加租户 ID 的问题
+
+
+
+## v1.1.2 20230413:
+- 新增：QueryCondition 的 and(string) 和 or(string) 方法
+- 新增：Page.map() 方法用于 Page 数据转换
+- 新增：SQL 审计新增数据返回行数和自定义业务ID的支持
+- 新增：Row 新增 Row.toObject() 方法，用于转换为 VO 对象
+- 新增：RowUtil.java 工具类，用于 Row List 数据转换
+- 新增：代码生成器添加配置 Mapper 前后缀配置的功能
+- 新增：代码生成器添加配置 entity 前后缀配置的功能
+- 优化：重构 MultiDataSourceAutoConfiguration.java
+- 优化：重命名 Page.list 为 Page.records
+- 优化：当配置了错误的数据库账号和密码，错误提示不友好的问题
+- 优化：重命名 "MessageCreator" 为 "MessageFactory"
+- 优化：重命名 RawValue.context 为 content
+- 修复：ClassUtil 无法实例化被 lombok @Data() 修饰的 entity 的问题
+- 修复：MybatisKeyGeneratorUtil.java 空指针的问题
+- 修复：Springboot3 NestedIOException 找不到的问题
+- 修复：QueryCondition 的值为 QueryColumn 或 RawValue 时错处的问题
+- 修复：在某些场景下可能出现 Recursive update 的问题
+- 文档：新增 Mybatis-Flex 和其他框架性能对比的文档
+- 文档：添加整合 Springboot3 可能出现的问题帮助
+
+
+
+## v1.1.0 20230412:
+- 新增：Entity 的 onSet、onUpdate、onInsert 添加全局监听器的配置
+- 优化：移除 QueryColumn.isNull 和 isNotNull 的参数
+- 优化：重构 CustomKeyGenerator 的部分代码
+- 修复：UpdateEntity 工具类在某些场景下出错的问题
+- 修复：审计消息 AuditMessage 在 entity 配置 typeHandler 时，获取的参数不正确的问题
+- 文档：添加 entity 全局监听器的相关文档
+
+
+
+## v1.0.9 20230410:
+- 新增：新增 多租户 使用的相关模块
+- 新增：BaseMapper 添加 deleteByCondition 和 updateByCondition 方法
+- 新增：添加 paginate 的更简单易用的相关方法
+- 新增：QueryMethods 添加 column() 方法
+- 新增：ConsoleMessageCollector 用于在控制台输出 SQL 及其执行时间
+- 新增：QueryWrapper 添加 union 和 union all 的支持
+- 新增：mybatis-flex-solon-plugin 插件，方便在 solon 框架下使用
+- 修复：@Table(onSet) 配置在某些场景无法使用的问题
+- 修复：Postgresql 的 limit offset 方言出错的问题
+- 修复：多数据源的场景下，通过 @Table(dataSource) 配置无效的问题
+- 优化：修改错别字 processer 为 processor
+- 优化：优化 DbAutoConfiguration 未正确配置数据源时的错误信息
+- 优化：Row 添加 getString()/getInt() 等等相关方法
+- 优化：代码生成器通过 SqlServer 生成出错的问题
+- 文档：优化 QueryWrapper 的相关文档
+- 文档：优化 SQL 审计的相关文档
+- 文档：添加 SQL 控制台打印输出的相关文档
+- 文档：添加多租户的相关文档
+- 文档：优化逻辑删除的相关文档
+
+
+
+## v1.0.7 20230406:
+- 新增：BaseMapper 添加可以直接根据 Condition 查询的方法，更加方便
+- 新增：Db 添加可以直接根据 Condition 查询的方法，更加方便
+- 新增：代码生成器添加 @Table(onSet) 的配置
+- 新增：添加 HttpMessageReporter，用于可以往服务器发送审计日志
+- 优化：APT 生成的 java 属性默认使用下划线的方式
+- 优化：优化 APT 生成 mapper 的默认存放路径
+- 优化：重命名 QueryEntityProcesser 为 QueryEntityProcessor
+- 文档：添加字段权限的相关文档
+- 文档：添加字典回写的相关文档
+- 文档：添加字段加密的相关文档
+- 文档：添加 Mybatis-Flex 与同类框架对比的文档
+
+
+
+## v1.0.6 20230403:
+- 新增：新增多数据源的支持
+- 新增：Db.tx() 的事务提交方法
+- 新增：RawValue 类，用于一些不需要进行 Sql 编译的场景
+- 新增：@Table() 注解，添加 onSet 配置，用于监听 entity 被设置内容
+- 新增：添加独创的 FlexIDKeyGenerator ID 生成器，用于分布式 ID 生成
+- 优化：重命名 TableInfos 为 TableInfoFactory
+- 优化：重命名审计日志的 "extTime" 为 "queryTime"
+- 修复：AuditManager 在某些场景下会出现空指针的问题
+- 文档：添加多数据源的相关文档
+- 文档：添加事务管理的相关文档
+- 文档：添加与 Spring 整合的相关文档
+- 文档：优化 Db + Row 的相关文档
+- 文档：QueryWrapper 添加关于 join 的更多示例
+- 文档：添加关于 APT 使用的相关文档
+- 文档：优化 readme 和 快速开始的相关文档
+
+
+
+## v1.0.5 20230330:
+- 新增：新增 SQL 审计模块，默认关闭
+- 新增：代码生成器新增 lombok 配置的支持
+- 新增：代码生成器新增可以配置多个表前缀的支持
+- 新增：代码生成器添加 SqliteDialect 方言的支持
+- 新增：代码生成器添加自定义 Entity 属性类型的配置支持
+- 优化：修改方法 "deleteByByMap" 为 "deleteByMap"
+- 优化：修改方法 "Db.insertRow()" 为 "Db.insert()"
+- 修复：在某些场景下，Row.toEntity() 出现类型转换错误的问题
+- 修复：queryWrapper 的 "in" 逻辑在某些场景下错误的问题
+- 修复：代码生成器对 Mysql 的 "blob" 类型生成错误的问题
+- 文档：新增关于代码生成器的相关文档
+- 文档：新增 SQL 审计模块的相关文档
+- 文档：优化 queryWrapper 的相关文档
+- 文档：优化 分页查询 的相关文档
+
+
+
+## v1.0.4 20230326:
+- 新增：@ColumnMask() 注解用于数据脱敏，内置 9 中脱敏方式
+- 新增：BaseMapper.selectAll() 方法
+- 新增：BaseMapper.selectListByMap(Map whereConditions, int count) 方法
+- 新增：添加 resource 配置，使得生成的代码自动集成到 classpath 中。 感谢 @piggsoft
+- 新增：mybatis-flex-codegen 模块，用于 数据库-> Java 的代码生成
+- 新增：@Table() 注解添加 OnInsert 和 OnUpdate 的配置支持
+- 文档：新文档站点 https://mybatis-flex.com 上线
+
+
+
+## v1.0.3 20230321:
+- 新增：APT 自动生成 Mapper 代码的功能，无需在手动编写
+- 新增：APT 新增 "processer.mappersGenerateEnable" 配置，用于开启是否自动生成 Mapper 类
+- 修复：condition.when(flag) 的 value 值有返回的问题
+- 文档：添加 where 动态条件文档示例，同步 APT 的文档
+
+
+
+## v1.0.2 20230317:
+- 新增：添加自定义字段 typeHandler @Column(typeHandler=xxx) 的配置
+- 新增：内置默认的  fastjson fastjson2 gson jackson 的 TypeHandler，方便开发者直接使用
+- 增强：entity 查询支持通过 QueryWrapper 传入表名以实现更灵活的需求
+- 优化：对方言 CommonsDialectImpl.forInsertEntity 添加字段 wrap
+- 优化：重构 TableInfo 的方法名，使其更加明确
+- 优化：代码生成和 columns 构建支持更多默认的数据类型
+- 优化：优化源码的中文注释描述
+- 文档：优化 maven 依赖相关描述
+
+
+
+## v1.0.0 20230312:
+主要对 beta 和 rc 版本进行大量的重构和测试
+
+
+
+## v1.0.0-rc.1 20230306:
+- 优化：对 RowSqlProvider.java 的一些方法名进行重构
+- 优化：QueryEntityProcesser 添加对 DEFAULT_COLUMNS 属性的生成
+- 优化：RowKey.java 移除其 set 方法
+- 优化：Entity 数据在被插入时，会自动设置逻辑删除的默认值
+- 优化：添加主键生成的全局配置，可以不用为每个 Entity 单独配置主键内容
+- 文档：添加 "逻辑删除" 的相关文档
+- 文档：添加 "乐观锁" 的相关文档
+- 文档：添加 entity 插入和更新的默认值设置的文档
+- 文档：添加 OrderBy 的 QueryWrapper 示例
+
+
+
+## v1.0.0-beta.2 20230303:
+- 优化：当只查询一张表时，SQL生成的字段不添加表前缀
+- 优化：完善对 @Column(onUpdateValue=xxx,onInsertValue=xxx) 的支持
+- 优化：完善对 @Column(version = true) 的支持
+- 优化：重命名 BaseMapper 的 insertBatchWithFirstEntityColumns 为 insertBatch
+- 优化：重命名 DialectFactory 的 createDialectByDbType 为 createDialect
+- 优化：为逻辑删除的默认值功能添加常量
+- 修复：createDialectByDbType 方法中pg库的 KeywordWrap 错误
+- 文档：优化文档
+
+
+
+## v1.0.0-beta.1:
+init mybatis-flex
--- a/docs/zh/core/column.md
+++ b/docs/zh/core/column.md
@ -276,4 +276,4 @@ mybatis-flex 内置的扩展 typeHandler 还有：
 在某些场景下，我们的 entity 可能会有通用的字段以及配置，这种场景如果我们要为每个 entity 去设置，这会相对麻烦。
 在这种场景下，我们可以建立一个通用的 BaseEntity 类，然后让所有的 Entity 都继承是该类。

-Entity 一般是通过代码生成器生成的，我们通过 `GlobalConfig.entitySupperClass` 可以为代码生成器配置全局的 Entity 父类，更多关于代码生成器可以请访问 [这里](../others/codegen.md)。
+Entity 一般是通过代码生成器生成的，我们通过 `GlobalConfig.entitySuperClass` 可以为代码生成器配置全局的 Entity 父类，更多关于代码生成器可以请访问 [这里](../others/codegen.md)。
--- a/docs/zh/core/data-cache.md
+++ b/docs/zh/core/data-cache.md
@ -179,11 +179,11 @@ public class AccountServiceImpl extends CacheableServiceImpl<MyAccountMapper, Ac
 ```java
 // 使用代码风格 1 生成
 globalConfig.setServiceImplGenerateEnable(true);
-globalConfig.setServiceImplSupperClass(CacheableServiceImpl.class);
+globalConfig.setServiceImplSuperClass(CacheableServiceImpl.class);
 globalConfig.setServiceImplCacheExample(true);

 // 或者使用代码风格 2 生成
 globleConfig.enableServiceImpl()
-        .setSupperClass(CacheableServiceImpl.class)
+        .setSuperClass(CacheableServiceImpl.class)
        .setCacheExample(true);
 ```
--- a/docs/zh/core/data-permission.md
+++ b/docs/zh/core/data-permission.md
@ -24,7 +24,7 @@ public class MyPermissionDialect extends CommonsDialectImpl {
        //获取当前用户信息，为 queryWrapper 添加额外的条件
        queryWrapper.and("...");

-        return supper.buildSelectSql(queryWrapper);
+        return super.buildSelectSql(queryWrapper);
    }
 }
 ```
--- a/docs/zh/others/apt.md
+++ b/docs/zh/others/apt.md
@ -22,6 +22,7 @@ MyBatis-Flex 使用了 APT（Annotation Processing Tool）技术，在项目编
 | processor.allInTables.package           | Tables 类名            | 合法的包名                                                    | ${entityPackage}.table               |
 | processor.allInTables.className         | Tables 类名            | 合法的类名                                                    | Tables                               |
 | processor.mapper.generateEnable         | 开启 Mapper 自动生成       | true/false                                               | false                                |
+| processor.mapper.annotation             | 开启 @Mapper 注解        | true/false                                               | false                                |
 | processor.mapper.baseClass              | 自定义 Mapper 的父类       | 全路径类名                                                    | com.mybatisflex.core.BaseMapper      |
 | processor.mapper.package                | 自定义 Mapper 生成的包名     | 合法的包名                                                    | ${entityPackage}.mapper              |
 | processor.tableDef.propertiesNameStyle  | 生成辅助类的字段风格           | upperCase, lowerCase<br />upperCamelCase, lowerCamelCase | upperCase                            |
--- a/docs/zh/others/codegen.md
+++ b/docs/zh/others/codegen.md
@ -150,7 +150,7 @@ globalConfig.enableEntity();
 // 设置生成 Entity 并启用 Lombok、设置父类
 globalConfig.enableEntity()
        .setWithLombok(true)
-        .setSupperClass(BaseEntity.class);
+        .setSuperClass(BaseEntity.class);
 ```

 ## 全局配置 `GlobalConfig`
@ -193,7 +193,7 @@ globalConfig.getPackageConfig()
 // 设置生成 Entity 并启用 Lombok、设置父类
 globalConfig.enableEntity()
        .setWithLombok(true)
-        .setSupperClass(BaseEntity.class);
+        .setSuperClass(BaseEntity.class);
 ```

 ## 注释配置 `JavadocConfig`
@ -284,7 +284,7 @@ globalConfig.getTemplateConfig()
 |-----------------------------|----------------------------------|--------------------|
 | setClassPrefix(String)      | Entity 类的前缀                      | ""                 |
 | setClassSuffix(String)      | Entity 类的后缀                      | ""                 |
-| setSupperClass(Class)       | Entity 类的父类，可以自定义一些 BaseEntity 类 | null               |
+| setSuperClass(Class)       | Entity 类的父类，可以自定义一些 BaseEntity 类 | null               |
 | setOverwriteEnable(boolean) | 是否覆盖之前生成的文件                      | false              |
 | setImplInterfaces(Class[])  | Entity 默认实现的接口                   | Serializable.class |
 | setWithLombok(boolean)      | Entity 是否使用 Lombok 注解            | false              |
@ -294,7 +294,7 @@ globalConfig.getEntityConfig()
        .setWithLombok(true)
        .setClassPrefix("My")
        .setClassSuffix("Entity")
-        .setSupperClass(BaseEntity.class);
+        .setSuperClass(BaseEntity.class);
 ```

 ## Mapper 生成配置 `MapperConfig`
@ -303,7 +303,7 @@ globalConfig.getEntityConfig()
 |-----------------------------|-------------|------------------|
 | setClassPrefix(String)      | Mapper 类的前缀 | ""               |
 | setClassSuffix(String)      | Mapper 类的后缀 | "Mapper"         |
-| setSupperClass(Class)       | Mapper 类的父类 | BaseMapper.class |
+| setSuperClass(Class)       | Mapper 类的父类 | BaseMapper.class |
 | setOverwriteEnable(boolean) | 是否覆盖之前生成的文件 | false            |

 ```java
@ -319,7 +319,7 @@ globalConfig.getMapperConfig()
 |-----------------------------|--------------|----------------|
 | setClassPrefix(String)      | Service 类的前缀 | ""             |
 | setClassSuffix(String)      | Service 类的后缀 | "Service"      |
-| setSupperClass(Class)       | Service 类的父类 | IService.class |
+| setSuperClass(Class)       | Service 类的父类 | IService.class |
 | setOverwriteEnable(boolean) | 是否覆盖之前生成的文件  | false          |

 ```java
@ -335,7 +335,7 @@ globalConfig.getServiceConfig()
 |-----------------------------|------------------|-------------------|
 | setClassPrefix(String)      | ServiceImpl 类的前缀 | ""                |
 | setClassSuffix(String)      | ServiceImpl 类的后缀 | "ServiceImpl"     |
-| setSupperClass(Class)       | ServiceImpl 类的父类 | ServiceImpl.class |
+| setSuperClass(Class)       | ServiceImpl 类的父类 | ServiceImpl.class |
 | setOverwriteEnable(boolean) | 是否覆盖之前生成的文件      | false             |
 | setCacheExample(boolean)    | 是否添加缓存示例代码       | false             |

@ -352,7 +352,7 @@ globalConfig.getServiceImplConfig()
 |-----------------------------|---------------------|--------------|
 | setClassPrefix(String)      | Controller 类的前缀     | ""           |
 | setClassSuffix(String)      | Controller 类的后缀     | "Controller" |
-| setSupperClass(Class)       | Controller 类的父类     | null         |
+| setSuperClass(Class)       | Controller 类的父类     | null         |
 | setOverwriteEnable(boolean) | 是否覆盖之前生成的文件         | false        |
 | setRestStyle(boolean)       | REST 风格的 Controller | true         |

@ -512,6 +512,42 @@ public class EnjoyTemplate implements ITemplate {
 }
 ```

+## 自定义数据方言
+在 MyBatis-Flex 的代码生成器中，已经内置了 4 中方言，他们分别是：
+
+- 默认方言
+- MySQL 方言
+- Oracle 方言
+- SQLite 方言
+
+方言可以通过如下的方式进行使用：
+
+```java 3
+Generator generator = new Generator(dataSource
+    , globalConfig
+    , IDialect.ORACLE); //使用哪个方言
+
+generator.generate();
+```
+> 不传入方言的情况下，使用默认方言。
+
+针对不同的数据库，我们也可以通过自定义方言来实现代码生成，例如：
+
+MyDialect.java
+```java
+class MyDialect implements IDialect{
+   //重写相关构建方法
+}
+```
+开始使用 MyDialect
+```java 3
+Generator generator = new Generator(dataSource
+    , globalConfig
+    , new MyDialect()); //使用哪个方言
+
+generator.generate();
+```
+
 ## 添加其他产物的生成

 通过实现 `IGenerator` 来实现，比如 Entity 实体类的代码如下：
--- a/mybatis-flex-annotation/src/main/java/com/mybatisflex/annotation/RelationManyToMany.java
+++ b/mybatis-flex-annotation/src/main/java/com/mybatisflex/annotation/RelationManyToMany.java
@ -67,6 +67,12 @@ public @interface RelationManyToMany {
     */
    String targetField() default "";

+    /**
+     * 当映射是一个 map 时，使用哪个内容来当做 map 的 Key
+     * @return 指定的列
+     */
+    String mapKeyField() default "";
+
    /**
     * 中间表名称。
     *
--- a/mybatis-flex-annotation/src/main/java/com/mybatisflex/annotation/RelationOneToMany.java
+++ b/mybatis-flex-annotation/src/main/java/com/mybatisflex/annotation/RelationOneToMany.java
@ -67,6 +67,12 @@ public @interface RelationOneToMany {
     */
    String targetField();

+    /**
+     * 当映射是一个 map 时，使用哪个内容来当做 map 的 Key
+     * @return 指定的列
+     */
+    String mapKeyField() default "";
+
    /**
     * 中间表名称，一对一的关系是通过通过中间表维护时，需要添加此项配置。
     *
--- a/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/ControllerConfig.java
+++ b/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/ControllerConfig.java
@ -37,7 +37,7 @@ public class ControllerConfig {
    /**
     * 自定义 Controller 的父类。
     */
-    private Class<?> supperClass;
+    private Class<?> superClass;

    /**
     * 是否覆盖之前生成的文件。
@ -50,11 +50,11 @@ public class ControllerConfig {
    private boolean restStyle = true;

    public String buildSuperClassImport() {
-        return supperClass.getName();
+        return superClass.getName();
    }

    public String buildSuperClassName() {
-        return supperClass.getSimpleName();
+        return superClass.getSimpleName();
    }

    /**
@ -90,15 +90,15 @@ public class ControllerConfig {
    /**
     * 获取父类。
     */
-    public Class<?> getSupperClass() {
-        return supperClass;
+    public Class<?> getSuperClass() {
+        return superClass;
    }

    /**
     * 设置父类。
     */
-    public ControllerConfig setSupperClass(Class<?> supperClass) {
-        this.supperClass = supperClass;
+    public ControllerConfig setSuperClass(Class<?> superClass) {
+        this.superClass = superClass;
        return this;
    }

--- a/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/EntityConfig.java
+++ b/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/EntityConfig.java
@ -39,7 +39,7 @@ public class EntityConfig {
    /**
     * Entity 类的父类，可以自定义一些 BaseEntity 类。
     */
-    private Class<?> supperClass;
+    private Class<?> superClass;

    /**
     * 是否覆盖之前生成的文件。
@ -94,15 +94,15 @@ public class EntityConfig {
    /**
     * 获取父类。
     */
-    public Class<?> getSupperClass() {
-        return supperClass;
+    public Class<?> getSuperClass() {
+        return superClass;
    }

    /**
     * 设置父类。
     */
-    public EntityConfig setSupperClass(Class<?> supperClass) {
-        this.supperClass = supperClass;
+    public EntityConfig setSuperClass(Class<?> superClass) {
+        this.superClass = superClass;
        return this;
    }

--- a/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/GlobalConfig.java
+++ b/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/GlobalConfig.java
@ -836,17 +836,17 @@ public class GlobalConfig {
    }

    /**
-     * @see EntityConfig#getSupperClass()
+     * @see EntityConfig#getSuperClass()
     */
-    public Class<?> getEntitySupperClass() {
-        return getEntityConfig().getSupperClass();
+    public Class<?> getEntitySuperClass() {
+        return getEntityConfig().getSuperClass();
    }

    /**
-     * @see EntityConfig#setSupperClass(Class)
+     * @see EntityConfig#setSuperClass(Class)
     */
-    public void setEntitySupperClass(Class<?> entitySupperClass) {
-        getEntityConfig().setSupperClass(entitySupperClass);
+    public void setEntitySuperClass(Class<?> entitySuperClass) {
+        getEntityConfig().setSuperClass(entitySuperClass);
    }

    /**
@ -946,17 +946,17 @@ public class GlobalConfig {
    }

    /**
-     * @see MapperConfig#getSupperClass()
+     * @see MapperConfig#getSuperClass()
     */
-    public Class<?> getMapperSupperClass() {
-        return getMapperConfig().getSupperClass();
+    public Class<?> getMapperSuperClass() {
+        return getMapperConfig().getSuperClass();
    }

    /**
-     * @see MapperConfig#setSupperClass(Class)
+     * @see MapperConfig#setSuperClass(Class)
     */
-    public void setMapperSupperClass(Class<?> mapperSupperClass) {
-        getMapperConfig().setSupperClass(mapperSupperClass);
+    public void setMapperSuperClass(Class<?> mapperSuperClass) {
+        getMapperConfig().setSuperClass(mapperSuperClass);
    }

    /**
@ -1028,17 +1028,17 @@ public class GlobalConfig {
    }

    /**
-     * @see ServiceConfig#getSupperClass()
+     * @see ServiceConfig#getSuperClass()
     */
-    public Class<?> getServiceSupperClass() {
-        return getServiceConfig().getSupperClass();
+    public Class<?> getServiceSuperClass() {
+        return getServiceConfig().getSuperClass();
    }

    /**
-     * @see ServiceConfig#setSupperClass(Class)
+     * @see ServiceConfig#setSuperClass(Class)
     */
-    public void setServiceSupperClass(Class<?> serviceSupperClass) {
-        getServiceConfig().setSupperClass(serviceSupperClass);
+    public void setServiceSuperClass(Class<?> serviceSuperClass) {
+        getServiceConfig().setSuperClass(serviceSuperClass);
    }

    public boolean isServiceImplGenerateEnable() {
@ -1096,17 +1096,17 @@ public class GlobalConfig {
    }

    /**
-     * @see ServiceImplConfig#getSupperClass()
+     * @see ServiceImplConfig#getSuperClass()
     */
-    public Class<?> getServiceImplSupperClass() {
-        return getServiceImplConfig().getSupperClass();
+    public Class<?> getServiceImplSuperClass() {
+        return getServiceImplConfig().getSuperClass();
    }

    /**
-     * @see ServiceImplConfig#setSupperClass(Class)
+     * @see ServiceImplConfig#setSuperClass(Class)
     */
-    public void setServiceImplSupperClass(Class<?> serviceImplSupperClass) {
-        getServiceImplConfig().setSupperClass(serviceImplSupperClass);
+    public void setServiceImplSuperClass(Class<?> serviceImplSuperClass) {
+        getServiceImplConfig().setSuperClass(serviceImplSuperClass);
    }

    /**
@ -1178,17 +1178,17 @@ public class GlobalConfig {
    }

    /**
-     * @see ControllerConfig#getSupperClass()
+     * @see ControllerConfig#getSuperClass()
     */
-    public Class<?> getControllerSupperClass() {
-        return getControllerConfig().getSupperClass();
+    public Class<?> getControllerSuperClass() {
+        return getControllerConfig().getSuperClass();
    }

    /**
-     * @see ControllerConfig#setSupperClass(Class)
+     * @see ControllerConfig#setSuperClass(Class)
     */
-    public void setControllerSupperClass(Class<?> controllerSupperClass) {
-        getControllerConfig().setSupperClass(controllerSupperClass);
+    public void setControllerSuperClass(Class<?> controllerSuperClass) {
+        getControllerConfig().setSuperClass(controllerSuperClass);
    }

    /**
--- a/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/MapperConfig.java
+++ b/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/MapperConfig.java
@ -39,7 +39,7 @@ public class MapperConfig {
    /**
     * 自定义 Mapper 的父类。
     */
-    private Class<?> supperClass = BaseMapper.class;
+    private Class<?> superClass = BaseMapper.class;

    /**
     * 是否覆盖之前生成的文件。
@ -52,11 +52,11 @@ public class MapperConfig {
    private boolean mapperAnnotation;

    public String buildSuperClassImport() {
-        return supperClass.getName();
+        return superClass.getName();
    }

    public String buildSuperClassName() {
-        return supperClass.getSimpleName();
+        return superClass.getSimpleName();
    }

    /**
@ -92,15 +92,15 @@ public class MapperConfig {
    /**
     * 获取父类。
     */
-    public Class<?> getSupperClass() {
-        return supperClass;
+    public Class<?> getSuperClass() {
+        return superClass;
    }

    /**
     * 设置父类。
     */
-    public MapperConfig setSupperClass(Class<?> supperClass) {
-        this.supperClass = supperClass;
+    public MapperConfig setSuperClass(Class<?> superClass) {
+        this.superClass = superClass;
        return this;
    }

--- a/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/ServiceConfig.java
+++ b/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/ServiceConfig.java
@ -40,7 +40,7 @@ public class ServiceConfig {
    /**
     * 自定义 Service 的父类。
     */
-    private Class<?> supperClass = IService.class;
+    private Class<?> superClass = IService.class;

    /**
     * 是否覆盖之前生成的文件。
@ -48,11 +48,11 @@ public class ServiceConfig {
    private boolean overwriteEnable;

    public String buildSuperClassImport() {
-        return supperClass.getName();
+        return superClass.getName();
    }

    public String buildSuperClassName() {
-        return supperClass.getSimpleName();
+        return superClass.getSimpleName();
    }

    /**
@ -88,15 +88,15 @@ public class ServiceConfig {
    /**
     * 获取父类。
     */
-    public Class<?> getSupperClass() {
-        return supperClass;
+    public Class<?> getSuperClass() {
+        return superClass;
    }

    /**
     * 设置父类。
     */
-    public ServiceConfig setSupperClass(Class<?> supperClass) {
-        this.supperClass = supperClass;
+    public ServiceConfig setSuperClass(Class<?> superClass) {
+        this.superClass = superClass;
        return this;
    }

--- a/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/ServiceImplConfig.java
+++ b/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/config/ServiceImplConfig.java
@ -40,7 +40,7 @@ public class ServiceImplConfig {
    /**
     * 自定义 ServiceImpl 的父类。
     */
-    private Class<?> supperClass = ServiceImpl.class;
+    private Class<?> superClass = ServiceImpl.class;

    /**
     * 是否覆盖之前生成的文件。
@ -53,11 +53,11 @@ public class ServiceImplConfig {
    private boolean cacheExample;

    public String buildSuperClassImport() {
-        return supperClass.getName();
+        return superClass.getName();
    }

    public String buildSuperClassName() {
-        return supperClass.getSimpleName();
+        return superClass.getSimpleName();
    }

    /**
@ -93,15 +93,15 @@ public class ServiceImplConfig {
    /**
     * 获取父类。
     */
-    public Class<?> getSupperClass() {
-        return supperClass;
+    public Class<?> getSuperClass() {
+        return superClass;
    }

    /**
     * 设置父类。
     */
-    public ServiceImplConfig setSupperClass(Class<?> supperClass) {
-        this.supperClass = supperClass;
+    public ServiceImplConfig setSuperClass(Class<?> superClass) {
+        this.superClass = superClass;
        return this;
    }

@ -124,7 +124,7 @@ public class ServiceImplConfig {
     * 是否生成缓存例子。
     */
    public boolean isCacheExample() {
-        return CacheableServiceImpl.class.equals(supperClass) && cacheExample;
+        return CacheableServiceImpl.class.equals(superClass) && cacheExample;
    }

    /**
--- a/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/entity/Table.java
+++ b/mybatis-flex-codegen/src/main/java/com/mybatisflex/codegen/entity/Table.java
@ -173,8 +173,8 @@ public class Table {

        EntityConfig entityConfig = globalConfig.getEntityConfig();

-        if (entityConfig.getSupperClass() != null) {
-            imports.add(entityConfig.getSupperClass().getName());
+        if (entityConfig.getSuperClass() != null) {
+            imports.add(entityConfig.getSuperClass().getName());
        }

        if (entityConfig.getImplInterfaces() != null) {
@ -257,8 +257,8 @@ public class Table {
     */
    public String buildExtends() {
        EntityConfig entityConfig = globalConfig.getEntityConfig();
-        if (entityConfig.getSupperClass() != null) {
-            return " extends " + entityConfig.getSupperClass().getSimpleName();
+        if (entityConfig.getSuperClass() != null) {
+            return " extends " + entityConfig.getSuperClass().getSimpleName();
        } else {
            return "";
        }
--- a/mybatis-flex-codegen/src/main/resources/templates/enjoy/controller.tpl
+++ b/mybatis-flex-codegen/src/main/resources/templates/enjoy/controller.tpl
@ -20,7 +20,7 @@ import org.springframework.web.bind.annotation.RestController;
 #else
 import org.springframework.stereotype.Controller;
 #end
-#if(controllerConfig.supperClass)
+#if(controllerConfig.superClass)
 import #(controllerConfig.buildSuperClassImport());
 #end

@ -39,7 +39,7 @@ import java.util.List;
@Controller
 #end
@RequestMapping("/#(firstCharToLowerCase(entityClassName))")
-public class #(table.buildControllerClassName()) #if(controllerConfig.supperClass)extends #(controllerConfig.buildSuperClassName()) #end {
+public class #(table.buildControllerClassName()) #if(controllerConfig.superClass)extends #(controllerConfig.buildSuperClassName()) #end {

    @Autowired
    private #(table.buildServiceClassName()) #(serviceVarName);
--- a/mybatis-flex-codegen/src/test/java/com/mybatisflex/codegen/test/GeneratorTest.java
+++ b/mybatis-flex-codegen/src/test/java/com/mybatisflex/codegen/test/GeneratorTest.java
@ -61,7 +61,7 @@ public class GeneratorTest {
        //配置生成 entity
        globalConfig.setEntityGenerateEnable(true);
        globalConfig.setEntityWithLombok(true);
-        globalConfig.setEntitySupperClass(BaseEntity.class);
+        globalConfig.setEntitySuperClass(BaseEntity.class);

        //配置生成 mapper
        globalConfig.setMapperGenerateEnable(true);
@ -122,7 +122,7 @@ public class GeneratorTest {
        globalConfig.enableEntity()
            .setOverwriteEnable(true)
            .setWithLombok(true)
-            .setSupperClass(BaseEntity.class);
+            .setSuperClass(BaseEntity.class);

        //配置生成 mapper
        globalConfig.enableMapper();
@ -130,7 +130,7 @@ public class GeneratorTest {
        globalConfig.enableService();
        //配置生成 serviceImpl
        globalConfig.enableServiceImpl()
-            .setSupperClass(CacheableServiceImpl.class)
+            .setSuperClass(CacheableServiceImpl.class)
            .setCacheExample(true);
        //配置生成 controller
        globalConfig.enableController();
--- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/relation/ManyToMany.java
+++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/relation/ManyToMany.java
@ -16,15 +16,11 @@
 package com.mybatisflex.core.relation;

 import com.mybatisflex.annotation.RelationManyToMany;
-import com.mybatisflex.core.query.QueryWrapper;
-import com.mybatisflex.core.util.StringUtil;

 import java.lang.reflect.Field;

 class ManyToMany<SelfEntity> extends ToManyRelation<SelfEntity> {

-    private String orderBy;
-
    public ManyToMany(RelationManyToMany annotation, Class<SelfEntity> entityClass, Field relationField) {
        super(getDefaultPrimaryProperty(annotation.selfField(), entityClass, "@RelationManyToMany.selfField can not be empty in field: \"" + entityClass.getName() + "." + relationField.getName() + "\"")
            , annotation.targetSchema()
@ -35,15 +31,10 @@ class ManyToMany<SelfEntity> extends ToManyRelation<SelfEntity> {
            , annotation.joinTargetColumn()
            , annotation.dataSource(), entityClass, relationField
            , annotation.extraCondition());
+
        this.orderBy = annotation.orderBy();
+        this.setMapKeyField(annotation.mapKeyField());
    }


-    @Override
-    public void customizeQueryWrapper(QueryWrapper queryWrapper) {
-        if (StringUtil.isNotBlank(orderBy)) {
-            queryWrapper.orderBy(orderBy);
-        }
-    }
-
 }
--- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/relation/OneToMany.java
+++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/relation/OneToMany.java
@ -16,16 +16,11 @@
 package com.mybatisflex.core.relation;

 import com.mybatisflex.annotation.RelationOneToMany;
-import com.mybatisflex.core.query.QueryWrapper;
-import com.mybatisflex.core.util.StringUtil;

 import java.lang.reflect.Field;

 class OneToMany<SelfEntity> extends ToManyRelation<SelfEntity> {

-    private String orderBy;
-    private int limit;
-

    public OneToMany(RelationOneToMany annotation, Class<SelfEntity> entityClass, Field relationField) {
        super(getDefaultPrimaryProperty(annotation.selfField(), entityClass, "@RelationOneToMany.selfField can not be empty in field: \"" + entityClass.getName() + "." + relationField.getName() + "\"")
@ -37,20 +32,14 @@ class OneToMany<SelfEntity> extends ToManyRelation<SelfEntity> {
            , annotation.joinTargetColumn()
            , annotation.dataSource(), entityClass, relationField
            , annotation.extraCondition());
+
        this.orderBy = annotation.orderBy();
        this.limit = annotation.limit();
+
+        this.setMapKeyField(annotation.mapKeyField());
    }


-    @Override
-    public void customizeQueryWrapper(QueryWrapper queryWrapper) {
-        if (StringUtil.isNotBlank(orderBy)) {
-            queryWrapper.orderBy(orderBy);
-        }

-        if (limit > 0) {
-            queryWrapper.limit(limit);
-        }
-    }

 }
--- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/relation/ToManyRelation.java
+++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/relation/ToManyRelation.java
@ -15,18 +15,20 @@
 */
 package com.mybatisflex.core.relation;

+import com.mybatisflex.core.query.QueryWrapper;
 import com.mybatisflex.core.row.Row;
-import com.mybatisflex.core.util.ClassUtil;
-import com.mybatisflex.core.util.MapperUtil;
+import com.mybatisflex.core.util.*;

 import java.lang.reflect.Field;
-import java.util.Collection;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Set;
+import java.util.*;

 class ToManyRelation<SelfEntity> extends AbstractRelation<SelfEntity> {

+    protected String mapKeyField;
+    protected FieldWrapper mapKeyFieldWrapper;
+    protected String orderBy;
+    protected int limit = 0;
+

    public ToManyRelation(String selfField, String targetSchema, String targetTable, String targetField,
                          String joinTable, String joinSelfColumn, String joinTargetColumn,
@ -40,6 +42,17 @@ class ToManyRelation<SelfEntity> extends AbstractRelation<SelfEntity> {
    }


+    @Override
+    public void customizeQueryWrapper(QueryWrapper queryWrapper) {
+        if (StringUtil.isNotBlank(orderBy)) {
+            queryWrapper.orderBy(orderBy);
+        }
+
+        if (limit > 0) {
+            queryWrapper.limit(limit);
+        }
+    }
+
    @SuppressWarnings("rawtypes")
    @Override
    public void join(List<SelfEntity> selfEntities, List<?> targetObjectList, List<Row> mappingRows) {
@ -65,17 +78,50 @@ class ToManyRelation<SelfEntity> extends AbstractRelation<SelfEntity> {
                    return;
                }

-                Class<?> wrapType = MapperUtil.getWrapType(relationFieldWrapper.getFieldType());
-                Collection collection = (Collection) ClassUtil.newInstance(wrapType);
-                for (Object targetObject : targetObjectList) {
-                    Object targetValue = targetFieldWrapper.get(targetObject);
-                    if (targetValue != null && targetMappingValues.contains(targetValue.toString())) {
-                        collection.add(targetObject);
+                Class<?> fieldType = relationFieldWrapper.getFieldType();
+                //map
+                if (Map.class.isAssignableFrom(fieldType)) {
+                    Class<?> wrapType = getMapWrapType(fieldType);
+                    Map map = (Map) ClassUtil.newInstance(wrapType);
+                    for (Object targetObject : targetObjectList) {
+                        Object targetValue = targetFieldWrapper.get(targetObject);
+                        if (targetValue != null && targetMappingValues.contains(targetValue.toString())) {
+                            Object keyValue = mapKeyFieldWrapper.get(targetObject);
+                            Object needKeyValue = ConvertUtil.convert(keyValue, relationFieldWrapper.getKeyType());
+                            map.put(needKeyValue, targetObject);
+                        }
                    }
+                    relationFieldWrapper.set(map, selfEntity);
+                }
+                //集合
+                else {
+                    Class<?> wrapType = MapperUtil.getCollectionWrapType(fieldType);
+                    Collection collection = (Collection) ClassUtil.newInstance(wrapType);
+                    for (Object targetObject : targetObjectList) {
+                        Object targetValue = targetFieldWrapper.get(targetObject);
+                        if (targetValue != null && targetMappingValues.contains(targetValue.toString())) {
+                            collection.add(targetObject);
+                        }
+                    }
+                    relationFieldWrapper.set(collection, selfEntity);
                }
-                relationFieldWrapper.set(collection, selfEntity);
            }
        });
    }

+    public void setMapKeyField(String mapKeyField) {
+        this.mapKeyField = mapKeyField;
+        if (StringUtil.isNotBlank(mapKeyField)) {
+            this.mapKeyFieldWrapper = FieldWrapper.of(targetEntityClass, mapKeyField);
+        }
+    }
+
+    public static Class<? extends Map> getMapWrapType(Class<?> type) {
+        if (ClassUtil.canInstance(type.getModifiers())) {
+            return (Class<? extends Map>) type;
+        }
+
+        return HashMap.class;
+    }
+
 }
--- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/util/FieldWrapper.java
+++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/util/FieldWrapper.java
@ -28,6 +28,7 @@ public class FieldWrapper {

    private Class<?> fieldType;
    private Class<?> mappingType;
+    private Class<?> keyType;
    private Method getterMethod;
    private Method setterMethod;

@ -64,7 +65,9 @@ public class FieldWrapper {

                    fieldWrapper = new FieldWrapper();
                    fieldWrapper.fieldType = findField.getType();
-                    fieldWrapper.mappingType = parseMappingType(clazz, findField);
+                    initMappingTypeAndKeyType(clazz, findField, fieldWrapper);
+
+
                    fieldWrapper.setterMethod = setter;

                    String[] getterNames = new String[]{"get" + StringUtil.firstCharToUpperCase(fieldName), "is" + StringUtil.firstCharToUpperCase(fieldName)};
@ -80,7 +83,7 @@ public class FieldWrapper {
        return fieldWrapper;
    }

-    private static Class<?> parseMappingType(Class<?> clazz, Field field) {
+    private static void initMappingTypeAndKeyType(Class<?> clazz, Field field, FieldWrapper fieldWrapper) {
        Reflector reflector = Reflectors.of(clazz);
        Class<?> fieldType = reflector.getGetterType(field.getName());

@ -88,11 +91,17 @@ public class FieldWrapper {
            Type genericType = field.getGenericType();
            if (genericType instanceof ParameterizedType) {
                Type actualTypeArgument = ((ParameterizedType) genericType).getActualTypeArguments()[0];
-                return (Class<?>) actualTypeArgument;
+                fieldWrapper.mappingType = (Class<?>) actualTypeArgument;
            }
+        } else if (Map.class.isAssignableFrom(fieldType)) {
+            Type genericType = field.getGenericType();
+            if (genericType instanceof ParameterizedType) {
+                fieldWrapper.keyType = (Class<?>) ((ParameterizedType) genericType).getActualTypeArguments()[0];
+                fieldWrapper.mappingType = (Class<?>) ((ParameterizedType) genericType).getActualTypeArguments()[1];
+            }
+        } else {
+            fieldWrapper.mappingType = fieldType;
        }
-
-        return fieldType;
    }


@ -120,4 +129,7 @@ public class FieldWrapper {
        return mappingType;
    }

+    public Class<?> getKeyType() {
+        return keyType;
+    }
 }
--- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/util/MapperUtil.java
+++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/util/MapperUtil.java
@ -208,9 +208,9 @@ public class MapperUtil {
    }


-    public static Class<?> getWrapType(Class<?> type) {
+    public static Class<? extends Collection> getCollectionWrapType(Class<?> type) {
        if (ClassUtil.canInstance(type.getModifiers())) {
-            return type;
+            return (Class<? extends Collection>) type;
        }

        if (List.class.isAssignableFrom(type)) {
--- a/mybatis-flex-test/mybatis-flex-native-test/src/main/java/com/mybatisflex/test/relation/onetoone/Account.java
+++ b/mybatis-flex-test/mybatis-flex-native-test/src/main/java/com/mybatisflex/test/relation/onetoone/Account.java
@ -23,6 +23,7 @@ import com.mybatisflex.annotation.Table;

 import java.io.Serializable;
 import java.util.List;
+import java.util.Map;

@Table(value = "tb_account")
 public class Account implements Serializable {
@ -49,13 +50,23 @@ public class Account implements Serializable {
 //            selfField = "id", joinSelfColumn = "account_id",
 //            targetField = "id", joinTargetColumn = "role_id"
 //    )
+//    @RelationManyToMany(
+//        joinTable = "tb_role_mapping",
+//        joinSelfColumn = "account_id",
+//        joinTargetColumn = "role_id",
+//        extraCondition = "(name like '%2%' or id > 1)"
+//    )
+    private List<Role> roles;
+
+
    @RelationManyToMany(
        joinTable = "tb_role_mapping",
        joinSelfColumn = "account_id",
        joinTargetColumn = "role_id",
-        extraCondition = "(name like '%2%' or id > 1)"
+        extraCondition = "(name like '%2%' or id > 1)",
+        mapKeyField = "id"
    )
-    private List<Role> roles;
+    private Map<Long, Role> rolesMap;


    public Long getId() {
@ -106,6 +117,14 @@ public class Account implements Serializable {
        this.roles = roles;
    }

+    public Map<Long, Role> getRolesMap() {
+        return rolesMap;
+    }
+
+    public void setRolesMap(Map<Long, Role> rolesMap) {
+        this.rolesMap = rolesMap;
+    }
+
    @Override
    public String toString() {
        return "Account{" +
@ -115,7 +134,7 @@ public class Account implements Serializable {
            ", idCard=" + idCard +
            ", books=" + books +
            ", roles=" + roles +
+            ", rolesMap=" + rolesMap +
            '}';
    }
-
 }