ts.util.table
クラス DefaultMapComparator<K,V>

java.lang.Object
  上位を拡張 ts.util.table.DefaultMapComparator<K,V>
型パラメータ:
K - このマップのキーのタイプ。
V - このマップの値のタイプ。
すべての実装されたインタフェース:
java.util.Comparator<java.util.Map<K,V>>, MapComparator<K,V>

public class DefaultMapComparator<K,V>
extends java.lang.Object
implements MapComparator<K,V>

2つのマップの大小を比較するMapComparator インターフェイスのデフォルト実装クラス。
このインターフェイスのcomparingKeys()メソッドによって得られる イテレータからキーを順に取り出して、それに対応するマップの値の大小を 比較する。
値の大小は、指定された2つの値オブジェクトのうちのいずれかがComparableオブジェクトであれば、そのcompareToメソッドを使用 して判定し、そうでなければ値オブジェクトを文字列に変換して比較する。
またオプションとして、値の大小を逆にして返したり、ヌルと非ヌル・オブジェクト を比較したときの大小を指定したりできるようにするためのメソッドを用意して いる。

バージョン:
$Revision: 1.2 $, $Date: 2007/10/09 17:04:52 $
作成者:
佐藤隆之.

入れ子のクラスの概要
static class DefaultMapComparator.Direction
          値の大小関係の逆にするかどうかを示す列挙型クラス。
static class DefaultMapComparator.NullOrder
          ヌルと非ヌル・オブジェクトの大小関係を示す列挙型クラス。
 
コンストラクタの概要
DefaultMapComparator()
          デフォルトコンストラクタ。
DefaultMapComparator(K... indexKeys)
          インデックス・キーを引数にとるコンストラクタ。
 
メソッドの概要
 void addKey(K key)
          比較に使用するキーを追加する。
 int compare(java.util.Map<K,V> m1, java.util.Map<K,V> m2)
          comparingKeys()メソッドによって得られるキーに対応付けられた値を 比較し、マップの大小を判定する。
 java.util.Enumeration<K> comparingKeys()
          マップの比較に使用するキーを列挙する。
 boolean equals(java.lang.Object obj)
          引数のオブジェクトがこのオブジェクトに等しいかどうかを判定する。
 void setDirection(DefaultMapComparator.Direction dir)
          値の大小関係を逆にするかどうかを示すフラグを設定する。
 void setNullOrder(DefaultMapComparator.NullOrder nullOrder)
          ヌルと非ヌル・オブジェクトの大小関係を示すフラグ。
 
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

DefaultMapComparator

public DefaultMapComparator()
デフォルトコンストラクタ。


DefaultMapComparator

public DefaultMapComparator(K... indexKeys)
インデックス・キーを引数にとるコンストラクタ。

パラメータ:
indexKeys - インデックス・キーの配列。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)。
メソッドの詳細

setDirection

public void setDirection(DefaultMapComparator.Direction dir)
値の大小関係を逆にするかどうかを示すフラグを設定する。

パラメータ:
dir - 値の大小関係を逆にするかどうかを示すフラグ値。

setNullOrder

public void setNullOrder(DefaultMapComparator.NullOrder nullOrder)
ヌルと非ヌル・オブジェクトの大小関係を示すフラグ。

パラメータ:
nullOrder - ヌルと非ヌル・オブジェクトの大小関係を示すフラグ値。

addKey

public void addKey(K key)
比較に使用するキーを追加する。

パラメータ:
key - キー。

comparingKeys

public java.util.Enumeration<K> comparingKeys()
マップの比較に使用するキーを列挙する。

定義:
インタフェース MapComparator<K,V> 内の comparingKeys
戻り値:
マップの比較に使用するキーの列挙オブジェクト。

compare

public int compare(java.util.Map<K,V> m1,
                   java.util.Map<K,V> m2)
comparingKeys()メソッドによって得られるキーに対応付けられた値を 比較し、マップの大小を判定する。
値の比較方法は、GeneralComparatorに従う こととする。

定義:
インタフェース java.util.Comparator<java.util.Map<K,V>> 内の compare
パラメータ:
m1 - 比較対象のマップ1。
m2 - 比較対象のマップ2。
戻り値:
m1がm2より小さい場合は負の値を、m1がm2より大きい場合は正の値を、 m1とm2が等しい場合はゼロを返す。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)。
関連項目:
GeneralComparator

equals

public boolean equals(java.lang.Object obj)
引数のオブジェクトがこのオブジェクトに等しいかどうかを判定する。

定義:
インタフェース java.util.Comparator<java.util.Map<K,V>> 内の equals
オーバーライド:
クラス java.lang.Object 内の equals
パラメータ:
obj - 比較対象のオブジェクト。
戻り値:
等しい場合はtrueを、そうでない場合はfalseを返す。


Copyright (C) SATOH Takayuki All Rights Reserved.