[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 方法。以下是两个简单的例子:

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

compare/compareTo

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

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);
}
}

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

为此,Guava提供了 ComparisonChain 。

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

    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的“流畅版Comparator”中的Ordering类,参见这里

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

上一篇:Angularjs调用公共方法与共享数据


下一篇:django url 规则正确,却一直匹配错误,django url匹配错误的可能原因