更新日志

v0.7.0 (2026-03-03)

修复 SpelParser 线程安全问题：移除静态共享的 StandardEvaluationContext，改为每次 parse() 调用创建新的 context 实例，BeanResolver 通过 volatile 引用安全共享
修复 ObjectValidResult.EMPTY 可变单例问题：将 EMPTY 常量替换为 empty() 工厂方法，每次返回新实例，避免全局状态污染
修复 AnnotationMethodManager null 缓存失效：使用 Optional<Method> 作为缓存值，确保不存在的方法查询结果也能被正确缓存，避免重复反射
修复 NumberComparatorUtil API 设计不一致：将 OptionalInt 三态替换为语义清晰的 CompareResult 枚举
修复 ResourceBundleMessageResolver 并发问题：对 addBasenames() 和 resetBasenames() 的读-改-写操作加 synchronized 互斥锁
修复 ConstraintViolationSet 集合修改问题：将增强 for 循环中的 list.remove() 改为迭代器 remove()
修复 SpelNotSupportedTypeException 拼写错误：supperType → supportedType

优化 SpEL 表达式求值错误提示：SpelParser.parse() 在表达式求值为 null 或类型不匹配时，提供包含表达式内容和期望类型的详细错误信息
统一 jakarta/javax 模块差异：
- 移除 javax SpelValid.message() 上不恰当的 @NotNull 注解
- javax 版 @SpelValid 的 @Target 补充 TYPE，与 jakarta 版本保持一致

ObjectValidResult.EMPTY 常量移除，改为 ObjectValidResult.empty() 方法
NumberComparatorUtil 的 LESS_THAN、GREATER_THAN、FINITE_VALUE 常量类型从 OptionalInt 改为 CompareResult 枚举；compare() 方法的 treatNanAs 参数类型同步变更
SpelNotSupportedTypeException.getSupperType() 更名为 getSupportedType()

新增/补充以下回归测试：
- SpelParserInitTimingTest
- AbstractSpelTemporalValidatorExceptionTest（补充 Chrono 时间语义回归用例）
SpelParserInitTimingTest 增加隔离执行注解，避免并发干扰

新增 @SpelDigits 注解：用于校验数字的整数部分和小数部分位数
- 支持所有 Number 类型及它们的基本数据类型
- 支持使用 CharSequence 表示的数字
- 提供 integer 和 fraction 参数分别控制整数和小数部分的最大位数

@SpelMin 和 @SpelMax 支持 CharSequence 类型：现在可以对字符串形式的数字进行范围校验
@SpelMin 和 @SpelMax 新增 inclusive 参数：
- 支持配置边界值是否包含在内
- inclusive = true（默认）：@SpelMin 验证 value >= min，@SpelMax 验证 value <= max
- inclusive = false：@SpelMin 验证 value > min，@SpelMax 验证 value < max

本次增强 @SpelMin 和 @SpelMax 的目的，是为了对标 @DecimalMax、@DecimalMin 两个注解，参考 https://github.com/stick-i/spel-validator/issues/65

@SpelMin 和 @SpelMax 的 value 参数改为必填：
- 移除了默认值，提高使用的明确性
- 升级时需要为所有使用这两个注解的地方显式指定 value 值

如果你从旧版本升级到 0.6.0-beta，请注意：

必须为 @SpelMin 和 @SpelMax 指定 value 值：

// 旧版本（不再支持）
@SpelMin
private Integer count;

// 新版本（必须指定 value）
@SpelMin(value = "0")
private Integer count;

更多历史版本信息请查看 GitHub Releases。