CHANGELOG.md · 蓝天的云/bean-searcher

# v4.2.4 @ 2023-08-02

* 为配置项 `bean-searcher.params.convertor.date-target` 添加默认值 `SQL_DATE`
* 为配置项 `bean-searcher.params.convertor.date-time-target` 添加默认值 `SQL_TIMESTAMP`
* 为配置项 `bean-searcher.params.convertor.time-target` 添加默认值 `SQL_TIME`

# v4.2.3 @ 2023-08-02

### ✨ Features

* Bean Searcher
  * 增强 `BaseSearcher`，新增 `failOnParamError` 属性，可配置当参数错误时是否向外抛出异常，默认 `false`
  * 增强 `DateParamConvertor`，支持 `java.util.Date` 子类的转换，并新增 `target` 属性，支持配置转换目标类型
  * 增强 `DateTimeParamConvertor`，支持 `java.util.Date` 子类的转换，并新增 `target` 属性，支持配置转换目标类型
  * 增强 `TimeParamConvertor`，新增 `target` 属性，支持配置转换目标类型
* Bean Searcher Boot Starter
  * 新增配置项 `bean-searcher.params.fail-on-error` 指定参数错误时，是否抛出异常，默认 `false`
  * 新增配置项 `bean-searcher.params.convertor.date-target`
  * 新增配置项 `bean-searcher.params.convertor.date-time-target`
  * 新增配置项 `bean-searcher.params.convertor.time-target`
* Bean Searcher Solon Plugin
  * 新增配置项 `bean-searcher.params.fail-on-error` 指定参数错误时，是否抛出异常，默认 `false`
  * 新增配置项 `bean-searcher.params.convertor.date-target`
  * 新增配置项 `bean-searcher.params.convertor.date-time-target`
  * 新增配置项 `bean-searcher.params.convertor.time-target`

### 🐛 Bug Fixes

* Bean Searcher
  * 修复：实体类字段类型是整形，参数传字母时会报 `IllegalArqumentException` 的问题
  * 修复：逻辑分组在某些情况下会丢失部分条件的问题：https://gitee.com/troyzhxu/bean-searcher/issues/I7PZQ1

### 🌻 Better

* 升级 Solon -> v2.4.1
* 升级 SpringBoot -> v3.1.2

# v4.2.2 @ 2023-07-18

* 修复 `NumberParamConvertor` 与 `EnumParamConvertor` 冲突问题，`NumberParamConvertor` 不再处理枚举字段的转换
* 增强 `JsonFieldConvertor`，支持将 `非 String` 类型（例如：`PGobject`）的 JSON 值转换为对象

# v4.2.1 @ 2023-07-13

### ✨ Features

* Bean Searcher
  * 增强：`DateFieldConvertor` 支持 `Instant` 类型的转换：https://gitee.com/troyzhxu/bean-searcher/pulls/9
  * 新增：`EnumParamConvertor` 对于枚举字段，可将 `String/Emun` 类型的参数自动转换为 `枚举序号`（默认）或 `枚举名`（由 `@DbField.type` 决定）
  * 优化：`PreparedStatement.setObject(..)` 方法报错时，仍然打印 SQL 日志
* Bean Searcher Boot Starter
  * 自动配置 `EnumParamConvertor`
* Bean Searcher Solon Plugin
  * 自动配置 `EnumParamConvertor`

### 🐛 Bug Fixes

* Bean Searcher
  * 修复使用动态方言时，默认方言不能用的问题
* Bean Searcher Boot Starter
  * 修复 动态方言 不能自动化配置的问题
* Bean Searcher Solon Plugin
  * 修复 动态方言 不能自动化配置的问题

### 🌻 Better

* 升级 Solon -> v2.3.8
* 升级 SpringBoot -> v3.1.1

# v4.2.0 @ 2023-05-08

### ✨ Features

* Bean Searcher
  * 新增 `DynamicDialect` 与 `DynamicDialectSupport` 类，用于支持动态方言
  * 重构 `FieldParam.Value.isEmptyValue()` 方法重命名为 `FieldParam.Value.isEmpty()`
  * 重构 `AbstractSearcher` 重命名为 `BaseSearcher`
  * 功能：若子类 `@SearchBean` 注解省略了 `tables` 属性，则优先尝试从父类的注解中继承（TODO）
  * 优化 `DateTimeParamConvertor`, 使其支持解析 `yyyy-MM-dd HH:mm:ss.SSS`、`yyyy-MM` 与 `yyyy` 格式的参数
  * 升级 `slf4j` -> `2.0.7`
* Bean Searcher Boot Starter
  * 新增配置项 `bean-searcher.sql.dialect-dynamic`, 表示是否启用动态方言，默认 `false`
  * 当启用动态数据源时，支持以 `DataSourceDialect` 注入 Bean 的方式添加数据源与方言的映射关系
  * 升级 `springboot` -> `3.0.6`
* Bean Searcher Solon Plugin
  * 新增配置项 `bean-searcher.sql.dialect-dynamic`, 表示是否启用动态方言，默认 `false`
  * 当启用动态数据源时，支持以 `DataSourceDialect` 注入 Bean 的方式添加数据源与方言的映射关系
  * 升级 `solon` -> `2.2.17`

### 🐛 Bug Fixes

* 自定义 Equal 运算符不默认的问题：https://github.com/troyzhxu/bean-searcher/issues/73

