Rest Code v1.1.8 发版说明
版本概览
v1.1.8 重点增强了 DSL 对标量类型的表达能力,并进一步统一了参数契约语法,降低脚本编写与代码生成时的歧义。
主要变更
1) 新增标量响应类型表达
新增以下响应契约,支持直接表达标量结果:
>#→Result<Long>>$→Result<String>>!→Result<Boolean>>~→Result<BigDecimal>
同时支持对应 List 变体:
>=#→Result<List<Long>>>=$→Result<List<String>>>=!→Result<List<Boolean>>>=~→Result<List<BigDecimal>>
2) RequestBody 标量语法统一
将历史表达迁移并统一为:
@# / @$→@=# / @=$
并复用为单标量 RequestBody 的统一语法入口,减少同类场景下的记忆负担。
3) 新增 Query 标量参数与数组表达
新增 Query 标量参数:
?!(Boolean)?~(BigDecimal)
新增 Query 标量数组:
?=# / ?=$ / ?=! / ?=~
用于更精确表达查询场景下的基础类型与集合类型输入。
4) 语法细节修正
- 修复
@PathVariable语法,移除不必要引号,简化参数定义。 - 同步更新文档示例,保证文档与实现一致。
兼容性说明
- 本次更新以 DSL 表达能力增强和语法统一为主。
- 建议在升级后优先检查旧脚本中
@# / @$的使用并迁移至@=# / @=$。
关联提交(节选)
bd4f048新增标量响应类型、RequestBody 标量统一、Query 标量参数与数组表达ae9999a修复@PathVariable语法并更新示例
如在迁移过程中遇到兼容性问题,建议先用最小脚本验证单条契约,再逐步回归到完整业务脚本。