定义

当构造函数参数过多且需要进行校验时，使用建造者模式。作用：

  • 避免构造函数参数过多
  • 校验属性之间的依赖关系和约束条件
  • 隐藏set方法，构造不可变对象

结构

  1. 产品角色（Product）：它是包含多个组成部件的复杂对象，由具体建造者来创建其各个零部件。
  2. 抽象建造者（Builder）：它是一个包含创建产品各个子部件的抽象方法的接口，通常还包含一个返回复杂产品的方法 getResult()。
  3. 具体建造者(Concrete Builder）：实现 Builder 接口，完成复杂产品的各个部件的具体创建方法。
  4. 指挥者（Director）：它调用建造者对象中的部件构造与装配方法完成复杂对象的创建，在指挥者中不涉及具体产品的信息。

建造者模式(Builder Pattern) - 图1

实例

  2. public class ResourcePoolConfig {
  3.   private String name;
  4.   private int maxTotal;
  5.   private int maxIdle;
  6.   private int minIdle;
  8.   private ResourcePoolConfig(Builder builder) {
  9.     this.name = builder.name;
  10.     this.maxTotal = builder.maxTotal;
  11.     this.maxIdle = builder.maxIdle;
  12.     this.minIdle = builder.minIdle;
  13.   }
  14.   //...省略getter方法...
  16.   //我们将Builder类设计成了ResourcePoolConfig的内部类。
  17.   //我们也可以将Builder类设计成独立的非内部类ResourcePoolConfigBuilder。
  18.   public static class Builder {
  19.     private static final int DEFAULT_MAX_TOTAL = 8;
  20.     private static final int DEFAULT_MAX_IDLE = 8;
  21.     private static final int DEFAULT_MIN_IDLE = 0;
  23.     private String name;
  24.     private int maxTotal = DEFAULT_MAX_TOTAL;
  25.     private int maxIdle = DEFAULT_MAX_IDLE;
  26.     private int minIdle = DEFAULT_MIN_IDLE;
  28.     public ResourcePoolConfig build() {
  29.       // 校验逻辑放到这里来做，包括必填项校验、依赖关系校验、约束条件校验等
  30.       if (StringUtils.isBlank(name)) {
  31.         throw new IllegalArgumentException("...");
  32.       }
  33.       if (maxIdle > maxTotal) {
  34.         throw new IllegalArgumentException("...");
  35.       }
  36.       if (minIdle > maxTotal || minIdle > maxIdle) {
  37.         throw new IllegalArgumentException("...");
  38.       }
  40.       return new ResourcePoolConfig(this);
  41.     }
  43.     public Builder setName(String name) {
  44.       if (StringUtils.isBlank(name)) {
  45.         throw new IllegalArgumentException("...");
  46.       }
  47.       this.name = name;
  48.       return this;
  49.     }
  51.     public Builder setMaxTotal(int maxTotal) {
  52.       if (maxTotal <= 0) {
  53.         throw new IllegalArgumentException("...");
  54.       }
  55.       this.maxTotal = maxTotal;
  56.       return this;
  57.     }
  59.     public Builder setMaxIdle(int maxIdle) {
  60.       if (maxIdle < 0) {
  61.         throw new IllegalArgumentException("...");
  62.       }
  63.       this.maxIdle = maxIdle;
  64.       return this;
  65.     }
  67.     public Builder setMinIdle(int minIdle) {
  68.       if (minIdle < 0) {
  69.         throw new IllegalArgumentException("...");
  70.       }
  71.       this.minIdle = minIdle;
  72.       return this;
  73.     }
  74.   }
  75. }
  77. // 这段代码会抛出IllegalArgumentException，因为minIdle>maxIdle
  78. ResourcePoolConfig config = new ResourcePoolConfig.Builder()
  79.         .setName("dbconnectionpool")
  80.         .setMaxTotal(16)
  81.         .setMaxIdle(10)
  82.         .setMinIdle(12)
  83.         .build();

与工厂模式的区别

工厂模式是用来创建不同但是相关类型的对象（继承同一父类或者接口的一组子类），由给定的参数来决定创建哪种类型的对象。
建造者模式是用来创建一种类型的复杂对象，通过设置不同的可选参数，“定制化”地创建不同的对象。

一个生动的例子：顾客走进一家餐馆点餐，我们利用工厂模式，根据用户不同的选择，来制作不同的食物，比如披萨、汉堡、沙拉。对于披萨来说，用户又有各种配料可以定制，比如奶酪、西红柿、起司，我们通过建造者模式根据用户选择的不同配料来制作披萨。