建造者模式

JDK 最新版本中 HTTP/2 Client API，下面这个创建 HttpRequest 的过程，就是典型的构建器模式（Builder），通常会被实现成fluent 风格的 API，也有人叫它方法链。

HttpRequest request = HttpRequest.newBuilder(new URI(uri))
                     .header(headerAlice, valueAlice)
                     .headers(headerBob, value1Bob,
                      headerCarl, valueCarl,
                      headerBob, value2Bob)
                     .GET()
                     .build();

使用构建器模式，可以比较优雅地解决构建复杂对象的麻烦，这里的“复杂”是指类似需要输入的参数组合较多，如果用构造函数，我们往往需要为每一种可能的输入参数组合实现相应的构造函数，一系列复杂的构造函数会让代码阅读性和可维护性变得很差。

上面的分析也进一步反映了创建型模式的初衷，即，将对象创建过程单独抽象出来，从结构上把对象使用逻辑和创建逻辑相互独立，隐藏对象实例的细节，进而为使用者实现了更加规范、统一的逻辑。

链式调用实例—统一返回结果对象

项目中我们会将响应封装成json返回，一般我们会将所有接口的数据格式统一， 使前端(iOS Android, Web)对数据的操作更一致、轻松。
一般情况下，统一返回数据格式没有固定的格式，只要能描述清楚返回的数据状态以及要返回的具体数据就可以。但是一般会包含状态码、返回消息、数据这几部分内容
例如，我们的系统要求返回的基本数据格式如下

{
  "success": true,
  "code": 20000,
  "message": "成功",
  "data": {
    "items": [
      {
        "id": "1",
        "name": "刘德华",
        "intro": "毕业于师范大学数学系，热爱教育事业，执教数学思维6年有余"
      }
    ]
  }
}

{
  "success": 布尔, //响应是否成功
  "code": 数字, //响应码
  "message": 字符串, //返回消息
  "data": HashMap //返回数据，放在键值对中
}

创建R.java

@Data
public class R {
    @ApiModelProperty(value = "是否成功")
    private Boolean success;

    @ApiModelProperty(value = "返回码")
    private Integer code;

    @ApiModelProperty(value = "返回消息")
    private String message;

    @ApiModelProperty(value = "返回数据")
    private Map<String, Object> data = new HashMap<String, Object>();

    private R(){}

    public static R ok(){
        R r = new R();
        r.setSuccess(true);
        r.setCode(ResultCode.SUCCESS);
        r.setMessage("成功");
        return r;
    }

    public static R error(){
        R r = new R();
        r.setSuccess(false);
        r.setCode(ResultCode.ERROR);
        r.setMessage("失败");
        return r;
    }

    public R success(Boolean success){
        this.setSuccess(success);
        return this;
    }

    public R message(String message){
        this.setMessage(message);
        return this;
    }

    public R code(Integer code){
        this.setCode(code);
        return this;
    }

    public R data(String key, Object value){
        this.data.put(key, value);
        return this;
    }

    public R data(Map<String, Object> map){
        this.setData(map);
        return this;
    }
}

调用R

@ApiOperation(value = "所有讲师列表")
@GetMapping
public R list(){
    List<Teacher> list = teacherService.list(null);
    return R.ok().data("items", list);
}

标准建造者模式加上链式调用

@Data
public class  R {
    @ApiModelProperty(value = "是否成功")
    private Boolean success;

    @ApiModelProperty(value = "返回码")
    private Integer code;

    @ApiModelProperty(value = "返回消息")
    private String message;

    @ApiModelProperty(value = "返回数据")
    private Map<String, Object> data = new HashMap<String, Object>();
//    私有构造方法
    private Builder(Builder builder){
        success = builder.success;
        code = builder.code;
        message = builder.message;
        data = builder.data;
    }

    public static class Builder{
        @ApiModelProperty(value = "是否成功")
        private Boolean success;

        @ApiModelProperty(value = "返回码")
        private Integer code;

        @ApiModelProperty(value = "返回消息")
        private String message;

        @ApiModelProperty(value = "返回数据")
        private Map<String, Object> data = new HashMap<String, Object>();

        public Builder(){}

        public Builder ok(){
            this.setSuccess(true);
            this.setCode(ResultCode.SUCCESS);
            this.setMessage("成功");
            return this;
        }
        public Builder error(){

            this.setSuccess(false);
            this.setCode(ResultCode.ERROR);
            this.setMessage("失败");
            return this;
        }
        public Builder success(Boolean success){
            this.setSuccess(success);
            return this;
        }

        public Builder message(String message){
            this.setMessage(message);
            return this;
        }

        public Builder code(Integer code){
            this.setCode(code);
            return this;
        }

        public Builder data(String key, Object value){
            this.data.put(key, value);
            return this;
        }

        public Builder data(Map<String, Object> map){
            this.setData(map);
            return this;
        }
        public R build() {
            return new R(this);
        }
    }
    
}


// 调用R
    public R list(){
        List<Teacher> list = teacherService.list(null);
        return R.Builder.ok.data("items", list).build;
    }