Builder模式构建不可变对象的核心是拒绝中间可变状态:Builder每次设置返回新实例,build()唯一生成final字段、私有构造、无setter的不可变对象。

用 Builder 模式构建不可变对象的核心思路
关键不是“先建再设”,而是拒绝中间可变状态:Builder 本身可变,但每次调用 setter 方法都返回一个新 Builder 实例(含更新后的字段),最终 build() 只生成一次、且只生成完全初始化的不可变对象。对象内部所有字段用 final 修饰,构造器私有,不提供任何 setter。
分步实现:从 Builder 到不可变实体
1. 定义不可变目标类(如 Person)
所有字段声明为 final;仅提供私有全参构造器;提供 getter,不提供修改方法;重写 equals/hashCode/toString(可用 Lombok 简化)。
2. 创建静态内部 Builder 类
- 字段与目标类一致(非 final,供逐步赋值)
- 提供无参构造器或默认值初始化
- 每个“设置方法”(如 name(String))返回 this(注意:是新实例,不是原实例)
- build() 方法校验必填字段,然后调用目标类私有构造器创建并返回不可变对象
3. 实现链式调用的关键:每次 set 都 new Builder
避免在原 builder 上修改字段,而是创建副本并更新对应字段。例如:
public Builder name(String name) {
Builder copy = new Builder(this); // 复制当前状态
copy.name = name;
return copy;
}
简化写法与实用技巧
• 使用 Lombok 的 @Builder(toBuilder = true) 可自动生成完整 Builder,且支持 toBuilder() 创建副本,天然支持链式+不可变组合
• 若字段较多,可在 Builder 构造时接受已有对象(如 new Builder(existingPerson)),实现“基于旧对象微调”
• 必填字段校验放在 build() 中,抛出 IllegalStateException 或自定义异常,避免静默失败
• 对集合类字段(如 Listnew ArrayList(original) 防止外部修改影响内部状态
为什么这样能保证不可变性
• 目标对象一旦创建,所有字段不可更改(final + 无 setter)
• Builder 的每次调用不改变原有实例,只是产生新状态,杜绝了“中途被篡改”的可能
• build() 是唯一出口,且只执行一次构造,确保对象状态完整、一致、冻结

















