equals方法实现小记
    最近做项目，在一次写equals方法时突然悟出了一些心得，小记之，以备后用。在《Effective Java（第二版）》的Item7中提出我们要尽量避免重新equals方法，他同时也列举了几种我们不需要实现equals方法的情况：
1）类的每个实例从本质上来说是唯一的，如Thread类的实例。
2）我们并不会用到该类的equals方法，如Random类，虽然可以比较两个Random的实例，以判断两个实例是否可以产生相同的随机数，设计者认为这样的需求用到的场合很少，因而就没有重写equals方法。
3）父类已经实现了equals方法，并且父类实现方式和子类实现方式是一样的，如大部分的Set实现的equals方法使用AbstractSet类提供的equals方法，List实现则使用AbstractList，Map实现使用AbstractMap的。
4）一个private类或package-private类，我们自己可以确保我们不会使用到它们的equals方法。
同时书也提出一般只有值类型的类才需要实现equals方法，像Date、Integer、Order（作为bean来使用）等。
另外，我们在实现equals方法是也要遵循以下几个原则：
1）自反性（reflexive）：x.equals(x)＝＝true
2）对称性（symmetric）：x.equals(y)==y.equals(x)
3）传递性（transitive）：若x.equals(y)==true, y.equals(z)==true,则x.equals(z)==true。
4）一致性（consistent）：多次调用x.equals(y)的结果应该是一样的。
5）对任何非null实例x，x.equals(null)＝＝false。

mark~{:soso_e102:}{:soso_e100:}

饿{:soso_e102:}

在《Effective Java》这本书中，貌似equals实现方法前面没有null、this的判断，因为instanceof可以解决null的问题，而super.equals()方法可以解决this问题，但是我还是喜欢把它们都分出来，这样写的更加明了一些。另外，事实上，这里的实现并没有遵循对称性的原则，因为如果A是B的子类，而这个equals方法在A类中，那么AInstance.equals(BInstance)==false，若B也实现了类似的equals方法，则BInstance.equals(AInstance)==true(当A没有新的比较字段时，或许这个时候A根本就不需要实现equals方法，如本文开头列出的第三条），这是因为AInstance instanceof BInstance ＝＝ true，反之则为false。不过由于这种情况并不常见，所以就不去care了。:)
    事实上，这里我之所以要记录这些代码，主要是因为有ObjectUtils类的存在。记得以前在学C#的时候，它的Object类提供了一个静态的Equals方法，我一直对这个方法的存在感到很疑问，直到这次自己写这个equals方法才弄明白，因为虽然在equals方法实现中，最后还要判断类字段是否equals，然后这些字段都有可能是null的，如果没有提供这个静态的equals方法，我们就需要自己来判断每个字段是否为null，然后才可以调用它的equals方法，这样就比较麻烦了，而Object.Equals方法正是对这种行为的封装，我们只要使用一个方法就可以安全的实现类成员的equals。这也是我加ObjectUtils类的意义所在。希望以后能有机会向这个ObjectUtils类填充更多的实用方法。:)
PS:如一楼所说在commons中的EqualsBuilder已经实现了相同的功能，而且代码更加完善，有兴趣的可以看看那里的代码，我这里只是对这次新的的记录，代码只是对当前我考虑的场景中使用，并没有考虑其他方面。另外，在《Effective Java》中也是建议equals和hashCode两个方法应该是同时实现的，一楼也有说可以用HashCodeBuider来实现，这个大家也不妨可以去看看里面的源码，最近时间不多，以后回来再看。。。。。。

根据这些特性，我们可以写出如下代码：
1 public class Customer implements Serializable {
2     private static final long serialVersionUID = 1L;
3    
4     private String id;
5     private String name;
6     private String role;
7    
8     @Override
9     public boolean equals(Object obj) {
10         if(obj == null) {
11             return false;
12         }
13         
14         if(this == obj) {
15             return true;
16         }
17         
18         if(!(obj instanceof Customer)) {
19             return false;
20         }
21         
22         Customer other = (Customer)obj;
23         return (ObjectUtils.equals(id, other.id) &&
24                 ObjectUtils.equals(name, other.name) &&
25                 ObjectUtils.equals(role, other.role));
26     }
27    
28     public String getId() {
29         return id;
30     }
31     public void setId(String id) {
32         this.id = id;
33     }
34     public String getName() {
35         return name;
36     }
37     public void setName(String name) {
38         this.name = name;
39     }
40     public String getRole() {
41         return role;
42     }
43     public void setRole(String role) {
44         this.role = role;
45     }
46 }
其中ObjectUtils类的代码如下：
1 public class ObjectUtils {
2    
3     /**
4      * Compare whether the left and right is equals
5      * It has already considered the null case
6      *
7      * @param left
8      * @param right
9      * @return
10      */
11     public static boolean equals(Object left, Object right) {
12         if(left == null && right == null) {
13             return true;
14         }
15         if(left == null && right != null) {
16             return false;
17         }
18         return left.equals(right);
19     }
20 }