javax.microedition.rms
インタフェース RecordComparator

public interface RecordComparator

このインタフェースは、どれがそれらに一致するか、それらの相対的なソートの序列位置を確かめるために２つのレコードを（実装が定義した方法にて）比較するコンパレータを定義します。 アプリケーションは２つの候補レコードを比較するこのインタフェースを実装します。 この実装は２つのレコードの序列を示す値を返します。 アプリケーションが指定した順にレコードをソートして返すために、compare(byte[], byte[]) メソッドは RecordEnumeration によって呼び出されます。 例えば：

     // データベースヘッダの最初に来るレコードを返します。 
     RecordComparator c = new AddressRecordComparator(); 
     if (c.compare(recordStore.getRecord(rec1), recordStore.getRecord(rec2)) 
              == RecordComparator.PRECEDES)
     return rec1;

導入されたバージョン:

MIDP 1.0

EQUIVALENT

static final int EQUIVALENT

サーチあるいはソート・オーダーにおいて、２つのレコードが同じであることを示す定数（=0）です。 これは２つのレコードが同一であることを必ずしも意味しません。

関連項目:

定数フィールド値

FOLLOWS

static final int FOLLOWS

サーチあるいはソート・オーダーにおいて、左（第１のパラメータ）のレコードが右（第２のパラメータ）のレコードに後続することを示す定数（=1）です。

関連項目:

定数フィールド値

PRECEDES

static final int PRECEDES

サーチあるいはソート・オーダーにおいて、左（第１のパラメータ）のレコードが右（第２のパラメータ）のレコードに先行することを示す定数（=-1）です。

関連項目:

定数フィールド値

compare

int compare(byte[] rec1,
            byte[] rec2)

rec1 と rec2 を比較し、適用するソート・オーダーを返します。 適用するソート・オーダーとルールは以下の通りです。

• rec1 がソート・オーダーで rec2 に先行する場合には PRECEDES を返します。
• rec1 がソート・オーダーで rec2 に後続する場合には FOLLOWS を返します。
• rec1 がソート・オーダーで rec2 と等価である場合には EQUIVALENT を返します。

パラメータ:

rec1 - 比較のために使用する最初のレコードを渡します。 アプリケーションはこのメソッド内でこのパラメータを読み出し専用として扱わなければなりません。

rec2 - 比較のために使用する第２のレコードを渡します。 アプリケーションはこのメソッド内でこのパラメータを読み出し専用として扱わなければなりません。

戻り値:

比較結果に一致する、EQUIVALENT、FOLLOWS、PRECEDES のいずれかの値を返します。