当EffectiveJava遇见Guava - toString(规则10)


我们都知道Java书籍有四大名著,其中 Effective Java可以说是高手进阶必看的,作者 Joshua Bloch是Google的首席Java架构师,如果把 James Gosling称为Java之父,那么Joshua Bloch就像是Java之母,是他把Java养育成人。之前曾有人讨论过Google有很多编码规范,为什么唯独没有Java版的问题,最终的结论就是:Google的Java编码规范就是 Effective Java一书,可见此书有多么重要。现在Google又推出了强大好用的Java通用类库 Guava,公认为比Apache Common好用,因为Apache要兼容老版本,所以妨碍了很多Java的新特性的使用。

既然Effective Java和Guava都诞生于Google,那么当他们相遇会什么样呢,为此我决定重温Effective Java这部著作,并针对每一条规则寻找Guava给出的解决方案,希望能更深入的掌握Java。

Effective Java第10条规则: 始终要覆盖toString方法

Effective Java里指出,"建议所有的子类都覆盖这个toString方法",这样可以使类用起来更加舒适。最重要的是这样的做法对调试非常有帮助,Guava通过 Objects.toStringHelper为我们提供了方便创建toString的方法。看下面的样例:

// Returns "ClassName{x=1}"
   Objects.toStringHelper(this)
       .add("x", 1)
       .toString();

   // Returns "MyObject{x=1}"
   Objects.toStringHelper("MyObject")
       .add("x", 1)
       .toString();


Guava关于toString的文档连接: https://code.google.com/p/guava-libraries/wiki/CommonObjectUtilitiesExplained

下面我把Effective Java的样例代码列出,并用Guava重新了toString方法

// 重写PhoneNumber的toString方法 - Effective Java中文第二版第44页
package org.effectivejava.examples.chapter03.item10;

import java.util.HashMap;
import java.util.Map;

import com.google.common.base.Objects;

public final class PhoneNumber {
        private final short areaCode;
        private final short prefix;
        private final short lineNumber;

        public PhoneNumber(int areaCode, int prefix, int lineNumber) {
                rangeCheck(areaCode, 999, "area code");
                rangeCheck(prefix, 999, "prefix");
                rangeCheck(lineNumber, 9999, "line number");
                this.areaCode = (short) areaCode;
                this.prefix = (short) prefix;
                this.lineNumber = (short) lineNumber;
        }

        private static void rangeCheck(int arg, int max, String name) {
                if (arg < 0 || arg > max)
                        throw new IllegalArgumentException(name + ": " + arg);
        }

        @Override
        public boolean equals(Object o) {
                if (o == this)
                        return true;
                if (!(o instanceof PhoneNumber))
                        return false;
                PhoneNumber pn = (PhoneNumber) o;
                return pn.lineNumber == lineNumber && pn.prefix == prefix
                                && pn.areaCode == areaCode;
        }

        @Override
        public int hashCode() {
                int result = 17;
                result = 31 * result + areaCode;
                result = 31 * result + prefix;
                result = 31 * result + lineNumber;
                return result;
        }

    //Effective Java原有的toString方法
        /*
         * @Override public String toString() { return
         * String.format("(%03d) %03d-%04d", areaCode, prefix, lineNumber); }
         */

        /**
         * 采用Guava实现的toString
         *
         */
        @Override
        public String toString() {
                return Objects.toStringHelper(this)
                                .addValue(String.format("(%03d) %03d-%04d", areaCode, prefix,lineNumber))
                                .add("areaCode", areaCode)
                                .add("prefix", prefix)
                                .add("lineNumber", lineNumber)
                                .toString();
        }

        public static void main(String[] args) {
                Map<PhoneNumber, String> m = new HashMap<PhoneNumber, String>();
                m.put(new PhoneNumber(707, 867, 5309), "Jenny");

                System.out.println(m);
        }
}

输出对比

//原输出
{(707) 867-5309=Jenny}

//Guava实现输出
{PhoneNumber{(707) 867-5309, areaCode=707, prefix=867, lineNumber=5309}=Jenny}

2013-05-24

posted on 2013-05-29 11:40 kuuyee 阅读(5255) 评论(2)  编辑  收藏 所属分类: JEE

评论

# re: 当EffectiveJava遇见Guava - toString(规则10) 2013-05-29 16:53 tcmaster

真看不出这个tostringhelper好在哪里。除了追赶fluent syntax的时髦和技巧炫耀。tostring本身是个简单东西。一个format绰绰有余。format的好处是看到formatstring,你就能大概想象出输出结果。而这个狗ri的tostringhelper,看了n行还要自己拼凑。典型的over engineering  回复  更多评论   

# re: 当EffectiveJava遇见Guava - toString(规则10) 2013-05-29 22:23 Unmi

这和 Apache commons 的 ToStringBuilder 也没多大差别,toString() 方法好象玩不出太多的名堂。  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 

导航

<2013年5月>
2829301234
567891011
12131415161718
19202122232425
2627282930311
2345678

统计

随笔分类(139)

Linux内核

搜索

积分与排名

最新评论

阅读排行榜