本文介绍一种不依赖类继承、类型安全且可复用的 Groovy 静态构建器模式，通过泛型工具类 + @DelegatesTo 注解实现流畅的 DSL 风格对象构造，避免泛型擦除导致的 Class<T> 获取难题。
本文介绍一种不依赖类继承、类型安全且可复用的 Groovy 静态构建器模式，通过泛型工具类 + `@DelegatesTo` 注解实现流畅的 DSL 风格对象构造，避免泛型擦除导致的 `Class
在 Groovy 中设计类似 Jenkins Pipeline 的声明式 DSL（如 Configuration.with { language Java }）时，一个常见误区是试图通过泛型抽象基类（如 abstract class WithBuilder<T>）强制子类实现静态 with 方法。然而，Java/Groovy 的静态方法不参与继承与多态，且泛型类型 T 在静态上下文中不可获取——Class<T> clazz = T 语法非法，是因为类型参数 T 在编译后被擦除，静态方法无法访问实际类型信息。
因此，正确的解法是分离关注点：将通用构建逻辑提取为无状态工具类，而具体领域类仅负责声明专属的、类型明确的静态工厂方法。这种方式既保持了 API 的一致性，又彻底规避了类型擦除陷阱。
✅ 推荐方案：工具类 + 类专属静态工厂
以下是一个生产就绪的实现：
class BuilderHelper {
/**
* 通用构建器：创建指定类型的实例，并以该实例为 delegate 执行闭包
* @param clazz 目标类（必须有无参构造器）
* @param builder 配置闭包，delegate 自动设为目标实例
* @return 配置完成后的目标实例（非闭包返回值！）
*/
static <T> T with(Class<T> clazz, Closure<?> builder) {
T instance = clazz.getDeclaredConstructor().newInstance()
builder.delegate = instance
builder.resolveStrategy = Closure.DELEGATE_ONLY
builder.call() // 注意：调用闭包但忽略其返回值，返回原始实例
return instance
}
}
// 具体业务类 —— 无需继承，仅需定义自己的 with 方法
class Configuration {
String language
Object credentials
List<String> environments = []
// 类型安全的静态工厂：明确指定 Configuration.class
static Configuration with(@DelegatesTo(Configuration.class) Closure<?> builder) {
return BuilderHelper.with(Configuration.class, builder)
}
void environments(Closure<?> envs) {
envs.delegate = this
envs.resolveStrategy = Closure.DELEGATE_ONLY
envs.call()
}
void dev() { environments << 'dev' }
void prod() { environments << 'prod' }
@Override
String toString() {
"Configuration(lang=$language, creds=$credentials, envs=$environments)"
}
}
// 使用示例（完全符合预期 DSL 风格）
def config = Configuration.with {
language = 'Java'
credentials = 'user-creds'
environments {
dev()
prod()
}
}
println config
// 输出：Configuration(lang=Java, creds=user-creds, envs=[dev, prod])⚠️ 关键注意事项
- builder.call() 而非 builder(instance)：因 delegate 已设为实例，直接 call() 即可；若传入 instance 会导致闭包接收两个参数（delegate + arg），易出错。
- @DelegatesTo 的作用：提供 IDE 智能提示和编译期校验，确保闭包内只能调用 Configuration 的属性/方法，大幅提升开发体验。
- 返回值语义清晰：始终返回配置后的实例本身（即 delegate），而非闭包执行结果——这与 Jenkins Pipeline 等成熟 DSL 行为一致。
- 无继承、零侵入：Configuration 保持纯粹 POJO，不耦合任何基类，利于测试与演化。
✅ 总结
放弃“静态方法继承”的执念，转而采用 「通用工具类 + 类专属静态工厂」 模式，是 Groovy 中实现类型安全、可维护 DSL 构建器的最佳实践。它规避了泛型擦除的根本限制，借助 @DelegatesTo 提升健壮性与开发效率，并天然支持任意类（无论是否相关）复用同一套构建逻辑。对于追求简洁、表达力与工程稳定性的项目，这是更专业、更可持续的选择。
