ts.util.table
インタフェース Table<C,V>

型パラメータ:
C - カラム・キーのタイプ。
V - カラムの値のタイプ。
すべてのスーパーインタフェース:
MapAppender<C,V>
既知の実装クラスの一覧:
AbstractTable, AbstractTable.AbstractTableIndex, ArrayListTable, Index, MapListTable

public interface Table<C,V>
extends MapAppender<C,V>

マップ・オブジェクトをレコードとするテーブルのインターフェイス。
キー構成が同じであるマップ・オブジェクトをレコードとして、そのレコードの集合 を構成要素として持つ。
テーブルの内容の取得や更新はレコード単位で行われる。 取得や更新の条件とするカラム・キーとその値は、マップに格納して引数として メソッドに渡す。 レコードを取得するメソッドにはselect(java.util.Map)selectFirst(java.util.Map)がある。 レコードを削除するメソッドにはdelete(java.util.Map)がある。 レコードを更新するメソッドにはupdate(java.util.Map,java.util.Map) がある。
レコードを追加するには、MapAppender.appendNew()メソッドを用いる。 MapAppender.appendNew()メソッドは、戻り値としてテーブルに追加されたレコードで あるマップを返す。

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

メソッドの概要
 void addTrigger(Trigger<C,V> trigger)
          トリガーを追加する。
 int columnCount()
          テーブルを構成するカラム・キーの数を取得する。
 java.util.Enumeration<C> columns()
          このテーブルを構成するカラム・キーを列挙する。
 java.util.List<java.util.Map<C,V>> delete(java.util.Map<C,V> condition)
          条件に該当するレコードを、このテーブル・オブジェクトから削除する。
 void deleteAll()
          このテーブルに格納されているレコードを全て削除する。
 boolean exists(C column, V value)
          指定されたカラムの値が指定された値と一致するレコードが存在するかどうかを 確認する。
 boolean exists(java.util.Map<C,V> condition)
          条件に該当するレコードが存在するかどうかを確認する。
 Index<C,V> getIndex(C... indexKeys)
          指定された配列の要素をインデックス・キーとするインデックスを取得する。
 int recordCount()
          テーブルに格納されているレコードの数を取得する。
 java.util.Map<C,V> recordFirst()
          このテーブルに格納されている最初のレコードを取得する。
 MapIterator<C,V> records()
          このテーブルに格納されているレコードを順に取り出すためのイテレータを取得 する。
 MapIterator<C,V> records(MapComparator<C,V> comparator)
          このテーブルに格納されているレコードをソートして、順に取り出すための イテレータを取得する。
 java.util.List<java.util.Map<C,V>> select(C column, V value)
          指定されたカラムの値が指定された値と一致するレコードを格納したリストを を取得する。
 java.util.List<java.util.Map<C,V>> select(java.util.Map<C,V> condition)
          条件に該当するレコードを格納したリストを取得する。
 java.util.Map<C,V> selectFirst(C column, V value)
          指定されたカラムの値が指定された値と最初に一致したレコードを返す。
 java.util.Map<C,V> selectFirst(java.util.Map<C,V> condition)
          条件に最初に該当したレコードを取得する。
 java.util.List<java.util.Map<C,V>> update(java.util.Map<C,V> condition, java.util.Map<C,V> destination)
          条件に該当するレコードを、指定されたマップの内容で更新する。
 
インタフェース ts.util.table.MapAppender から継承されたメソッド
appendNew, appendNew
 

メソッドの詳細

columnCount

int columnCount()
テーブルを構成するカラム・キーの数を取得する。

戻り値:
カラム・キーの数。

recordCount

int recordCount()
テーブルに格納されているレコードの数を取得する。

戻り値:
レコード数。

columns

java.util.Enumeration<C> columns()
このテーブルを構成するカラム・キーを列挙する。

戻り値:
カラム・キーを格納した列挙オブジェクト。

records

MapIterator<C,V> records()
このテーブルに格納されているレコードを順に取り出すためのイテレータを取得 する。

戻り値:
レコードのイテレータ。

records

MapIterator<C,V> records(MapComparator<C,V> comparator)
このテーブルに格納されているレコードをソートして、順に取り出すための イテレータを取得する。

パラメータ:
comparator - ソートに使用するレコード比較オブジェクト。
戻り値:
レコードのイテレータ。

recordFirst

java.util.Map<C,V> recordFirst()
このテーブルに格納されている最初のレコードを取得する。

戻り値:
このテーブルの最初のレコード。

deleteAll

void deleteAll()
このテーブルに格納されているレコードを全て削除する。


exists

boolean exists(C column,
               V value)
指定されたカラムの値が指定された値と一致するレコードが存在するかどうかを 確認する。

パラメータ:
column - 条件とするカラム・キー。
value - 条件とするカラムの値。
戻り値:
該当するレコードが存在する場合はtrueを返す。

exists

boolean exists(java.util.Map<C,V> condition)
条件に該当するレコードが存在するかどうかを確認する。
引数のマップに格納されているキーと値の組み合わせと同じ組み合わせを持つ レコードを検索し、1件でも存在した場合はtrueを返す。

引数のマップのキーの中に、このテーブルのカラム・キーに存在しないものが あった場合は、常にfalseを返す。
反対に、このテーブルのカラム・キーの中に、引数のマップに存在しないキーを 持っていても、それらは無視される。それ以外のカラム・キーの値が等しい レコードがあればtrueを返す。
引数のマップが空だった場合は条件なしとして、このテーブルにレコードが1件 でもあった場合はtrueを返す。

パラメータ:
condition - 条件のカラムとその値を格納したマップ・オブジェクト。
戻り値:
該当するレコードが存在する場合はtrueを返す。

