Java案例中的建造者模式怎么用？

wen java案例 2026-06-18 7

Java案例中的建造者模式怎么用？从理论到实战的完整指南

目录导读

建造者模式是什么？为什么需要它？
核心结构：四个角色各司其职
Java实战案例：用建造者模式构建复杂对象
建造者模式 vs 工厂模式：何时选谁？
常见陷阱与最佳实践
Q&A 高频问题解答

建造者模式是什么？为什么需要它？

建造者模式（Builder Pattern）是一种创建型设计模式，它允许你分步骤创建复杂对象,并且同一构建过程可以创建不同的表示。

Java案例中的建造者模式怎么用？

核心痛点：当你需要创建一个包含大量可选参数、参数之间有依赖关系、或者对象构造步骤非常复杂的对象时,直接使用构造函数会变得难以维护。

// 不使用建造者模式：构造函数参数过多且顺序敏感
Pizza pizza = new Pizza("large", "thin", true, true, false, "pepperoni", "mushroom");

这种代码可读性差、容易传错参数、扩展困难，建造者模式通过链式调用解决了这个问题。

核心结构：四个角色各司其职

角色	作用
Product（产品）	要构建的复杂对象，包含多个部件
Builder（抽象建造者）	定义创建产品各个部件的抽象接口
ConcreteBuilder（具体建造者）	实现抽象接口，具体构建部件，并返回产品
Director（指挥者）	控制构建过程，调用建造者的方法按顺序组装产品

关键思想：指挥者不直接创建对象，而是指导建造者一步步完成构建，建造者内部维护了产品的当前状态，最后通过 build() 方法返回最终产品。

Java实战案例：用建造者模式构建复杂对象

场景：构建一个复杂的 `Computer` 对象

假设我们需要构建一台电脑，它有必选参数（CPU、内存）和大量可选参数（显卡、硬盘、显示器、操作系统等）。

第一步：定义产品类

public class Computer {
    // 必选参数
    private String cpu;
    private String ram;
    // 可选参数
    private String gpu;
    private String storage;
    private String monitor;
    private String os;
    // 私有构造函数，只能通过 Builder 创建
    private Computer(Builder builder) {
        this.cpu = builder.cpu;
        this.ram = builder.ram;
        this.gpu = builder.gpu;
        this.storage = builder.storage;
        this.monitor = builder.monitor;
        this.os = builder.os;
    }
    // 静态内部 Builder 类
    public static class Builder {
        private String cpu;
        private String ram;
        private String gpu;
        private String storage;
        private String monitor;
        private String os;
        // 必选参数通过构造函数传入
        public Builder(String cpu, String ram) {
            this.cpu = cpu;
            this.ram = ram;
        }
        // 可选参数通过链式方法设置
        public Builder withGpu(String gpu) {
            this.gpu = gpu;
            return this;
        }
        public Builder withStorage(String storage) {
            this.storage = storage;
            return this;
        }
        public Builder withMonitor(String monitor) {
            this.monitor = monitor;
            return this;
        }
        public Builder withOs(String os) {
            this.os = os;
            return this;
        }
        // 最终的构建方法
        public Computer build() {
            // 可以在这里添加验证逻辑
            if (cpu == null || ram == null) {
                throw new IllegalStateException("CPU and RAM are required");
            }
            return new Computer(this);
        }
    }
}

第二步：客户端使用

Computer gamingPC = new Computer.Builder("Intel i9", "32GB")
        .withGpu("RTX 4090")
        .withStorage("1TB NVMe SSD")
        .withMonitor("27寸 4K 144Hz")
        .withOs("Windows 11")
        .build();
Computer officePC = new Computer.Builder("Intel i5", "16GB")
        .withStorage("512GB SSD")
        .build();

优势：

✅ 代码可读性极强，每个参数一目了然
✅ 参数顺序自由组合，不会混淆
✅ 可选参数不必全部提供，默认值由 Builder 控制
✅ 可以在 build() 中做参数校验，确保对象状态正确

建造者模式 vs 工厂模式：何时选谁？

对比维度	建造者模式	工厂模式
关注点	对象的构建过程，分步骤、可定制	对象的创建逻辑，封装实例化细节
参数数量	适合多参数（>4个）或可选参数多	适合参数固定或参数少
对象复杂性	对象内部结构复杂，部件组合多变	对象创建简单，主要解决创建与使用解耦
产物	同一构建过程可以产生不同表示	通常返回同一类型的实例
典型场景	构建组合套餐、多配置产品	日志工厂、数据库连接工厂

实际建议：

如果对象有超过4个参数，或者参数有默认值，首选建造者模式
如果只是需要隐藏创建逻辑，或者根据条件返回不同子类，用工厂模式
两者也可以结合使用：工厂负责创建 Builder，建造者负责组装

常见陷阱与最佳实践

❌ 陷阱1：过度使用建造者模式

当对象参数很少（≤3个）且固定时，使用建造者模式反而增加代码量,此时普通构造函数或静态工厂方法更简洁。

❌ 陷阱2：在 Builder 中做耗时操作

Builder 应该只做数据组装和校验，不要执行网络请求或数据库操作,建议把业务逻辑放在产品类中。

✅ 最佳实践：利用 Lombok 简化代码

import lombok.Builder;
import lombok.ToString;
@Builder
@ToString
public class Computer {
    private String cpu;
    private String ram;
    private String gpu;
    private String storage;
}

Lombok 的 @Builder 注解会自动生成 Builder 类，但注意它不支持在 build() 中自定义校验逻辑。

✅ 最佳实践：不可变对象

建造者模式非常适合创建不可变对象（所有字段 final，不提供 setter）,线程安全且易于缓存。

Q&A 高频问题解答

Q1：建造者模式和模板方法模式有什么不同？ A：模板方法模式定义算法的骨架（步骤固定），子类实现具体步骤；建造者模式关注对象的构建过程，指挥者控制步骤顺序但产品本身可变，简单说，模板方法强调“怎么做”，建造者强调“做成什么”。

Q2：建造者模式中的指挥者（Director）可以省略吗？ A：可以，在很多实际项目中，客户端直接使用 Builder 的链式方法，省略了 Director 角色，Director 的主要作用是将构建步骤标准化，适合需要固定构建顺序的场景（比如组装汽车必须先装底盘再装引擎）。

Q3：建造者模式与原型模式（Prototype）如何选择？ A：如果你需要根据现有对象稍作修改创建新对象，用原型模式（克隆），如果你需要从零开始按步骤组装复杂对象,用建造者模式。

Q4：在 Spring Boot 项目中如何应用？ A：常见于DTO 构建、配置类、HTTP 请求参数组装,例如构建复杂的查询条件：

SearchRequest request = SearchRequest.builder()
        .keyword("Java")
        .page(1)
        .size(20)
        .sortBy("relevance")
        .filter(f -> f.add("category", "programming"))
        .build();