《Effective Java》第2条:遇到多个构造器参数时要考虑用构建器

原文地址: https://itweknow.cn/detail?id=47 , 欢迎大家访问。

我们构建一个对象的几种方式

  • 构造器
  • 静态工厂方法
  • 构建器
    在书中提到了当我们遇到了大量的可选参数时,获取对象实例的几种方式(重叠构造方法,无参构造器配合JavaBean的setter方法,构建器),书中也分别列出了使用这几种方式的优劣之处。

重叠构造器

我们这里也以一个实际的例子入手,我们当前有一个用户类如下:

public class UserConstruct {

    /**
     * id
     */
    private Long id;

    /**
     * 姓名
     */
    private String name;

    /**
     * 身份证号
     */
    private String idNumber;

    /**
     * 地址
     */
    private String address;

    /**
     * 信息是否完整
     * true : name,idNumber,address必须都有的情况下
     * false : 上述属性有一个或多个为空
     */
    private boolean infoIsComplete;

    public UserConstruct(Long id, String name) {
        this(id, name, null, null);
    }

    public UserConstruct(Long id, String name, String idNumber) {
        this(id, name, idNumber, null);
    }

    public UserConstruct(Long id, String name, String idNumber, String address) {
        this.id = id;
        this.name = name;
        this.idNumber = idNumber;
        this.address = address;
        if (null != id && null != name 
                && null != idNumber && null != address) {
            this.infoIsComplete = true;
        }
    }
}

例子中的UserConstruct.java类共有5个成员变量,其中id,name,infoIsComplete是必选成员变量且infoIsComplete不是通过用户设置的,而是根据对象实际的属性设值情况进行赋值的。而idNumber,address则是两个可选变量。
当我们需要创建一个拥有地址而没有身份证号码的对象时,我们会这么写:

UserConstruct user = new UserConstruct(1L, "张三", null, "上海市");

你可能会想这么看起来并没有什么问题啊,但是如果当我们的可选参数不是两个而是50个的时候,构造器的参数会多么的复杂难读,而且稍有不慎就会出现参数顺序错乱的错误进而导致整个程序运行出错。
也就是说,在可选参数的数量多的情况下,虽然重叠构造器可行,但是会有诸如难读易出错的问题出现。所以不建议使用。

JavaBean的方式

在此模式下,我们通常都是通过调用一个无参构造器来构建对象,然后通过调用setter方法来设置每个必要参数,以及每个相关的可选参数。我们的用户类变成了这样:

public class UserJavaBean {

    /**
     * id
     */
    private Long id;

    /**
     * 姓名
     */
    private String name;

    /**
     * 身份证号
     */
    private String idNumber;

    /**
     * 地址
     */
    private String address;

    /**
     * 信息是否完整
     * true : name,idNumber,address必须都有的情况下
     * false : 上述属性有一个或多个为空
     */
    private boolean infoIsComplete;


    public void setId(Long id) {
        this.id = id;
    }

    public void setName(String name) {
        this.name = name;
    }

    public void setIdNumber(String idNumber) {
        this.idNumber = idNumber;
    }

    public void setAddress(String address) {
        this.address = address;
    }

    public void setInfoIsComplete(boolean infoIsComplete) {
        this.infoIsComplete = infoIsComplete;
    }
}

那么在JavaBean模式下我们初始化一个重叠构造器中例子就变成了下面这样:

UserJavaBean user = new UserJavaBean();
user.setId(1L);
user.setName("张三");
user.setAddress("上海市");
user.setInfoIsComplete(false);

这样确实代码的可读性变强了,但是也有那么几个缺点:

  • 无法保证必要参数
    这种方式我们没办法保证所有的必要参数都如我们所愿地被赋上了值,当然了这个缺点还有弥补的方案,就是我们通过调用一个包含所有必要参数的构造器来获取一个对象,而只通过setter方法来设置相关的可选参数。
  • 构造过程中JavaBean可能会处于不一致的状态
    对于这一点书中的描述有点晦涩难懂,不知道是否是翻译的问题。一个例子是infoIsComplete这个字段必须在所有的属性都被赋值后才为true,这样通过JavaBean的方式我们也没有很好的方式来通过代码的方式自动为其赋值。
    还有一点就是,如果idNumberaddress两个两个可选参数必须同时存在的时候,使用JavaBean也是有点力不从心了。
  • JavaBean模式阻止了把类变成不可变的可能
    一旦我们使用了JavaBean模式,则表明我们会为类的每个属性都编写一个共有的setter方法,也就说明我们的类无法成为一个不可变类。

构建器

根据书中的描述,构建器既能保证像重叠构造器那样的安全性,也可以有JavaBean模式那样的可读性。

public class UserBuilder {

    /**
     * id
     */
    private Long id;

    /**
     * 姓名
     */
    private String name;

    /**
     * 身份证号
     */
    private String idNumber;

    /**
     * 地址
     */
    private String address;

    /**
     * 信息是否完整
     * true : name,idNumber,address必须都有的情况下
     * false : 上述属性有一个或多个为空
     */
    private boolean infoIsComplete;

    /**
     * 构建器
     */
    public static class Builder {
        // 必传参数
        private Long id;
        private String name;
        // 可选参数
        private String idNumber;
        private String address;

        public Builder(Long id, String name) {
            this.id = id;
            this.name = name;
        }

        public Builder idNumber(String idNumber) {
            this.idNumber = idNumber;
            return this;
        }

        public Builder address(String address) {
            this.address = address;
            return this;
        }

        public UserBuilder build() {
            return new UserBuilder(this);
        }
    }


    private UserBuilder(Builder builder) {
        this.id = builder.id;
        this.name = builder.name;
        this.idNumber = builder.idNumber;
        this.address = builder.address;
        // 根据参数赋值情况,给infoIsComplete赋值
        if (this.id != null && this.name!= null
                && this.idNumber!= null && this.address != null) {
            this.infoIsComplete = true;
        }
    }
}

还是上面的例子,我们就可以改写为:

UserBuilder user = new Builder(1L, "张三").address("上海市").build();

是不是同样的易读,而且我们还可以在UserBuilder的构造器中进行参数的验证,并且可以顺利的给infoIsComplete属性自动赋值。
构建器有下面几个优点:

  • 可以和构造器一样对参数强加约束条件,比如idNumberaddress必须同时存在。
  • 可以拥有多个可变参数
  • 十分灵活,可以通过单个Builder构建多个对象,也可在构建对象时对参数进行调整。

当然了,构建器也有不足的地方,为了创建一个对象,我们首先必须创建一个它的构建器对象,这可能在一定程度上会消耗我们的内存。所以在一些比较注重性能的情况下构建器就不那么好使了。但是在极大多数的情况下,建议我们在还是在当前或者未来参数数量比较大的类中使用构建器。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 221,198评论 6 514
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,334评论 3 398
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,643评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,495评论 1 296
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,502评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,156评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,743评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,659评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,200评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,282评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,424评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,107评论 5 349
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,789评论 3 333
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,264评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,390评论 1 271
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,798评论 3 376
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,435评论 2 359

推荐阅读更多精彩内容