CHANGELOG

Author: wangshu-g

CHANGELOG.md

@@ -1,137 +1,183 @@
-# mybatis-xml-fast-develop changelog
+## 🆕 1.6.1
 
-+ ## 1.6.1
+> ✅ 已推送至 Maven Central
 
-待推送
+### 🐞 修复
 
-fix: [子模型元数据未正确处理dataBaseType导致生成错误的xml文件](https://github.com/wangshu-g/mybatis-xml-fast-develop/issues/2)
+* 修复 **子模型元数据未正确处理 `dataBaseType` 导致生成错误的 XML 文件**
+  [#2](https://github.com/wangshu-g/mybatis-xml-fast-develop/issues/2)
+* 修复 **保存前根据主键查询时未忽略删除标记字段** 的问题
 
-fix: 保存前根据主键查询是否存在，应忽略删除标记字段
+### ✨ 新增
 
-添加 @Version 版本号标识注解
+* 新增 `@Version` 注解 —— 支持 **乐观锁版本控制**
+* 新增 `@DefaultValue` 注解 —— 支持 **字段默认值定义**
+* 支持基于 `@Version` 注解的 **乐观更新、自增、自减**
 
-添加 @DefaultValue 默认值注解
+---
 
-添加基于 @Version 注解的乐观更新、自增 1、自减 1
+## 🆕 1.6.0
 
-+ ## 1.6.0
+> ✅ 已推送至 Maven Central
+> 💬 注：隔了一周才推送（主板进水 ☠️）
 
-已推送
+### ✨ 新增
 
-隔了一周才推送，电脑主板进水了...
+* `getId()` 方法默认使用 **UUIDv7**
+* 添加 `controller` 多种 **SoftDelete** 模板方法
+* `service` 添加 `_delete(boolean confirm)` 方法
+* 支持 **多包模型生成**，解除包名限制
 
-getId 方法默认使用 UUIDV7
+### 🚨 破坏性更新
 
-解放掉 @Model 注解只能作用于表实体上的限制，方便扩展需求，相较于以前版本，略有破坏性更新
+* `@Model` 注解不再仅限于表实体类，可作用于更多扩展场景（略有兼容性影响）
 
-controller 多种 SoftDelete 模板方法
+---
 
-service 添加_delete(boolean confirm) 方法
+## 🆕 1.5.3
 
-解放模型包名限制，多包生成
+> ✅ 已推送至 Maven Central
 
-+ ## 1.5.3
+### ✨ 新增
 
-已推送
+* 发布 **文档网站 (GitHub Pages)**
+* 新增数据库支持：
 
-文档网站 github pages
+    * ✅ **MariaDB**
+    * ✅ **达梦（Dameng）**
+* 新增多数据库自动建表支持
 
-mariadb 数据库生成和建表支持
+### 🐞 修复
 
-damneg（达梦）数据库生成和建表支持
+* 修复 PostgreSQL **软删除参数问题**
+* 修改 `pageIndex`、`pageSize` 参数类型以增强兼容性
 
-fix: postgresql 软删除参数问题
+---
 
-pageIndex，pageSize 参数类型修改
+## 🆕 1.5.2
 
-+ ## 1.5.2
+> ✅ 已推送至 Maven Central
 
-已推送
+### ✨ 新增
 
-添加 Primary 注解，从 Column 注解分离，显式指定主键是否自增，不再通过类型判断是否自增，以及相关逻辑改动
+* 添加 `@Primary` 注解（从 `@Column` 分离），显式指定主键自增策略
+* 移除强制 ID 生成逻辑（移除 `ulid-creator` 依赖，可自定义 ID 策略）
 
-关于 id 的生成，不再强制使用，移除 ulid-creator 依赖，自行覆写选择性使用
+### 🐞 修复 / 优化
 
-postgresql 保存时自增主键问题，批量和 oracle、mssql 情况一样，警告信息，建议业务避免
+* PostgreSQL 保存自增主键时的兼容性提示优化（与 Oracle / MSSQL 一致）
 
-+ ## 1.5.1
+  > 建议业务层避免批量自增场景
 
-已推送
+---
 
-DeleteFlag 删除标识，相关软删除兼容
+## 🆕 1.5.1
 
-BaseModelWithDefaultFields 基类模型，附带常用默认字段，泛型主键
+> ✅ 已推送至 Maven Central
 
-添加 like 条件生成处理，原有 instr 方法保留
+### ✨ 新增
 
-com.wangshu.base.controller 内所有默认 @PostMapping 更改为 @RequestMapping，注意生产环境权限问题
+* 新增软删除标识 `@DeleteFlag` 及相关兼容支持
+* 新增 `BaseModelWithDefaultFields` 基类（带默认通用字段）
+* 新增 `@Like` 条件生成支持（保留原 `instr` 方法）
+* 新增 `getUlId()` 方法替代过时的 `getUUID()`
 
-BaseService getUUID 方法标记为 Deprecated，添加 getUlId 替代使用
+### ⚙️ 改进
 
-fix：_update(P id, @NotNull String column1, Object newValue) 方法，参数处理错误
+* 所有默认 `@PostMapping` 改为 `@RequestMapping`
+* `_getNestList()` 支持基于 KV 的多条件查询写法（示例：`KV(ArticleQuery::getTitleLike, titleLike)`）
 
-BaseDataService 添加 Query、这 O、那 O 的相关支持。。。
+### 🐞 修复
 
-@NotNull List<T> _getNestList(@NotNull Object... keyValuesArray) 方法支持类似 _getNestList(KV(ArticleQuery::getTitleLike, titleLike)) 这样的写法。。。
+* 修复 `_update(P id, @NotNull String column1, Object newValue)` 参数处理错误
 
-+ ## 1.5.0
+---
 
-已推送 maven
+## 🆕 1.5.0
 
-DataBaseType postgresql、oracle、mssql xml 生成、自动建表等相关支持
+> ✅ 已推送至 Maven Central
 
-createdAt，deletedAt，updatedAt，DefaultOrder 注解标注关键字段
+### ✨ 新增
 
-基于 DeletedAt 注解标识的 _softDelete 软删除
+* 支持以下数据库自动建表与 XML 生成：
 
-SqlStyle Snake Upper 风格支持
+    * **PostgreSQL**
+    * **Oracle**
+    * **Microsoft SQL Server**
+* 新增关键字段注解：
 
-+ ## 1.4.0
+    * `@CreatedAt`、`@DeletedAt`、`@UpdatedAt`、`@DefaultOrder`
+* 新增基于 `@DeletedAt` 的软删除 `_softDelete`
+* 新增 SQL 风格：`SqlStyle.SnakeUpper`
 
-已推送 maven
+---
 
-修复自 1.2.0 编译时生成，scanClassFile = true 时（扫描已编译 model 模式）生成额外的 model bug
+## 🆕 1.4.0
 
-添加编译期生成强制覆盖 xml 配置
+> ✅ 已推送至 Maven Central
 
-GenerateConfig 拆分为 GenerateConfig、GenerateConfigCompileTime
+### 🐞 修复
 
-GenerateJava GenerateXml 方法修改、逻辑精简
+* 修复编译期生成时（`scanClassFile = true`）会生成额外 model 的问题
 
-generate-compile-time 同步 generate 模块修改，生成逻辑精简
+### ✨ 新增
 
-添加多模块分层开发使用案例 mybatis-xml-fast-develop-multiple-module-example
+* 添加 **编译期强制覆盖 XML 配置**
+* 拆分 `GenerateConfig` → `GenerateConfig` 与 `GenerateConfigCompileTime`
+* 添加 **多模块分层开发案例**：`mybatis-xml-fast-develop-multiple-module-example`
 
-service 中所有数据库相关操作方法名和 mapper 同步为 _ 开头作为区分
+### ⚙️ 优化
 
-BaseDataService 添加 _saveUnCheckExist，保存但不校验是否真实存在
+* 简化 `GenerateJava` / `GenerateXml` 方法逻辑
+* 统一 service 层数据库操作命名为 `_` 前缀区分
+* 新增 `_saveUnCheckExist()` —— 保存但不校验存在性
 
-+ ## 1.3.0
+---
 
-已推送 maven
+## 🆕 1.3.0
 
-添加使用示例模块 mybatis-xml-fast-develop-example
+> ✅ 已推送至 Maven Central
 
-优化对多查询映射
+### ✨ 新增
 
-+ ## 1.2.0
+* 新增使用示例模块 `mybatis-xml-fast-develop-example`
 
-已推送 maven
+### ⚙️ 优化
 
-引入编译期生成功能
+* 优化多查询映射逻辑
 
-添加编译期生成配置 GenerateConfig
+---
 
-添加编译期强制触发注解 @ForceTrigger
+## 🆕 1.2.0
 
-优化多模块分层开发体验，编译期生成逻辑优化
+> ✅ 已推送至 Maven Central
 
-+ ## 1.1.0
+### ✨ 新增
 
-已推送 maven
+* 引入 **编译期生成机制**
+* 新增 `GenerateConfig` 编译期配置
+* 新增编译期强制触发注解 `@ForceTrigger`
 
-Query 支持，emm...
+### ⚙️ 优化
 
-+ ## 1.0.0
+* 优化多模块分层开发体验与编译期逻辑
 
-已推送 maven
+---
+
+## 🆕 1.1.0
+
+> ✅ 已推送至 Maven Central
+
+### ✨ 新增
+
+* 添加 `Query` 支持
+
+---
+
+## 🆕 1.0.0
+
+> ✅ 已推送至 Maven Central
+
+### 🎉 初始版本
+
+* 核心功能发布