# v4.1.2 & v4.0.2 @ 2023-03-09

### 🌻 Better

* 提升 `DefaultSqlExecutor` 的执行性能

# v4.1.1 @ 2023-03-06

### 🌻 Better

* 优化 `SearchBean` 校验
* 优化 `DefaultDbMapping.BeanField` 的访问权限

# v4.1.0 @ 2023-03-03

### ✨ Features

* Bean Searcher
  * 优化：`@DbField.type` 为 `UNKNOWN` 时，也支持使用 `ParamConvertor` 进行参数值转换
  * 重构：`ParamResolver.Convertor` -> `FieldConvertor.ParamConvertor`，且入参 `DbType` 类型修改为 `FieldMeta` 类型
  * 功能：注解 `@DbField` 新增 `name` 属性，可显式指定字段的参数名
  * 功能：注解 `@DbField` 新增 `cluster` 属性，可显式指定是否是聚合字段
  * 功能：注解 `@DbField` 新增 `mapTo` 属性，可显式指定映射到哪张表
  * 功能：注解 `@SearchBean` 新增 `fields` 属性，用于指定额外的动态条件字段
  * 优化：注解 `@SearchBean.groupBy` 使用拼接参数时，条件字段的生成逻辑
  * 优化：完善 `groupBy` 与 `groupExpr` 同时使用时 `where` 与 `having` 的条件拆分逻辑
  * 优化：增强逻辑表达式的自动化简能力
* Bean Searcher Boot Starter
  * 支持 `GroupPairResolver` 注入 Bean 的方式自定义
* Bean Searcher Solon Plugin
  * 首发 Solon 插件（功能同 `bean-searcher-boot-starter`）

### 👨🏻‍💻 Contributors

Thank you to all the contributors who worked on this release:

