废弃信息与类型转换

EasyYapi 提供了废弃信息和类型转换的内置扩展。

废弃信息

deprecated 扩展（默认启用）自动从 Java 和 Kotlin 代码中提取废弃信息：

# Java 废弃
method.doc[#deprecated]=groovy:"\n「已废弃」" + it.doc("deprecated")
method.doc[@java.lang.Deprecated]=「已废弃」
field.doc[#deprecated]=groovy:"\n「已废弃」" + it.doc("deprecated")
field.doc[@java.lang.Deprecated]=「已废弃」

# Kotlin 废弃
method.doc[@kotlin.Deprecated]=groovy:"\n「已废弃」" + it.ann("kotlin.Deprecated","message")
field.doc[@kotlin.Deprecated]=groovy:"\n「已废弃」" + it.ann("kotlin.Deprecated","message")

类型转换

converts 扩展（默认启用）提供常见 Java 类型的自动转换：

源类型	目标类型
org.bson.types.ObjectId	java.lang.String
java.util.Date	java.lang.String
java.sql.Date	java.lang.String
java.sql.Time	java.lang.String
java.sql.Timestamp	java.lang.String
java.time.LocalDateTime	java.lang.String
java.time.LocalDate	java.lang.String
java.math.BigInteger	java.lang.Long
java.net.URL	java.lang.String
AtomicBoolean	java.lang.Boolean
AtomicLong	java.lang.Long
AtomicInteger	java.lang.Integer

字段工具

field-utils 扩展（默认启用）提供字段处理的合理默认值：

• 忽略 java.lang 系统类的字段
• 忽略 transient 字段
• 忽略 serialVersionUID
• 忽略常见系统类型（Class、ClassLoader、Thread、ThreadLocal 等）

public 字段现在会被导出

v3.2.4 之前，field-utils 扩展带有一条一刀切的规则，会丢弃所有非 private 或 protected 的字段，导致通过 public 字段暴露业务数据的 DTO（例如查询参数 DTO）导出后请求体为空。该规则已删除——public 和包级私有字段现在与 private 字段一样会被导出。如需恢复旧行为，请在规则文件中加入：

field.ignore=groovy:!(it.hasModifier("private")||it.hasModifier("protected"))