diff --git a/changes.md b/changes.md index 6d74b6e8..9dcb16a4 100644 --- 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 和 List +- 优化:修改 BaseMapper.selectListByQueryAs 以支持获取 `List` 和 `List` - 优化:工具类添加 private 构造方法。感谢 @王帅 - 修复:在修改和删除时,schema 配置无效的问题 - 修复:update 方法应该替换 CachePut 注解为 CacheEvict。感谢 @王帅 diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 0364cfe1..23de0a52 100644 --- 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'}, diff --git a/docs/deploy.sh b/docs/deploy.sh index 6e3f3421..a232b76f 100755 --- a/docs/deploy.sh +++ b/docs/deploy.sh @@ -3,10 +3,13 @@ # abort on errors set -e +# copy changes.md +cp ../changes.md ./zh/ + # build npm run docs:build #vuepress build . ossutil rm oss://mybaits-flex/ -rf ossutil cp -rf assets/images oss://mybaits-flex/assets/images -ossutil cp -rf .vitepress/dist oss://mybaits-flex/ \ No newline at end of file +ossutil cp -rf .vitepress/dist oss://mybaits-flex/ diff --git a/docs/zh/changes.md b/docs/zh/changes.md new file mode 100644 index 00000000..9dcb16a4 --- /dev/null +++ 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` 和 `List` +- 优化:工具类添加 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