|
Oracle® Coherence Java API Reference Release 12.1.2.0.3 E26043-02 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
com.tangosol.util.Base
com.tangosol.util.comparator.SafeComparator
public class SafeComparator
Null-safe delegating comparator. Null values are evaluated as "less then" any non-null value. If the wrapped comparator is not specified then all non-null values must implement the Comparable
interface.
Use SafeComparator.INSTANCE to obtain an instance of non-delegating SafeComparator.
Field Summary | |
---|---|
static SafeComparator |
INSTANCE The trivial SafeComparator. |
protected java.util.Comparator |
m_comparator The wrapped Comparator. |
Constructor Summary | |
---|---|
SafeComparator() Default constructor (for ExternalizableLite and PortableObject). |
|
SafeComparator(java.util.Comparator comparator) Construct a SafeComparator delegating to the specified (wrapped) comparator. |
Method Summary | |
---|---|
int |
compare(java.lang.Object o1, java.lang.Object o2) Compares its two arguments for order. |
int |
compareEntries(QueryMap.Entry entry1, QueryMap.Entry entry2) Compare two entries using the underlying comparator. |
static int |
compareSafe(java.util.Comparator comparator, java.lang.Object o1, java.lang.Object o2) Compares its two arguments for order. |
boolean |
equals(java.lang.Object o) Determine if two comparators are equal. |
java.util.Comparator |
getComparator() Obtain the wrapped Comparator. |
int |
hashCode() Return the hash code for this comparator. |
boolean |
isKeyComparator() Specifies whether this comparator expects to compare keys or values. |
static boolean |
isKeyComparator(java.util.Comparator comparator) Check whether the specified comparator expects to compare keys or values. |
void |
readExternal(java.io.DataInput in) Restore the contents of this object by loading the object's state from the passed DataInput object. |
void |
readExternal(PofReader in) Restore the contents of a user type instance by reading its state using the specified PofReader object. |
java.lang.String |
toString() Return a human-readable description for this Comparator. |
void |
writeExternal(java.io.DataOutput out) Save the contents of this object by storing the object's state into the passed DataOutput object. |
void |
writeExternal(PofWriter out) Save the contents of a POF user type instance by writing its state using the specified PofWriter object. |
Field Detail |
---|
public static final SafeComparator INSTANCE
protected java.util.Comparator m_comparator
Constructor Detail |
---|
public SafeComparator()
public SafeComparator(java.util.Comparator comparator)
comparator
- Comparator object to delegate comparison of non-null values (optional)Method Detail |
---|
public int compare(java.lang.Object o1, java.lang.Object o2)
Comparable
interface.compare
in interface java.util.Comparator
o1
- the first object to be comparedo2
- the second object to be comparedjava.lang.ClassCastException
- if the arguments' types prevent them from being compared by this Comparator.public int compareEntries(QueryMap.Entry entry1, QueryMap.Entry entry2)
compareEntries
in interface QueryMapComparator
entry1
- the first entry to compare values from; read-onlyentry2
- the second entry to compare values from; read-onlypublic boolean isKeyComparator()
isKeyComparator
in interface EntryAwareComparator
public static boolean isKeyComparator(java.util.Comparator comparator)
comparator
- a Comparator to checkpublic java.util.Comparator getComparator()
public static int compareSafe(java.util.Comparator comparator, java.lang.Object o1, java.lang.Object o2)
Comparable
interface.comparator
- a comparator to use for the comparison (optional)o1
- the first object to be comparedo2
- the second object to be comparedjava.lang.ClassCastException
- if the arguments are not Comparablepublic java.lang.String toString()
public boolean equals(java.lang.Object o)
equals
in interface java.util.Comparator
o
- the other comparatorpublic int hashCode()
public void readExternal(java.io.DataInput in) throws java.io.IOException
readExternal
in interface ExternalizableLite
in
- the DataInput stream to read data from in order to restore the state of this objectjava.io.IOException
- if an I/O exception occursjava.io.NotActiveException
- if the object is not in its initial state, and therefore cannot be deserialized intopublic void writeExternal(java.io.DataOutput out) throws java.io.IOException
writeExternal
in interface ExternalizableLite
out
- the DataOutput stream to write the state of this object tojava.io.IOException
- if an I/O exception occurspublic void readExternal(PofReader in) throws java.io.IOException
readExternal
in interface PortableObject
in
- the PofReader from which to read the object's statejava.io.IOException
- if an I/O error occurspublic void writeExternal(PofWriter out) throws java.io.IOException
writeExternal
in interface PortableObject
out
- the PofWriter to which to write the object's statejava.io.IOException
- if an I/O error occurs
|
Oracle® Coherence Java API Reference Release 12.1.2.0.3 E26043-02 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |