建造者模式

建造者模式（Builder Pattern)是物件建立軟體設計模式，其目的是找到伸縮構造器反模式的解決方案。先簡單說一下伸縮構造器反模式是什麼：假如我們有如下建構函式：

public Hero(Profession profession, String name, HairType hairType, HairColor hairColor, Armor armor, Weapon weapon) {
}

可以看到，建構函式引數的數量很多，而且將來可能會新增更多的引數，這就已經很難去控制數量了。並且在使用建構函式的時候很難理解引數的排列順序，這就可稱之為伸縮構造器反模式。

所以建造者模式的目的就是將複雜物件的構造與其表示分開，以便相同的構造過程可以建立不同的表示。

簡單來說，建造者模式允許建立不同風格的物件，同時避免建構函式汙染，這在有多種建構函式或者建立物件涉及許多步驟時很有用。

下面用實際例子來說明：

/**
 * @Author: BaiDing
 * @Date: 2018/9/20 13:42
 * @Email: [email protected]
 */
public class QueryPaginationResponse implements Serializable{

    private int status;     // 查詢是否成功 1,0
    private int current;    // 當前頁
    private
 
 int total;      // 總頁數
    private int count;      // 總記錄數
    private int pageSize;   // 一頁的記錄數
    private List<Object> list; // 得到的資料

    public QueryPaginationResponse(int status){
        this.status = status;
    }

    public int getStatus() {
        return status;
    }

    public void setStatus
 
(int status) {
        this.status = status;
    }

    public int getCurrent() {
        return current;
    }

    public void setCurrent(int current) {
        this.current = current;
    }

    public int getTotal() {
        return total;
    }

    public void setTotal(int total) {
        this.total = total;
    }

    public int getCount() {
        return count;
    }

    public void setCount(int count) {
        this.count = count;
    }

    public int getPageSize() {
        return pageSize;
    }

    public void setPageSize(int pageSize) {
        this.pageSize = pageSize;
    }

    public List<Object> getList() {
        return list;
    }

    public void setList(List<Object> list) {
        this.list = list;
    }

    @Override
    public String toString() {
        return "QueryPaginationResponse{" +
            "status=" + status +
            ", current=" + current +
            ", total=" + total +
            ", count=" + count +
            ", pageSize=" + pageSize +
            ", list=" + list +
            '}';
    }

    public static class Builder {
        private QueryPaginationResponse instance;

        public Builder(QueryPaginationResponse q){this.instance = q;}
        
        public Builder(int status){
            this(new QueryPaginationResponse(status));
        }

        public Builder setCurrent(int current){
            this.instance.current = current;
            return this;
        }

        public Builder setTotal(int total){
            this.instance.total = total;
            return this;
        }

        public Builder setCount(int count){
            this.instance.count = count;
            return this;
        }

        public Builder setPageSize(int pageSize){
            this.instance.pageSize = pageSize;
            return this;
        }

        public Builder setList(List<Object> list){
            this.instance.list = list;
            return this;
        }

        public QueryPaginationResponse build(){
            return this.instance;
        }
    }
}

QueryPaginationResponse response = new QueryPaginationResponse.Builder(1).setCount(100)
    .setCurrent(1).setTotal(2).setPageSize(50).setList(new ArrayList<>()).build();

System.out.println(response.toString());

在以往，當我們需要new一個QueryPaginationResponse物件的時候，往往直接呼叫建構函式生成一個物件，如：

public QueryPaginationResponse(int status, int current, int total, int count) {
    this.status = status;
    this.current = current;
    this.total = total;
    this.count = count;
}

當成員屬性只有上述四個的時候，建構函式也只有四個引數。但當加了一個成員屬性pageSize的話，那麼就要修改建構函式，或者過載建構函式

public QueryPaginationResponse(int status, int current, int total, int count, int pageSize) {
    this.status = status;
    this.current = current;
    this.total = total;
    this.count = count;
    this.pageSize = pageSize;
}

若是又增加了一個屬性的話，那麼還得重複上述步驟，修改或者過載：

public QueryPaginationResponse(int status, int current, int total, int count, int pageSize, List<Object> list) {
    this.status = status;
    this.current = current;
    this.total = total;
    this.count = count;
    this.pageSize = pageSize;
    this.list = list;
}

這就為程式碼的呼叫帶來了大大的不便。

Builder模式就可以用來解決這種複雜的物件構造邏輯。

從上述展示的例子程式碼可以看到，在QueryPaginationResponse類內部，我們新建了一個內部類Builder，Builder類內部含有一個QueryPaginationResponse型別的屬性。Builder類內部有兩個建構函式，其目的就是例項化這個QueryPaginationResponse型別的屬性。

public static class Builder {
    private QueryPaginationResponse instance;
	public Builder(QueryPaginationResponse q){this.instance = q;}
    public Builder(int status){
        this(new QueryPaginationResponse(status));
    }

之後就是建立QueryPaginationResponse物件各個屬性的賦值方法了，方法名隨意，但是這些賦值方法都是給這個Builder物件連續呼叫的，所以方法內部還得返回這個Builder物件return this;。

public Builder setTotal(int total){
    // 實質給QueryPaginationResponse例項賦值
    this.instance.total = total;
    return this;
}

public Builder setCount(int count){
    this.instance.count = count;
    return this;
}

public Builder setPageSize(int pageSize){
    this.instance.pageSize = pageSize;
    return this;
}

public Builder setList(List<Object> list){
    this.instance.list = list;
    return this;
}

最後宣告一個方法將這個Builder類內部的例項返回出去就可以了

public QueryPaginationResponse build(){
    return this.instance;
}

最終程式碼就是這個樣子，採用Builder設計模式。當我們需要建立不同風格的物件時候，不再需要過載構造函數了，只需要確定Builder例項呼叫哪個賦值方法就可以了。

// 給5個屬性的QueryPaginationResponse例項
QueryPaginationResponse response = new QueryPaginationResponse.Builder(1).setCount(100)
    .setCurrent(1).setTotal(2).setPageSize(50).setList(new ArrayList<>()).build();

// 給4個屬性的QueryPaginationResponse例項
QueryPaginationResponse response = new QueryPaginationResponse.Builder(1).setCount(100)
    .setCurrent(1).setTotal(2).setPageSize(50).build();