selectFirst

java.util.Map<C,V> selectFirst(C column,
                               V value)
指定されたカラムの値が指定された値と最初に一致したレコードを返す。

パラメータ:
column - 条件とするカラム・キー。
value - 条件とするカラムの値。
戻り値:
指定されたカラムの値と最初に一致したレコード。

selectFirst

java.util.Map<C,V> selectFirst(java.util.Map<C,V> condition)
条件に最初に該当したレコードを取得する。
引数のマップに格納されているキーと値の組み合わせと同じ組み合わせを持つ レコードを検索し、その最初のレコードを返す。
該当するレコードが1件も存在しない場合はヌルを返す。

引数のマップのキーの中に、このテーブルのカラム・キーに存在しないものが あった場合は、全てのレコードが該当しなくなり、ヌルが返される。
反対に、このテーブルのカラム・キーの中に、引数のマップに存在しないキーを 持っていても、それらは無視される。それ以外のカラム・キーの値が等しい レコードがあれば、その最初のレコードを返す。
引数のマップが空だった場合は条件なしとして、このテーブルに格納されている 最初のレコードを返す。

パラメータ:
condition - 条件のカラムとその値を格納したマップ・オブジェクト。
戻り値:
指定されたカラムの値と一致するレコード。

select

java.util.List<java.util.Map<C,V>> select(C column,
                                          V value)
指定されたカラムの値が指定された値と一致するレコードを格納したリストを を取得する。

パラメータ:
column - 条件とするカラム・キー。
value - 条件とするカラムの値。
戻り値:
指定されたカラムの値と一致するレコードを格納したリスト。

select

java.util.List<java.util.Map<C,V>> select(java.util.Map<C,V> condition)
条件に該当するレコードを格納したリストを取得する。
引数のマップに格納されているキーと値の組み合わせと同じ組み合わせを持つ レコードを検索し、そのレコードを格納したリストを返す。
該当するレコードが1件も存在しない場合は空のリストを返す。

引数のマップのキーの中に、このテーブルのカラム・キーに存在しないものが あった場合は、全てのレコードが該当しなくなり、空のリストを返す。
反対に、このテーブルのカラム・キーの中に、引数のマップに存在しないキーを 持っていても、それらは無視される。それ以外のカラム・キーの値が等しい レコードがあれば、それらをリストに格納して返す。
引数のマップが空だった場合は条件なしとして、このテーブルに格納されている 全てのレコードを格納したリストを返す。

パラメータ:
condition - 条件のカラムとその値を格納したマップ・オブジェクト。
戻り値:
指定されたカラムの値と一致するレコードを格納したリスト。

delete

java.util.List<java.util.Map<C,V>> delete(java.util.Map<C,V> condition)
条件に該当するレコードを、このテーブル・オブジェクトから削除する。
引数のマップに格納されているキーと値の組み合わせと同じ組み合わせを持つ レコードを検索して、このテーブルから削除する。
削除されたレコードは、リストに格納されて戻り値として返される。

引数のマップのキーの中に、このテーブルのカラム・キーに存在しないものが あった場合は、全てのレコードが条件に該当しなくなり、1件も削除されない。
反対に、このテーブルのカラム・キーの中に、引数のマップに存在しないキーを 持っていても、それらは無視される。それ以外のカラム・キーの値が等しい レコードがあれば、それらをこのテーブルから削除し、リストに格納して返す。
引数のマップが空だった場合は条件なしとして、このテーブルに格納されている 全てのレコードを削除し、リストに格納して返す。

パラメータ:
condition - 条件とするカラムとその値を格納したマップ・オブジェクト。
戻り値:
削除されたレコードを格納したリスト。

update

java.util.List<java.util.Map<C,V>> update(java.util.Map<C,V> condition,
                                          java.util.Map<C,V> destination)
条件に該当するレコードを、指定されたマップの内容で更新する。
第1引数のマップに格納されているキーと値の組み合わせと同じ組み合わせを持つ レコードを検索して、その中の内容を第2引数のマップの内容で更新する。
更新されたレコードは、新たに作成されたテーブル・オブジェクトに格納されて 戻り値として返される。

引数のマップのキーの中に、このテーブルのカラム・キーに存在しないものが あった場合は、全てのレコードが条件に該当しなくなり、1件も更新されない。
反対に、このテーブルのカラム・キーの中に、引数のマップに存在しないキーを 持っていても、それらは無視される。それ以外のカラム・キーの値が等しい レコードがあれば、それらの内容を更新し、リストに格納して返す。
引数のマップが空だった場合は条件なしとして、このテーブルに格納されている 全てのレコードの内容を更新し、リストに格納して返す。

パラメータ:
condition - 条件とするカラムとその値を格納したマップ・オブジェクト。
destination - 更新するカラムとその値を格納したマップ・オブジェクト。
戻り値:
更新されたレコードを格納したリスト。

getIndex

Index<C,V> getIndex(C... indexKeys)
指定された配列の要素をインデックス・キーとするインデックスを取得する。
該当するインデックスが存在しない場合は、インデックスを作成して返す。

パラメータ:
indexKeys - インデックス・キーの配列。
戻り値:
このテーブルのインデックス・オブジェクト。

addTrigger

void addTrigger(Trigger<C,V> trigger)
トリガーを追加する。
追加されたトリガーは、このテーブルの内容が変更される直前及び直後に 呼び出され、テーブルの変更の種類と変更の前後に応じたメソッドが実行 される。

パラメータ:
trigger - トリガー・オブジェクト。


Copyright (C) SATOH Takayuki All Rights Reserved.