← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第29章 设计模式 23 讲 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

29.3 建造者模式:参数再多也不打架

审校 2026-09-25 · 素材来源:itstack-demo-design 复盘、深度文49
📑 本篇章节导航 (共9节,点击直达)
问题:重叠构造器与 telescoping手写建造者:分步设置,一次成型框架里的上岗现场建造者 vs 工厂:一句话分界三个非经典变体:可复用、配置定型与 toBuilderrecord 时代:建造者还要不要踩坑清单面试怎么问一句话总结

构造器参数一多,代码就开始长毛:new User(String, String, Integer, Boolean, String) ——调用方第五个参数传的是啥全靠数逗号,可选参数还得重载出四五个构造器互相调。建造者模式(把复杂对象的构建过程分步化,链式设置参数后一次性产出不可变对象)就是给这个病开的药,也是 Lombok @Builder 一行注解背后的事。

问题:重叠构造器与 telescoping

经典反模式「重叠构造器」:只有必填参数的构造器、加一个可选参数的、加两个的……参数五个以上时,调用方在五个构造器里挑一个,不需要的传 null,可读性归零。另一个极端是 JavaBean setter 风格:无参构造加一串 set——可读但对象在多次 set 之间处于半成品状态,多线程下别人可能读到设了一半的对象,且 setter 模式天然放弃不可变性。

手写建造者:分步设置,一次成型


class HttpRequest {
  private final String url, method;             // final:产出即不可变
  private final Map<String, String> headers;
  private final int timeout;
  private HttpRequest(Builder b) { url=b.url; method=b.method; headers=b.headers; timeout=b.timeout; }
  static Builder builder(String url) { return new Builder(url); }
  static class Builder {
    private final String url;                   // 必填:构造器入参
    private String method = "GET";              // 可选:字段带默认值
    private Map<String, String> headers = new HashMap<>();
    private int timeout = 3000;
    Builder(String url) { this.url = url; }
    Builder method(String m) { this.method = m; return this; }    // 链式返回 this
    Builder header(String k, String v) { headers.put(k, v); return this; }
    Builder timeout(int t) { this.timeout = t; return this; }
    HttpRequest build() { return new HttpRequest(this); }         // 一次成型
  }
}
// 用:HttpRequest.builder("/api/order").method("POST").header("X-Trace","t1").timeout(5000).build();

四个要点撑起整个模式:链式返回 this(每个设置方法返回 Builder 自身);必填进构造器、可选带默认值(编译期逼你填必填项);目标类构造器私有(半成品流不出去);build 时才产出且全 final(不可变对象线程安全白送)。校验逻辑放 build() 里最合适——参数齐了才验,早了验不全,晚了已成型。

框架里的上岗现场

StringBuilder(名字里就是 Builder):字符串拼接分步 append 后 toString 一次成型,对比 String 每次拼接都造新对象——这是建造者「分步积累、一次产出」的原始形态。Lombok @Builder:一个注解把上面的样板代码全部生成——代价是生成全参构造器,与 @NoArgsConstructor/@AllArgsConstructor 的搭配关系是踩坑高发区(MyBatis 反序列化需要无参构造,@Builder 单独用会让它失明)。Spring 的 BeanDefinitionBuilder:BeanDefinitionBuilder.genericBeanDefinition(Foo.class).addPropertyValue("x",1).getBeanDefinition()——Bean 定义的组装就是建造者,14.1 自动装配源码里的常客。RestTemplate/WebClient 链式配置、OkHttpClient.Builder、Stream.Builder——凡「配置项一堆、最终产一个」的 API,十有八九是它。MyBatis-Plus 的 LambdaQueryWrapper(24.3 见过 easy-es 同款):查询条件链式拼装后一条 SQL 成型——建造者思想在 DSL 里的化身。

建造者 vs 工厂:一句话分界

工厂关心「造哪个」(类型决策),建造者关心「怎么配」(参数组装)。产品类型固定但配置组合多——建造者;产品类型本身要挑——工厂。两者常组合:工厂内部用建造者装配产品。

三个非经典变体:可复用、配置定型与 toBuilder

生产框架里的建造者常有三个变形,认得出才算真见过世面。其一是可复用建造者:OkHttp 的 OkHttpClient 充分「共享一切」,client.newBuilder() 从既有 client 派生新 Builder 改一两个配置再造一个——官方支持、线程安全(新 Builder 深拷贝快照);对照手写版「一次一 Builder」的规矩,差异在 OkHttp 的建造发生在构造器里完成快照拷贝,复用的安全性是拷贝买来的。其二是「配置定型」型:Guava 的 CacheBuilder 链式设置的全是缓存策略(容量、过期、统计),build(CacheLoader) 时这些配置一次性定型产出 Cache——此后 Cache 内部不再暴露任何配置修改,建造期与使用期的边界被严格焊死,这是「半成品流不出去」原则的工业级执行。其三是 toBuilder 逆向工厂:Lombok 的 @Builder(toBuilder=true) 给实例生成 toBuilder(),从旧实例拷贝出 Builder、改两个字段再 build——「复制微调」替代「逐字段 set」,DDD 里改聚合状态、配置对象热更新的标准手法,与 String 的 replace 返回新对象同一个哲学:不改原物,造一个新的。

record 时代:建造者还要不要

Java 的 record(一行定义不可变载体,16 转正)抢走了一部分建造者的地盘:紧凑构造器里能做校验,final 与不可变性天然自带。但 record 没解决两个问题:可选参数的默认值(record 的规范构造器是全参的,调用方仍要数逗号传 null)与分步组装(十几个分量的 record,一行构造调用照样难读)。所以 record 时代的正确姿势是「record 做产品、手写或生成 Builder 做装配」——Lombok 的 @Builder 早已支持 record,Spring 的很多新 API 也是 record+builder 双持。面试聊到这层,「建造者的价值在装配礼仪而不在不可变性(那是 record 的活)」这句话能把讨论从语法层面拉到设计层面。

最后一道高频追问是「建造者与模板方法的混淆」:模板方法管「流程骨架固定、步骤实现可变」(父类定步骤顺序,子类填内容),建造者管「参数自由组合、产出一次成型」——一个是步骤的编排权,一个是参数的组装权,答案里各带一个框架现场(JdbcTemplate 是模板、OkHttp.Builder 是建造者)即可干净收口;如果面试官继续追问两者的组合,RestTemplateBuilder 一边链式攒配置一边按模板流程初始化客户端,就是现成的组合案例。

踩坑清单

面试怎么问

一句话总结

建造者模式把「构造」从一步惊魂改成四步从容:链式设参、必填进构造器、build 一次成型、产出即不可变——参数表越长,这套礼仪的价值越值钱。