* [@VampireAchao](https://gitee.com/VampireAchao)
  * [@noear_admin](https://gitee.com/noear_admin)
  * [@troyzhxu](https://gitee.com/troyzhxu)

# v4.0.1 @ 2023-02-25

### ✨ Features

* Bean Searcher
  * 增强 `JsonFieldConvertor` 字段转换器，新增 `failOnError` 字段，可配置遇到某些值 JSON 解析异常时，是否自动捕获（即忽略）
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.field-convertor.json-fail-on-error` 配置项，表示是当 JSON 解析错误时，是否抛出异常，默认 `true`

### 🐛 Bug Fixes

* Bean Searcher Boot Starter
  * 修复 未添加 [`xjsonkit`](https://gitee.com/troyzhxu/xjsonkit) 相关依赖时，会启动报错的问题：https://gitee.com/troyzhxu/bean-searcher/issues/I6F4LS

# v4.0.0 @ 2023-01-31

### ✨ Features

* 重构 `cn.zhxu.bs.param.Operator` -> `cn.zhxu.bs.FieldOps`

### 🐛 Bug Fixes

* 修正 `MapUtils.of(..)` 为 `static` 方法。

# v4.0.0.alpha3 @ 2023-01-29

### ✨ Features

* Bean Searcher
  * 新增 `JsonFieldConvertor` 字段转换器，配合 `@DbField(type = DbType.JSON)` 可支持 JSON 字段自动转对象，需要添加 JSON 依赖（以下依赖任性一个即可）：
    * `cn.zhxu:xjsonkit-fastjson:1.4.2`
    * `cn.zhxu:xjsonkit-fastjson2:1.4.2`
    * `cn.zhxu:xjsonkit-gson:1.4.2`
    * `cn.zhxu:xjsonkit-jackson:1.4.2`
    * `cn.zhxu:xjsonkit-snack3:1.4.2`
    * 参考：https://gitee.com/troyzhxu/xjsonkit
  * 新增 `ListFieldConvertor` 字段转换器，可支持将 字符串字段自动转为简单 List 对象。
  * 增强 `NumberFieldConvertor`，使支持 `BigDecimal` 与 `Integer Long Float Double Short Byte` 之间的相互转换
  * 增强 `DefaultDbMapping`，新增 `setAroundChar(String)` 方法，支持配置标识符的围绕符，以区分系统保留字（只对自动映射的表与字段起作用）
  * 增强 `MapUtils`，新增 `of(k, v)`, `of(k1, v1, k2, v2)` 等 4 个 便捷 Map 构造方法
  * 升级 `slf4j-api` -> `2.0.6`
  * 升级 `springboot` -> `3.0.2`

* Bean Searcher Boot Starter
  * 新增 `bean-searcher.sql.default-mapping.around-char` 配置项，可配置标识符的围绕符（例如 MySQL 的 ` 符）
  * 新增 `bean-searcher.field-convertor.use-json` 配置项，表示是否自动添加 `JsonFieldConvertor`，默认 `true`
  * 新增 `bean-searcher.field-convertor.use-list` 配置项，表示是否自动添加 `ListFieldConvertor`，默认 `true`
  * 新增 `bean-searcher.field-convertor.list-item-separator` 配置项，用于配置如何将一个字符串分割成 `List` 字段
  * 优化 `bean-searcher.field-convertor.date-formats` 配置项，支持用 `-` 替代 `:`（因为在 yml 的 key 中 `:` 默认会被过滤掉）

# v4.0.0.alpha2 @ 2022-12-02

### ✨ Features

* Bean Searcher
  * 移除 Searcher 接口内的 search()、searchFirst()、searchList() 与 searchAll() 方法
  * 新增方法：search(Class<T> beanClass) -> SearchResult
  * 新增方法：search(Class<T> beanClass, String summaryField) -> SearchResult
  * 新增方法：search(Class<T> beanClass, String[] summaryFields) -> SearchResult
  * 新增方法：search(Class<T> beanClass, FieldFns.FieldFn<T, ?> summaryField) -> SearchResult
  * 新增方法：search(Class<T> beanClass, Map<String, Object> paraMap, String summaryField) -> SearchResult
  * 新增方法：search(Class<T> beanClass, Map<String, Object> paraMap, FieldFns.FieldFn<T, ?> summaryField) -> SearchResult
  * 新增方法：searchFirst(Class<T> beanClass) -> T / Map<String, Object>
  * 新增方法：searchList(Class<T> beanClass) -> List<T> / List<Map<String, Object>>
  * 新增方法：searchAll(Class<T> beanClass) -> List<T> / List<Map<String, Object>>
  * 新增方法：searchCount(Class<T> beanClass) -> Number
  * 新增方法：searchSum(Class<T> beanClass, String field) -> Number
  * 新增方法：searchSum(Class<T> beanClass, String[] fields) -> Number[]
  * 新增方法：searchSum(Class<T> beanClass, FieldFns.FieldFn<T, ?> field) -> Number
  * 新增方法：searchSum(Class<T> beanClass, Map<String, Object> paraMap, FieldFns.FieldFn<T, ?> field) -> Number

# v4.0.0.alpha1 @ 2022-12-01

### ✨ Features

* Bean Searcher
  * Maven 坐标 groupId 变更 -> `cn.zhxu`
  * 包名变更：`com.ejlchina.searcher` -> `cn.zhxu.bs`
  * 移除过时 API: `@SearchBean` 注解的 `joinCond` 属性
  * 优化嵌入参数：提高兼容性，支持嵌入参数后紧跟了 `.` 符号
  * 当字段是数字，但传参不是数字时，直接返回空数据
  * 注解 `@SearchBean` 添加 `timeout` 属性，用于控制慢 SQL 最大执行时长
  * 当使用 groupBy 与 逻辑分组时，如果所传参数都在 groupBy 内，也使用 where 形式的条件: https://gitee.com/troyzhxu/bean-searcher/issues/I5V4ON
* Bean Searcher Boot Starter
  * 支持 Spring Boot 3

# v3.8.2 @ 2022-09-16

* 修复 `v3.8.1` 产生的 BUG：https://github.com/troyzhxu/bean-searcher/issues/62

# v3.8.1 @ 2022-08-23

### ✨ Features

* Bean Searcher
  * 新增：分页大深度保护，默认最大允许分页偏移 `20000` 条
  * 优化：当检索参数过于庞大（阈值可配置）时，不执行查询，直接返回空数据
  * 优化：当逻辑分组表达式过于复杂（阈值可配置）或非法时，不执行查询，直接返回空数据
  * 优化：当指定的排序参数非法时，也不执行查询（之前是忽略排序），返回空数据
  * 优化：提升参数构建器性能，并将 `Builder.toFieldName` 方法标记为过时，新增 `FieldFns` 工具类
  * 优化：参数构建器新增 `asc(boolean sure)` 与 `desc(boolean sure)` 方法
  * 优化：参数构建器新增 `putAll(Map<String, ?> params)` 方法
  * 优化：当分页尺寸小于等于 `0` 时，不执行列表查询
  * 优化：标准化异常提示信息，全部英文化
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.params.filter.max-para-map-size` 配置项，默认 `150`
  * 新增 `bean-searcher.params.group.max-expr-length` 配置项，默认 `50`
  * 新增 `bean-searcher.params.pagination.max-allowed-offset` 配置项，默认 `20000`
  * 新增配置项校验：`bean-searcher.params.pagination.default-size` 的值不能比 `bean-searcher.params.pagination.max-allowed-size` 大，且都必须大于 `0`
  * 优化：标准化异常提示信息，全部英文化

# v3.8.0 @ 2022-07-23

### ✨ Features

* Bean Searcher
  * 增强 `@SearchBean` 注解：新增 `having` 属性，用于指定分组条件
  * 增强 `@DbField` 注解：新增 `type` 属性，允许用户手动指定该属性对应的数据库字段类型
  * 增强 `ParamResolver`: 新增 `Convertor` 参数转换器，可对检索参数的值类型转换为数据库字段匹配的类型（更好的兼容 Oracle、PgSQL 等数据库）
  * 新增 `BoolParamConvertor`、`NumberParamConvertor`、`DateParamConvertor`、`TimeParamConvertor` 与 `DateTimeParamConvertor` 参数转换器
  * 新增 `NotLike` 运算符（`nk`）：https://github.com/troyzhxu/bean-searcher/issues/50
  * 增强 `FieldOp.OpPara` ：新增 `getFieldSql(String field)` 方法，可以自定义运算符内获得其它字段的信息
  * 增强 `DefaultDbMapping`，当 `@SearchBean.tables` 的值是单表时，则省略 `@DbField` 的属性也自动映射
  * 增强 `参数构建器`：新增 `sql(..)` 方法，可为用于自定义 SQL 条件：https://github.com/troyzhxu/bean-searcher/issues/51
  * 新增 `根参数` 机制（用 `$` 表示根组，用户构造的组表达式不可以包含 `$`），参数构建器默认使用 根参数
  * 重构 `FieldConvertor`: 字段转换器的 9 个实现类 从 `com.ejlchina.searcher.implement` 包迁移到 `com.ejlchina.searcher.convertor` 包下
  * 重构 `DialectWrapper`：从 `com.ejlchina.searcher.implement` 包迁移到 `com.ejlchina.searcher.dialect` 包下
  * 重构 `@SearchBean` 注解：新增 `where` 替换原来的 `joinCond` 属性，并将 `joinCond` 标记为过时
  * 移除 `DateValueCorrector`，已被 `DateParamConvertor` 与 `DateTimeParamConvertor` 替代
  * 移除 `NullValueFilter` 与 `BoolValueFilter`（已被 `BoolParamConvertor` 替代）
  * 优化 分组动态查询条件生成机制：https://github.com/troyzhxu/bean-searcher/issues/56
  * 优化 当 `@SearchBean.tables` 的值是单表时，则省略注解的字段属性也自动映射
  * 优化 异常提示信息
* Bean Searcher Boot Starter
  * 支持 用户配置一个 `ParamResolver.Convertor` 的 Spring Bean 扩展参数值转换能力
  * 移除 `bean-searcher.sql.use-date-value-corrector` 配置项
  * 升级 `spring-boot` -> `v2.6.9`

# v3.7.1 @ 2022-06-22

### 🌻 Better

* Bean Searcher
  * 优化 `参数构建器`：新增 `orderBy(FieldFn<T, ?> fieldFn)`、`orderBy(String fieldName)`、`asc()` 与 `desc()` 方法
  * 优化 `参数构建器`：使 `onlySelect(..)` 与 `selectExclude(..)` 方法支持传入形如 `age,name` 这样以 `,` 分隔的字符串参数
* Bean Searcher Boot Starter
  * 优化：添加自定义参数过滤器时，不覆盖内置的参数过滤器

# v3.7.0 @ 2022-06-04

### ✨ Features

* Bean Searcher
  * 新增 `SqlServerDialect` 方言实现，支持 SqlServer 2012+
  * 新增 `OrLike` 运算符，参见：https://github.com/troyzhxu/bean-searcher/issues/38
  * 增强 `SqlExecutor`：新增 `SlowListener` 接口，可让用户在代码中监听慢 SQL
  * 增强 `DefaultDbMapping`：新增 `underlineCase` 属性，可配置自动映射时是否开启 `驼峰->下划线` 的风格转换
  * 增强 `Dialect`：新增 `hasILike()` 方法，当忽略大小写查询时，可利用数据库的 `ilike` 关键字提升查询性能
  * 增强 `EnumFieldConvertor`：支持 `整型` 转换为枚举（按枚举序号转换）
  * 增强 `EnumFieldConvertor`：新增 `failOnError` 属性, 可配置在遇到非法值无法转换时是否报错，默认 `true`
  * 增强 `EnumFieldConvertor`：新增 `ignoreCase` 属性, 可配置字符串值匹配枚举时是否忽略大小写，默认 `false`
  * 优化 `SQL 日志`：普通 SQL 显示执行耗时，慢 SQL 日志级别调整为 `WARN` 并输出关联的实体类
  * 优化 `DefaultSqlExecutor`，当执行 count sql 且查询结果为 `0` 时，则不再执行 list sql
  * 优化 `参数构建器` 的 `page(..)` 与 `limit(..)` 方法，它们起始页码也受页码配置约束（**破坏性更新**）
  * 优化 `Dialect`：为 `toUpperCase(..)` 添加默认实现，用户自定义方言时，只有一个 `forPaginate(..)` 方法必须实现
  * 优化 `DefaultParamResolver`：默认使用 `page` 分页参数提取器
  * 优化 `检索器` 的 count 与 sum 检索, 当无记录统计时，返回 `0` 而非 `null`, 并再次优化检索性能
  * 重构 `FetchType#ALL` 重命名为 `FetchType#DEFAULT`
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.sql.slow-sql-threshold` 配置键，可配置慢 SQL 阈值（单位毫秒），默认为 `500`
  * 新增 `bean-searcher.sql.default-mapping.underline-case` 配置键，可配置自动映射时是否开始 驼峰->下划线 的风格转换，默认为 `true`
  * 新增 `bean-searcher.field-convertor.enum-fail-on-error` 配置键，可配置在遇到非法值无法转换时是否报错，默认 `true`
  * 新增 `bean-searcher.field-convertor.enum-ignore-case` 配置键，可配置字符串值匹配枚举时是否忽略大小写，默认 `false`
  * 支持 用户配置一个 `SqlExecutor.SlowListener` 的 Spring Bean 来监听慢 SQL
  * 支持 用户配置 `bean-searcher.sql.dialect` 为 `SqlServer` 来使用 Sql Server 方言 
  * 升级 `spring-boot` -> `v2.6.8`

# v3.6.3 v3.5.5 @ 2022-05-11

### 🐛 Bug Fixes

* 修复 JDK8 上当实体类有 `LocalDate` 类型的字段时会报 `NoSuchMethodError` 的问题: https://github.com/troyzhxu/bean-searcher/issues/43

# v3.6.2 @ 2022-05-11

### 🌻 Better

* Bean Searcher Boot Starter: 升级 `spring-boot -> 2.6.7`

# v3.5.4 @ 2022-05-11

### 🌻 Better

* Bean Searcher Boot Starter: 升级 `spring-boot -> 2.6.7`

### 🐛 Bug Fixes

* 修复：当实体类 `@SearchBean` 注解内指定 `groupBy` 属性时，不支持 字段求和 的问题
* 修复 `MapUtils.builder(..)` 的 `page(..)` 与 `limit(..)` 方法不受 `max-allowed-size` 配置约束的问题

# v3.6.1 @ 2022-05-09

### ✨ Features

* Bean Searcher
  * 新增 `BoolNumFieldConvertor` 字段转换器：支持 `Boolean -> Number` 方向的转换
  * 优化 `SearcherBuilder` 新增 `addResultFilter(..)` 方法
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.field-convertor.use-bool-num` 配置键，可自动配置 `BoolNumFieldConvertor`，默认为 `true`

### 🐛 Bug Fixes

* 修复 `MapUtils.builder(..)` 的 `page(..)` 与 `limit(..)` 方法不受 `max-allowed-size` 配置约束的问题

# v3.6.0 @ 2022-04-21

### ✨ Features

* Bean Searcher
  * 实体类 `@SearchBean` 注解内的 SQL 片段支持 `:` 的转义处理：`\\:`
  * 实体类 `@SearchBean` 注解新增 `orderBy` 属性，可指定默认的排序字段
  * 实体类 `@SearchBean` 注解新增 `sortType` 属性，可指定排序约束类型
  * 实体类 `@SearchBean` 注解指定 `groupBy` 属性时，支持 字段求和 查询
  * 检索器 新增 `ResultFilter` 机制，可让用户对检索结果统一做进一步的自定义处理
  * 新增 `PostgreSqlDialect` 方言实现，可用于 PostgreSql 数据库
  * 重构 `SqlResult`，与 JDBC 解耦，便于使用其它 ORM 重写 `SqlExecutor`
  * 重构 `SqlInterceptor`，它的 `intercept(..)` 方法新增 `FetchType` 参数
  * 新增 `B2MFieldConvertor`，可让 `BFieldConvertor` 也适用于 `MapSearcher` 检索器
  * 移除 `DefaultSqlExecutor` 的 `addDataSource(..)` 方法，该方法在 `v3.0.0` 被标记为过时
  * 移除 `DateFormatFieldConvertor` 的 `addFormat(..)` 方法，该方法在 `v3.0.1` 被标记为过时
  * 当使用 `in/Include` 运算符时，输出警告，提示使用 `ct/Contain` 运算符
  * 当使用 `mv/MultiValue` 运算符时，输出警告，提示使用 `il/InList` 运算符
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.sql.default-mapping.inherit-type` 配置键，可在配置文件中指定默认的实体类继承类型，默认为 `ALL`
  * 新增 `bean-searcher.sql.default-mapping.sort-type` 配置键，可在配置文件中指定默认的排序约束类型，默认为 `ALLOW_PARAM`
  * 支持 `Spring Bean` 的方式为 `BeanSearcher` 与 `MapSearcher` 检索器添加 `ResultFilter` 过滤器
  * 配置 `bean-searcher.sql.dialect` 支持指定为 `PostgreSQL` 或 `PgSQL` 来使用 PostgreSql 方言
  * 新增 `bean-searcher.field-convertor.use-b2-m` 配置键，可在配置文件中指定是否启用 `B2MFieldConvertor`, 默认 `false`

# v3.5.3 @ 2022-04-06

### 🌻 Better

* Bean Searcher Boot Starter: 升级 spring-boot -> 2.6.6

### 🐛 Bug Fixes

* 修复：对于 `Boolean` 类型的字段，当检索时该字段传入的参数值为 `空串` 时，`BoolValueFilter` 会将其转换为 `true` 的问题：https://github.com/troyzhxu/bean-searcher/issues/29

# v3.5.2 @ 2022-03-17

### ✨ Features

* Bean Searcher: 参数构建器新增 `field(FieldFn<T, ?> fieldFn, Collection<?> values)` 与 `field(String fieldName, Collection<?> values)` 方法，支持字段值集合参数

### 🌻 Better

* Bean Searcher Boot Starter: 升级 spring-boot -> 2.6.4

### 🐛 Bug Fixes

* 修复当排序字段不在 SELECT 子句中时 ORDER BY 子句仍然会使用该字段的别名的问题

# v3.5.1 @ 2022-02-24

### 🌻 Better

* 强化对复杂逻辑表达式的简化能力
* 升级 slf4j-api -> 1.7.36

# v3.5.0 @ 2022-02-23

### ✨ Features

* Bean Searcher
  * 新增 `GroupResolver`、`ExprParser` 等组件，实现参数分组与逻辑关系的表达、运算、智能化简与解析的能力
  * `DefaultParamResolver` 新增 `gexprName`、`groupSeparator` 属性，用于指定组参数名的形式
  * `MapBuilder`（参数构建器）新增 `group(String group)` 方法，用于构建字段参数组
  * `MapBuilder` 新增 `groupExpr(String expr)` 方法，用于指定参数组间的逻辑关系
  * 新增 `TimeFieldConvertor`，支持 `java.sql.Time` 与 `LocalTime` 之间的转换 
  * 注解 `@DbField` 注解新增 `alias` 属性，支持手动指定字段别名（不指定则自动生成）
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.params.group.enable` 配置键，可在配置文件中指定是否使用参数组功能，默认为 `true`
  * 新增 `bean-searcher.params.group.expr-name` 配置键，可在配置文件中指定组表达式参数名，默认为 `gexpr`
  * 新增 `bean-searcher.params.group.expr-cache-size` 配置键，可在配置文件中指定组表达式解析缓存的大小，默认为 `50` 个
  * 新增 `bean-searcher.params.group.separator` 配置键，可在配置文件中指定参数组分隔符，默认为 `.`
  * 新增 `bean-searcher.field-convertor.use-time` 配置项，表示是否自动添加 `TimeFieldConvertor`，默认 `true`

# v3.4.3 @ 2022-02-21

### 🐛 Bug Fixes

* 修复 `StartWith` 运算符不后模糊匹配的问题（该 BUG 在 `v3.4.2` 中滋生）

# v3.4.2 @ 2022-02-18

### 🌻 Better

* 带嵌入参数的字段也能参与过滤条件
* 带嵌入参数的字段也能参与字段统计

# v3.4.1 @ 2022-02-11

### 🌻 Better

* Bean Searcher
  * 优化 SQL 生成逻辑：当 `@SearchBean` 注解的 `joinCond` 属性只有一个拼接参数 且 该参数值为空时，则使其不参与 `where` 子句

### 🐛 Bug Fixes

* 修复 `DateFieldConvertor` 无法将 `java.sql.Date` 转换为 `LocalDate / LocalDateTime` 的问题
* 修复 `DateFieldConvertor` 转换 `LocalDate / LocalDateTime` 时会产生时区偏差的问题
* 修复 `DateFormatFieldConvertor` 无法格式化 `java.sql.Date / java.sql.Time` 的问题

# v3.3.3 @ 2022-02-11

### 🌻 Better

* Bean Searcher
  * bump slf4j-api from 1.7.32 to 1.7.35
  * 优化注解声明
  * 优化异常信息
* Bean Searcher Boot Starter
  * bump spring-boot from 2.6.2 to 2.6.3
  * 去掉无用的配置提示

### 🐛 Bug Fixes

# v3.2.4 @ 2022-02-11

### 🌻 Better

* Bean Searcher Boot Starter
  * 去掉无用的配置提示

### 🐛 Bug Fixes

# v3.1.4 @ 2022-02-11

### 🌻 Better

* Bean Searcher
  * 增强 `BoolFieldConvertor`，使支持 `Boolean -> boolean` 方向的转换
* Bean Searcher Boot Starter
  * 不再强制依赖 `DataSource`, 支持 Grails 项目
  * 去掉无用的配置提示

### 🐛 Bug Fixes

# v3.4.0 @ 2022-02-09

### ✨ Features

* Bean Searcher
  * 增强 `MapBuilder.orderBy(..)` 方法，支持多次调用来指定按多个字段进行排序 
  * 新增 `orderBy` 排序参数，可以类似 `orderBy=age:asc,time:desc` 的形式来指定多个排序字段
  * 重构 `DefaultSqlResolver`、`Dialect`、`SqlSnippet` 等相关类
  * 移除 `StringUtils.firstCharToUpperCase(..)` 方法
  * `DefaultDbMapping` 新增 `ignoreFields` 属性，支持配置全局忽略的属性
  * `@SearchBean` 新增 `ignoreFields` 属性，可配置单个实体类应该被忽略的属性（可忽略父类中的属性）
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.sql.default-mapping.ignore-fields` 配置项，可在配置文件中指定全局忽略的属性
  * 新增 `bean-searcher.params.order-by` 配置项，可在配置文件中指定排序参数的参数名

### 🌻 Better

* Bean Searcher
  * 优化异常信息
  * 优化注解声明
  * bump slf4j-api from 1.7.32 to 1.7.35
* Bean Searcher Boot Starter
  * 优化配置提示信息
  * bump spring-boot from 2.6.2 to 2.6.3

# v3.3.2 @ 2022-02-07

### 🌻 Better

* Bean Searcher
  * 增强 `BoolFieldConvertor`，使支持 `Boolean` -> `boolean` 方向的转换

# v3.2.3 @ 2022-01-30

### 🌻 Better

* Bean Searcher
  * 增强 `BoolFieldConvertor`，使支持 `Boolean` -> `boolean` 方向的转换
* Bean Searcher Boot Starter
  * 优化 `BeanSearcherAutoConfiguration` 不再强制依赖 `DataSource`
  * 支持在 Grails 项目中使用 `bean-searcher-boot-starter` 依赖

# v3.3.1 @ 2022-01-21

### ✨ Features

* Bean Searcher
  * `MapBuilder` 新增 `op(Class<? extends FieldOp> op)` 方法
  * 优化 `DateValueCorrector`, 可配置支持的运算符
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.sql.use-date-value-corrector` 配置项，可配置 是否使用 `DateValueCorrector`
  * 支持在 Grails 项目中使用 `bean-searcher-boot-starter` 依赖

### 🌻 Better

* Bean Searcher
  * 优化字段运算符的匹配逻辑：使用严格模式
  * 优化 `Operator` 常量，使其可以直接作为 `@DbField.onlyOn` 的值（兼容以前版本，便于升级）
* Bean Searcher Boot Starter
  * 优化自动配置机制，支持无 `DataSource` 自动配置

### 🐛 Bug Fixes

* 修复当用户对同一个运算符 new 很多次时会导致 `FieldOpPool` 膨胀的问题

# v3.2.2 @ 2021-12-20

### 🌻 Better

* Bean Searcher
  * 优化 `DateValueCorrector`，使其支持 `LocalDateTime` 类型字段
* Bean Searcher Boot Starter
  * 优化自动配置机制，使其不依赖于 `DataSourceAutoConfiguration`，只要提供了 `DataSource` 就能自动配置
* Change LICENSE to Apache-2.0

# v3.3.0 @ 2022-01-19

### ✨ Features

* Bean Searcher
  * 新增 `FieldOp` 接口，用户可用之扩展自己的字段运算符
  * 新增 `FieldOpPool` 类，用户可用之定制一套全新的字段运算符
  * 内置新增 `NotIn` / `ni` 与 `NotBetween` / `nb` 运算符
  * 内置运算符 `MultiValue` / `mv` 重命名为 `InList` / `il` (原运算符仍可使用)
  * `DefaultDbMapping` 新增 `redundantSuffixes` 属性，可配置 在实体类自动映射表名时 统一去除类名中的冗余后缀（比如 VO、DTO 等）
  * 简化 `Dialect`: 移除 `truncateToDateStr`，`truncateToDateMinuteStr` 与 `truncateToDateSecondStr` 方法
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.sql.default-mapping.redundant-suffixes` 配置项，可配置多个冗余后缀
  * 支持直接声明一个 `FieldOp` 类型的 Spring Bean 来扩展一个新的字段运算符
  * 支持直接声明一个 `FieldOpPool` 类型的 Spring Bean 来定制一套全新的字符运算符
* Change LICENSE to Apache-2.0

# v3.2.1 @ 2021-12-18

### 🌻 Better

* Bean Searcher
  * 无 `@DbIgnore` 注解也自动忽略实体类中的 `static` 与 `transient` 属性
  * 实体类支持子类重写父类中已存在的属性

### 🐛 Bug Fixes

* Bean Searcher
  * 修复非字符串字段使用 Empty/NotEmpty 运算符时会报错的问题：https://gitee.com/troyzhxu/bean-searcher/issues/I4N1MG

# v3.1.3 @ 2021-12-14

### 🌻 Better

* Bean Searcher
  * 无 `@DbIgnore` 也自动忽略实体类中的静态字段
* Bean Searcher Boot Starter
  * 使用 Searcher 类型注入检索器时，默认注入 MapSearcher，不再报错
  * 提高兼容性，SpringBoot 最低版本支持到 v1.4+
  
# v3.0.5 @ 2021-12-12

### 🌻 Better

* Bean Searcher
  * 无 `@DbIgnore` 也自动忽略实体类中的静态字段
* Bean Searcher Boot Starter
  * 使用 Searcher 类型注入检索器时，默认注入 MapSearcher，不再报错
  * 提高兼容性，SpringBoot 最低版本支持到 v1.4+

# v3.2.0 @ 2021-12-08

### ✨ Features

* Bean Searcher
  * 重构 `FieldConvertor`：移除冗余参数 `targetType`
  * 新增 `EnumFieldConvertor`：用来做枚举字段转换
  * 实体类 SearchBean 支持继承（可继承 @SearchBean 注解与映射字段）
  * 注解 `@SearchBean` 新增 `inheritType` 属性，可控制继承规则
  * 类 `DefaultDbMapping` 新增 `defaultInheritType` 属性，可配置实体类的默认继承规则
  * 实体类 SearchBean 的映射字段支持省略 Setter 方法
  * 新增 `ct`（`Contain`）运算符，用于取代 `in`（`Include`）运算符（使用 `in` 将输出警告）
* Bean Searcher Boot Starter
  * 新增 `bean-searcher.field-convertor.use-enum` 配置项，表示是否自动添加 `EnumFieldConvertor`，默认 `true`
  * 新增 `bean-searcher.use-map-searcher` 配置项，表示是否自动创建 `MapSearcher` 检索器，默认 `true`
  * 新增 `bean-searcher.use-bean-searcher` 配置项，表示是否自动创建 `BeanSearcher` 检索器，默认 `true`

### 🌻 Better

* Bean Searcher Boot Starter
  * 使用 Searcher 类型注入检索器时，默认注入 MapSearcher，不再报错
  * 提高兼容性，SpringBoot 最低版本支持到 v1.4+

# v3.1.2 & v3.0.4 @ 2021-12-02

### 🌻 Better

* 优化 `JDBC` 调用，兼容 `sharding-jdbc`
* 优化 `Operator.from(Object)` 方法
* 优化 `MapBuilder` 工具类，增加非空校验

# v3.1.1 & v3.0.3 @ 2021-12-01

### ✨ Features

* 优化 `DefaultSqlResolver` 的方法的权限修饰符，便于子类复用

### 🐛 Bug Fixes

* 优化别名生成规则，兼容 Oracle 数据库

# v3.1.0 @ 2021-11-15

### ✨ Features

* Bean Searcher

* 新增 `BFieldConvertor` 与 `MFieldConvertor` 字段转换器子接口，提高字段转换效能
  * 新增 `DateFieldConvertor`，支持 `Date` 与 `LocalDateTime` 类型之间的转换
  * 增强 `DateFormatFieldConvertor`，使支持 `Temporal` 及其子类的对象的格式化
  * 增强 `DateFormatFieldConvertor`，新增：`setZoneId(ZoneId)` 方法，可配置时区
  * 增强 `DefaultSqlExecutor`，新增 `setTransactionIsolation(int level)` 方法，可配置隔离级别
  * 增强 `DbMapping`，使其完全接管数据映射的解析工作，并将 `DefaultDbMapping` 从 `DefaultMetaResolver` 的内部独立出来
  * 增强 `DefaultDbMapping`，使支持配置注解缺省时的表名前缀与是否开启大写映射，即支持默认映射大写的表名与列名
  
* Bean Searcher Boot Starter

* 支持配置 `NamedDataSource` 类型的 Bean 来添加多个具名数据源
  * 自动添加 `spring-boot-starter-jdbc` 依赖
  * 默认自动配置添加 `NumberFieldConvertor`
  * 默认自动配置添加 `StrNumFieldConvertor`
  * 默认自动配置添加 `BoolFieldConvertor`
  * 默认自动配置添加 `DateFieldConvertor`
  * 默认自动配置添加 `DateFormatFieldConvertor`
  * 支持配置文件指定表名与字段默认小写映射 或 大写映射
  * 支持配置文件指定表名默认映射的前缀

# v3.0.2 @ 2021-11-10

### 🐛 Bug Fixes

* 修复：在 v3.0.0 中，单独使用 `searchCount` 和 `searchSum` 方法时，获取 SQL 结果会出错的问题

# v3.0.1 @ 2021-11-05

### ✨ Features

* DateFormatFieldConvertor 新增 setFormat 方法

### 🐛 Bug Fixes

* 修复：在 v3.0.0 中，再没有指定 @SearchBean 注解的 joinCond 属性时，带条件的 SQL 生成中 where 后少一个 左括号的问题

# v3.0.0 重大更新 @ 2021-11-04

### ✨ Features

* 支持 热加载
* 支持 无注解
* 支持 Select 指定字段
* 支持 条件与运算符的约束
* 支持 参数过滤器
* 支持 字段转换器
* 支持 Sql 拦截器
* 支持 多数据源
* 支持 JDK 9+

#### Bean Searcher

* 精简 Searcher 接口，移除一些无用的方法（最后一个形参为 `prefix` 的检索方法被移除）
* 架构优化：SearchBean 支持热加载，在配置了热加载的应用开发中，SearchBean 修改后，无需重启即可生效
* 移除 `SearchPlugin` 与 `SpringSearcher` 辅助类，因为 v3.0 的 Bean Searcher 的使用比借助辅助类更加容易
* 精简 `SearchResult` 类，移除没有必要的字段，只保留 `totalCount`、`dataList` 与 `summaries` 字段
* 新增 `Searcher` 的子接口：`MapSearcher` 与 `BeanSearcher` 与其相关实现，`MapSearcher` 中的检索方法返回的数据类型为 `Map`, `BeanSearcher` 中的检索方法返回的数据类型为泛型的 Search Bean
* 重构 `SearcherBuilder` 构建器, 使其更容易构建出一个 `MapSearcher` 或 `BeanSearcher` 实例
* 注解 `@SearchBean` 的 `groupBy` 属性，支持嵌入参数，嵌入参数未传入时，使用空字符串（以前使用 `"null"` 字符串）
* 抽象 `BeanReflector` 与 `FieldConvertor` 接口，使得 SearchBean 对象的反射机制更加解耦，更容易扩展与自定义
* 新增 `NumberFieldConvertor`、`StrNumFieldConvertor`、`BoolFieldConvertor` 与 `DateFormatFieldConvertor` 四个字段转换器实现，用户可以选择使用
* 新增 `DbMapping` 数据库映射接口，并提供基于下划线风格的映射实现，使得简单应用场景下，用户可以省略 `@SearchBean` 与 `@DbField` 注解
* 注解 `@SearchBean` 新增 `dataSource` 属性，用于指定该 SearchBean 从哪个数据源检索
* 注解 `@SearchBean` 新增 `autoMapTo` 属性，用于指定缺省 `@DbField` 注解的字段自动映射到那张表
* 新增 `@DbIgnore` 注解，用于指定 忽略某些字段，即添加该注解的字段不会被映射到数据库
* 注解 `@DbField` 新增 `conditional` 与 `onlyOn` 属性，使得用户可以控制该字段是否可以用作检索条件，以及当可作检索条件时支持哪些字段运算符
* 新增 `ParamAware` 接口，SearchBean 实现该接口时，可在 `afterAssembly(Map<String, Object> paraMap)` 方法里拿到原始检索参数
* 新增 onlySelect 与 selectExclude 参数（参数名可自定义），可用于指定只 Select 哪些字段，或者排除哪些字段
* 新增 `SqlInterceptor` 接口，实现 SQL 拦截器功能

#### Bean Searcher Boot Starter

* 简化使用，不再需要启动操作，不再需要配置 SearchBean 包名路径（移除了 `SearcherStarter` 类）
* Spring Boot 自动配置功能 独立到 Bean Searcher Boot Starter` 项目中，Bean Searcher 项目不再依赖 Spring

#### JDK

* 支持 JDK8+ 
* 兼容 JDK9+ 的模块引入机制

蓝天的云/bean-searcher

简介

发行版

贡献者

近期动态

蓝天的云/bean-searcher .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

蓝天的云/bean-searcher