| javax.microedition.rms.RecordComparator
| RecordComparator | | public interface RecordComparator (Code) | | An interface defining a comparator which compares two records (in an
implementation-defined manner) to see if they match or what their
relative sort order is. The application implements this interface
to compare two candidate records. The return value must indicate
the ordering of the two records. The compare method is called by
RecordEnumeration to sort and return records in an application
specified order. For example:
RecordComparator c = new AddressRecordComparator();
if (c.compare(recordStore.getRecord(rec1), recordStore.getRecord(rec2))
== RecordComparator.PRECEDES)
return rec1;
since:
MIDP 1.0 |
| Field Summary | |
| final public static int | EQUIVALENT
EQUIVALENT means that in terms of search or sort order, the
two records are the same. | | final public static int | FOLLOWS
FOLLOWS means that the left (first parameter) record follows
the right (second parameter) record in terms of search or
sort order. | | final public static int | PRECEDES
PRECEDES means that the left (first parameter) record precedes
the right (second parameter) record in terms of search or
sort order. |
| Method Summary | |
| abstract public int | compare(byte[] rec1, byte[] rec2)
Returns RecordComparator.PRECEDES if rec1
precedes rec2 in sort order, or RecordComparator.FOLLOWS
if rec1 follows rec2 in sort order, or
RecordComparator.EQUIVALENT if rec1 and rec2
are equivalent in terms of sort order.
Parameters:
rec1 - the first record to use for comparison. |
| EQUIVALENT | | final public static int EQUIVALENT(Code) | | EQUIVALENT means that in terms of search or sort order, the
two records are the same. This does not necessarily mean that
the two records are identical.
The value of EQUIVALENT is 0.
|
| FOLLOWS | | final public static int FOLLOWS(Code) | | FOLLOWS means that the left (first parameter) record follows
the right (second parameter) record in terms of search or
sort order.
The value of FOLLOWS is 1.
|
| PRECEDES | | final public static int PRECEDES(Code) | | PRECEDES means that the left (first parameter) record precedes
the right (second parameter) record in terms of search or
sort order.
The value of PRECEDES is -1.
|
| compare | | abstract public int compare(byte[] rec1, byte[] rec2)(Code) | | Returns RecordComparator.PRECEDES if rec1
precedes rec2 in sort order, or RecordComparator.FOLLOWS
if rec1 follows rec2 in sort order, or
RecordComparator.EQUIVALENT if rec1 and rec2
are equivalent in terms of sort order.
Parameters:
rec1 - the first record to use for comparison. Within thismethod, the application must treat this parameter asread-only.
Parameters:
rec2 - the second record to use for comparison. Withinthis method, the application must treat this parameteras read-only. RecordComparator.PRECEDES if rec1 precedesrec2 in sort order, orRecordComparator.FOLLOWS if rec1 followsrec2 in sort order, orRecordComparator.EQUIVALENT if rec1 andrec2 are equivalent in terms of sort order |
|
|