com.hazelcast.query.impl

Class Comparables

java.lang.Object

com.hazelcast.query.impl.Comparables

public final class Comparables
extends Object

Provides utilities which compare and canonicalize Comparable instances.

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<Comparable>	COMPARATOR Provides the same comparision logic as compare(java.lang.Comparable, java.lang.Comparable) does, but in a form of a Comparator.

Method Summary

Modifier and Type	Method and Description
static Comparable	canonicalizeForHashLookup(Comparable value) Canonicalizes the given Comparable value for the purpose of a hash-based lookup.
static int	compare(Comparable lhs, Comparable rhs) Compares the provided Comparable instances.
static boolean	equal(Comparable lhs, Comparable rhs) Checks the provided Comparable instances for equality.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COMPARATOR

public static final Comparator<Comparable> COMPARATOR

Provides the same comparision logic as compare(java.lang.Comparable, java.lang.Comparable) does, but in a form of a Comparator.

Method Detail

equal

public static boolean equal(Comparable lhs,
                            Comparable rhs)

Checks the provided Comparable instances for equality.

Special numeric comparison logic is used for Double, Long, Float, Integer, Short and Byte. See Numbers.equal(Number, Number) for more details.

Parameters:

lhs - the left-hand side Comparable. Can't be null.

rhs - the right-hand side Comparable. May be null.

Returns:

true if the provided comparables are equal, false otherwise.

compare

public static int compare(Comparable lhs,
                          Comparable rhs)

Compares the provided Comparable instances.

Special numeric comparison logic is used for Double, Long, Float, Integer, Short and Byte. See Numbers.compare(Comparable, Comparable) for more details.

Parameters:

lhs - the left-hand side Comparable. Can't be null.

rhs - the right-hand side Comparable. Can't be null.

Returns:

a negative integer, zero, or a positive integer as the left-hand side Comparable is less than, equal to, or greater than the right-hand side Comparable.

canonicalizeForHashLookup

public static Comparable canonicalizeForHashLookup(Comparable value)

Canonicalizes the given Comparable value for the purpose of a hash-based lookup.

Special numeric canonicalization logic is used for Double, Long, Float, Integer, Short and Byte. See Numbers.canonicalizeForHashLookup(java.lang.Comparable) for more details.

Parameters:

value - the Comparable to canonicalize.

Returns:

a canonical representation of the given Comparable or the original Comparable if there is no special canonical representation for it.