boolean java.lang.Object.equals(Object obj)
Indicates whether some other object is "equal to" this one.
The equals
method implements an equivalence relation on non-null object references:
- It is reflexive: for any non-null reference value
x
,x.equals(x)
should returntrue
. - It is symmetric: for any non-null reference values
x
andy
,x.equals(y)
should returntrue
if and only ify.equals(x)
returnstrue
. - It is transitive: for any non-null reference values
x
,y
, andz
, ifx.equals(y)
returnstrue
andy.equals(z)
returnstrue
, thenx.equals(z)
should returntrue
. - It is consistent: for any non-null reference values
x
andy
, multiple invocations of x.equals(y) consistently returntrue
or consistently returnfalse
, provided no information used inequals
comparisons on the objects is modified. - For any non-null reference value
x
,x.equals(null)
should returnfalse
.
The equals method for class Object
implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x
and y
, this method returns true
if and only if x
and y
refer to the same object (x == y
has the value true
).
Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.
-
Parameters:
- obj the reference object with which to compare. Returns:
-
true
if this object is the same as the obj argument;false
otherwise.
See Also:
- hashCode()
- java.util.Hashtable
自反性:
对于任意的非null引用x,x.equals(x)返回true。
对称性:
对于任意的非null引用x和y,如果x.equals(y)返回true,那么y.equals(x)也返回true。
传递性:
对于任意的非null引用x、y和z,如果x.equals(y)返回true,y.equals(z)返回true,那么x.equals(z)也返回true。
一致性:
对于任意的非null引用x和y,如果没有修改equals,那么多次调用x.equals(y),要么一致返回true,要么一致返回false。
非空性:
对于任意的非null引用x,x.equals(null)返回false。