[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities Explained)

我的技术博客经常被流氓网站恶意爬取转载。请移步原文:http://www.cnblogs.com/hamhog/p/3537367.html,享受整齐的排版、有效的链接、正确的代码缩进、更好的阅读体验。

Object 公共方法

equals

当你的对象里有的域允许 null 值时,实现 Object.equals 方法会很麻烦,因为你必须单独检查 null 。使用 Objects.equal 方法可以完成考虑null(null-sensitive)的 equals 检查,而不用担心会出现 NullPointerException 。

 

Objects.equal("a","a");// returns true
Objects.equal(null,"a");// returns false
Objects.equal("a",null);// returns false
Objects.equal(null,null);// returns true

 

注意: JDK 7中新引入的 Objects 类提供了等价的 Objects.equals 方法。

hashCode

综合一个 Object 所有的域得到hash值的过程可以更简单。Guava的 Objects.hashCode(Object...) 方法可以综合指定的域序列得出一个合理的、与域顺序相关的(order-sensitive)hash值。使用 Objects.hashCode(field1, field2, ..., fieldn) 来代替手工计算 hash 。

注意: JDK 7中新引入的 Objects 类提供了等价的 Objects.hash(Object...) 方法。

toString

良好的 toString 方法对debug很有价值,但写起来很麻烦。使用 Objects.toStringHelper 来简便地编写可用的 toString 方法。以下是两个简单的例子:

 

[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities 
Explained)
    // Returns "ClassName{x=1}"
    Objects.toStringHelper(this)
        .add("x",1)
        .toString();

   // Returns "MyObject{x=1}"
   Objects.toStringHelper("MyObject")
       .add("x",1)
       .toString();
[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities 
Explained)

 

compare/compareTo

直接实现 Comparator 或 Comparable 接口可能很麻烦。例如:

 

[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities 
Explained)
class Person implements Comparable<Person>{
    private String lastName;
    private String firstName;
    private int zipCode;
  
    public int compareTo(Person other){
        int cmp = lastName.compareTo(other.lastName);
        if(cmp != 0){
            return cmp;
        }
        cmp = firstName.compareTo(other.firstName);
        if(cmp != 0){
            return cmp;
        }
        return Integer.compare(zipCode, other.zipCode);
    }
}
[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities 
Explained)

 

这类代码容易杂乱,不易排除bug,而且冗长得让人烦。应该有更好的办法。

为此,Guava提供了 ComparisonChain 。

ComparisonChain 实施 "短路" 比较法:它在没有遇到非0(不等)结果之前,会一直比较下去;遇到了非0结果,就忽略后面的所有输入。

 

[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities 
Explained)
    public int compareTo(Foo that){
        return ComparisonChain.start()
            .compare(this.aString, that.aString)
            .compare(this.anInt, that.anInt)
            .compare(this.anEnum, that.anEnum, Ordering.natural().nullsLast())
            .result();
    }
[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities 
Explained)

 

这种流畅的用法可读性强得多,不易受笔误影响,并且不会做无用功。其中的高级比较工具是Guava的“流畅版Comparator”中的Ordering类,参见这里

中文翻译自Guava官方文档:GuavaExplained - CommonObjectUtilitiesExplained 译者:戴仓薯

[Guava官方文档翻译] 5. Guava的Object公共方法 (Common Object Utilities Explained)

上一篇:JS 中 `toLocaleString`妙用


下一篇:归并排序递归算法