本文介绍一种不依赖类继承、类型安全且可复用的 Groovy 静态构建器模式，通过泛型工具类 + @DelegatesTo 注解实现流畅的 DSL 风格对象构造，避免泛型擦除导致的 Class 获取难题。
本文介绍一种不依赖类继承、类型安全且可复用的 Groovy 静态构建器模式，通过泛型工具类 + `@DelegatesTo` 注解实现流畅的 DSL 风格对象构造，避免泛型擦除导致的 `Class
在 Groovy 中设计类似 Jenkins Pipeline 的声明式 DSL（如 Configuration.with { language Java }）时，一个常见误区是试图通过泛型抽象基类（如 abstract class WithBuilder
因此，正确的解法是分离关注点：将通用构建逻辑提取为无状态工具类，而具体领域类仅负责声明专属的、类型明确的静态工厂方法。这种方式既保持了 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 <h3>⚠️ 关键注意事项</h3>
<ul>
<li>
<strong>builder.call() 而非 builder(instance)</strong>：因 delegate 已设为实例，直接 call() 即可；若传入 instance 会导致闭包接收两个参数（delegate + arg），易出错。</li>
<li>
<strong>@DelegatesTo 的作用</strong>：提供 IDE 智能提示和编译期校验，确保闭包内只能调用 Configuration 的属性/方法，大幅提升开发体验。</li>
<li>
<strong>返回值语义清晰</strong>：始终返回配置后的实例本身（即 delegate），而非闭包执行结果——这与 Jenkins Pipeline 等成熟 DSL 行为一致。</li>
<li>
<strong>无继承、零侵入</strong>：Configuration 保持纯粹 POJO，不耦合任何基类，利于测试与演化。</li>
</ul>
<h3>✅ 总结</h3>
<p>放弃“静态方法继承”的执念，转而采用 <strong>「通用工具类 + 类专属静态工厂」</strong> 模式，是 Groovy 中实现类型安全、可维护 DSL 构建器的最佳实践。它规避了泛型擦除的根本限制，借助 @DelegatesTo 提升健壮性与开发效率，并天然支持任意类（无论是否相关）复用同一套构建逻辑。对于追求简洁、表达力与工程稳定性的项目，这是更专业、更可持续的选择。</p></string></t></t>
