如何在泛型 Builder 模式中安全构建子类实例

冬明君_2354

冬明君_2354

2026-10-16

159人浏览

原创

如何在泛型 Builder 模式中安全构建子类实例

本文讲解如何通过泛型 + 工厂方法 + 类型擦除规避技巧,在 Lombok @SuperBuilder 继承体系中复用通用构建逻辑,避免子类 buildResponse 方法重复代码。

本文讲解如何通过泛型 + 工厂方法 + 类型擦除规避技巧,在 lombok `@superbuilder` 继承体系中复用通用构建逻辑,避免子类 `buildresponse` 方法重复代码。

在使用 Lombok @SuperBuilder 构建具有继承关系的类(如 ChildA、ChildB 继承自 Parent)时,常遇到「公共构建分支逻辑重复」的问题。你希望将 if (someInteger == 1) { ... } else { ... } 这类模式提取到父类,但直接写 T.builder().parentVariable(1).build() 会编译失败——因为 Java 泛型擦除后,T.builder() 并不存在,且 builder() 是静态方法,无法通过类型参数调用。

✅ 正确解法:不依赖 T.builder(),而是由子类传入已构造好的 Builder 实例,父类仅负责调用 .parentVariable(...).build()。这既保持类型安全,又规避了泛型静态方法限制。

✅ 推荐重构方案(类型安全 & 零反射)

修改 Parent 类,定义一个接受 子类 Builder 实例 的泛型构建方法:

Adobe Firefly
Adobe Firefly

Adobe Firefly是一款面向创意工作流的生成式 AI 图片、视频、音频和设计平台。

下载
// Parent.java
package test;

import java.util.Random;
import java.util.function.Supplier;
import lombok.Getter;
import lombok.experimental.SuperBuilder;

@SuperBuilder
@Getter
public class Parent {
    protected int parentVariable;
    protected Random random;

    Parent() {
        this.random = new Random();
    }

    /**
     * 通用响应构建器:由子类提供预配置的 Builder(含子类特有字段),父类注入公共字段并完成构建
     * @param someInteger 触发条件值
     * @param builderWithChildFields 已设置子类字段的 Builder(如 ChildA.builder().childAInteger(...).childAString(...))
     * @param <t> 子类具体类型
     * @return 构建完成的子类实例
     */
    protected static <t extends parent> T buildResponse(
            int someInteger,
            Supplier<t> fallbackSupplier,
            // 关键:传入 Builder(非 Class 或 String),利用 Lombok 生成的 builder() 静态方法
            Supplier extends Parent.ParentBuilder, ?>> baseBuilderSupplier) {
        if (someInteger == 1) {
            return fallbackSupplier.get();
        }
        // 复用子类 builder —— 注意:必须是 Parent 的 builder,但实际可强转为子类 builder(Lombok 保证兼容性)
        @SuppressWarnings("unchecked")
        T built = (T) baseBuilderSupplier.get()
                .parentVariable(1)
                .build();
        return built;
    }
}</t></t></t>

对应地,子类调用方式调整为传入 builder() 而非 ::buildChildA:

// ChildA.java
package test;

import lombok.Getter;
import lombok.experimental.SuperBuilder;

@SuperBuilder
@Getter
public class ChildA extends Parent {
    private int childAInteger;
    private String childAString;

    public ChildA execute() {
        int someInteger = random.nextInt(10);
        return buildResponse(
                someInteger,
                () -> ChildA.builder()
                        .childAInteger(0)
                        .childAString("")
                        .build(),
                ChildA::builder  // ✅ 传入 builder() 方法引用(返回 ChildA.ChildABuilder)
        );
    }
}
// ChildB.java
package test;

import lombok.Getter;
import lombok.experimental.SuperBuilder;

@SuperBuilder
@Getter
public class ChildB extends Parent {
    private float childBFloat;
    private long childBLong;

    public ChildB execute() {
        int someInteger = random.nextInt(10);
        return buildResponse(
                someInteger,
                () -> ChildB.builder()
                        .childBFloat(0.0F)
                        .childBLong(0L)
                        .build(),
                ChildB::builder
        );
    }
}

⚠️ 注意事项与最佳实践

  • @SuperBuilder 兼容性:确保所有子类和父类均使用 @SuperBuilder(而非 @Builder),否则 builder 类型不兼容。
  • 类型强转安全:baseBuilderSupplier.get().parentVariable(1).build() 返回 Parent,但 Lombok 生成的子类 builder 的 build() 方法实际返回子类类型(如 ChildA)。强制转换 (T) 在运行时安全,因调用方始终传入对应子类的 builder。
  • 避免反射/Class.newInstance:本方案无需 Class<t></t> 参数或反射,无性能开销与类型风险。
  • 扩展性:若需设置多个公共字段(如 parentVariable + timestamp),只需在 buildResponse 中链式调用即可。
  • 替代思路(Composition):如问题答案所提,若继承非必需,改用组合(ChildA 持有 Parent 字段 + @Delegate)可彻底规避 builder 继承复杂度,但会改变 API 设计风格。

✅ 总结

通过让子类向父类传递 Supplier<builder></builder> 而非尝试在父类中“凭空创建”子类 builder,我们绕过了 Java 泛型对静态方法的限制,实现了真正可复用、类型安全、无反射的通用构建逻辑。这是在 Lombok @SuperBuilder 继承场景下推荐的工程化实践。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10517

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7642

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6672

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1144

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1376

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2769

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20071

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1235

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习