ts.util.table
クラス Record<C,V>

java.lang.Object
  上位を拡張 ts.util.table.Record<C,V>
型パラメータ:
C - カラム・キーのタイプ。
V - カラムの値のタイプ。
すべての実装されたインタフェース:
java.io.Serializable, java.util.Map<C,V>
直系の既知のサブクラス:
ArrayListTable.ArrayListTableRecord, MapListTable.MapListTableRecord

public abstract class Record<C,V>
extends java.lang.Object
implements java.util.Map<C,V>, java.io.Serializable

テーブルのレコードを表すクラス。
Mapクラスを継承し、コンストラクタで指定されたヘッダ が保持するカラム・キーのセットを、このオブジェクトのキー・セットとして使用 する。
このヘッダは他のレコードとも共用するので、remove(java.lang.Object) メソッドやclear()メソッドを実行しても、値がヌルに設定されるだけで カラム・キーは削除されない。 その後にcontainsKey(java.lang.Object)メソッドやkeySet() メソッドを実行しても結果は変わらない。

バージョン:
$Revision: 1.1.1.1 $, $Date: 2010-10-16 00:03:51 $
作成者:
佐藤隆之.
関連項目:
直列化された形式

入れ子のクラスの概要
static class Record.SimpleEntry<C,V>
          キーと値の組を表すMap.Entryクラスを単純な実装 クラス。
 
インタフェース java.util.Map から継承された入れ子のクラス/インタフェース
java.util.Map.Entry<K,V>
 
コンストラクタの概要
Record()
          デフォルト・コンストラクタ。
 
メソッドの概要
 void clear()
          このマップの内容をクリアする。
 boolean containsKey(java.lang.Object column)
          指定されたカラム・キーを持つ要素が存在するかどうかを確認する。
 boolean containsValue(java.lang.Object value)
          指定された値を持つ要素が存在するかどうかを確認する。
 java.util.Set<java.util.Map.Entry<C,V>> entrySet()
          このマップに格納されているキーと値の組を表すエントリの集合を取得する。
 boolean equals(java.lang.Object o)
          指定されたマップと、このマップの内容が等しいかどうかを比較する。
 V get(java.lang.Object column)
          指定されたカラム・キーに対応付けられた値を取得する。
protected abstract  V getValue(java.lang.Object column)
          このレコードの、指定されたカラムの値を取得する。
 int hashCode()
          このマップのハッシュ・コードを取得する。
protected abstract  Header<C> header()
          ヘッダを取得する。
 boolean isEmpty()
          カラム数がゼロかどうかを確認する。
 java.util.Set<C> keySet()
          このマップのキー集合を取得する。
 V put(C column, V value)
          指定されたカラム・キーと値の組を、このマップに設定する。
 void putAll(java.util.Map<? extends C,? extends V> m)
          指定されたマップに格納されているキーと値の組を、このマップにコピーする。
protected abstract  V putValue(C column, V value)
          指定されたカラム・キーと値の組を、このマップに設定する。
 V remove(java.lang.Object column)
          指定されたカラム・キーに対する値をヌルに設定する。
protected abstract  V removeValue(java.lang.Object column)
          指定されたカラム・キーに対する値をヌルに設定する。
 boolean satisfyCondition(java.util.Map<C,V> condition)
          このレコードが、指定された条件を満たすかどうかを判定する。
 int size()
          カラム数を取得する。
 java.lang.String toString()
          このマップを表す文字列を取得する。
 java.util.Collection<V> values()
          このマップに格納されている値のコレクションを取得する。
 
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

Record

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

メソッドの詳細

header

protected abstract Header<C> header()
ヘッダを取得する。

戻り値:
ヘッダ・オブジェクト。

size

public int size()
カラム数を取得する。

定義:
インタフェース java.util.Map<C,V> 内の size
戻り値:
カラム数。

isEmpty

public boolean isEmpty()
カラム数がゼロかどうかを確認する。

定義:
インタフェース java.util.Map<C,V> 内の isEmpty
戻り値:
カラム数がゼロの場合はtrue、そうでなければfalse を返す。

containsKey

public boolean containsKey(java.lang.Object column)
指定されたカラム・キーを持つ要素が存在するかどうかを確認する。

定義:
インタフェース java.util.Map<C,V> 内の containsKey
パラメータ:
column - 確認対象のカラム・キー。
戻り値:
引数のカラム・キーを持つ要素が存在する場合はtrue、 そうでなければfalseを返す。
例外:
java.lang.ClassCastException - 引数のカラム・キーのクラスが、このマップに 不適当な場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルのキーを許可 していない場合。

containsValue

public boolean containsValue(java.lang.Object value)
指定された値を持つ要素が存在するかどうかを確認する。

定義:
インタフェース java.util.Map<C,V> 内の containsValue
パラメータ:
value - 確認対象の値。
戻り値:
引数の値を持つ要素が存在する場合はtrue、そうでなければ falseを返す。
例外:
java.lang.ClassCastException - 引数の値のクラスが、このマップに不適当な場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルの値を許可して いない場合。

get

public V get(java.lang.Object column)
指定されたカラム・キーに対応付けられた値を取得する。

定義:
インタフェース java.util.Map<C,V> 内の get
パラメータ:
column - カラム・キー。
戻り値:
引数のカラム・キーに対応付けられた値。
例外:
java.lang.ClassCastException - 引数のカラム・キーのクラスが、このマップに 不適当な場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルのキーを許可 していない場合。

put

public V put(C column,
             V value)
指定されたカラム・キーと値の組を、このマップに設定する。

定義:
インタフェース java.util.Map<C,V> 内の put
パラメータ:
column - カラム・キー。
value - カラム・キーに対応付けられる値。
戻り値:
引数のカラム・キーにそれまで対応付けられていた前回値。
例外:
java.lang.UnsupportedOperationException - このマップがこのメソッドの処理を サポートしていない場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルのキーや値を 許可していない場合。

remove

public V remove(java.lang.Object column)
指定されたカラム・キーに対する値をヌルに設定する。
カラム・キーの削除は行わない。

定義:
インタフェース java.util.Map<C,V> 内の remove
パラメータ:
column - カラム・キー。
戻り値:
引数のカラム・キーにそれまで対応付けられていた前回値。
例外:
java.lang.ClassCastException - 引数のカラム・キーのクラスが、このマップに 不適当な場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルのキーを許可 していない場合。

putAll

public void putAll(java.util.Map<? extends C,? extends V> m)
指定されたマップに格納されているキーと値の組を、このマップにコピーする。

定義:
インタフェース java.util.Map<C,V> 内の putAll
パラメータ:
m - コピー元のマップ。
例外:
java.lang.UnsupportedOperationException - このマップがこのメソッドの処理を サポートしていない場合。
java.lang.NullPointerException - 引数がヌルの場合、または引数のマップにヌルの キーや値が含まれていて、このマップがそれらを許可しない場合。

clear

public void clear()
このマップの内容をクリアする。
このマップに格納されている要素の値を全てヌルに設定する。 カラム・キーの削除は行わない。

定義:
インタフェース java.util.Map<C,V> 内の clear
例外:
java.lang.UnsupportedOperationException - このマップがこのメソッドの処理を サポートしていない場合。

keySet

public java.util.Set<C> keySet()
このマップのキー集合を取得する。

定義:
インタフェース java.util.Map<C,V> 内の keySet
戻り値:
このマップのキー集合。

values

public java.util.Collection<V> values()
このマップに格納されている値のコレクションを取得する。

定義:
インタフェース java.util.Map<C,V> 内の values
戻り値:
このマップに格納されている値のコレクション。

entrySet

public java.util.Set<java.util.Map.Entry<C,V>> entrySet()
このマップに格納されているキーと値の組を表すエントリの集合を取得する。

定義:
インタフェース java.util.Map<C,V> 内の entrySet
戻り値:
このマップに格納されているキーと値の組を表すエントリの集合。

equals

public boolean equals(java.lang.Object o)
指定されたマップと、このマップの内容が等しいかどうかを比較する。
それぞれのマップに格納されているキーと値の組み合わせが一致する場合に trueを返す。

定義:
インタフェース java.util.Map<C,V> 内の equals
オーバーライド:
クラス java.lang.Object 内の equals
パラメータ:
o - 比較対象マップ。
戻り値:
等しい場合はtrue、等しくない場合や引数がマップでなかった 場合はfalseを返す。

hashCode

public int hashCode()
このマップのハッシュ・コードを取得する。

定義:
インタフェース java.util.Map<C,V> 内の hashCode
オーバーライド:
クラス java.lang.Object 内の hashCode
戻り値:
このマップのハッシュ・コード。

toString

public java.lang.String toString()
このマップを表す文字列を取得する。
この文字列は、このマップに格納されているキーと値の組を等号('=')で結合して 表現し、その集合をカンマ(',')区切りで連結して両端を括弧("{}")で囲んだ形で 表される。 キーと値は、String.valueOf(java.lang.Object)によって 文字列化される。

オーバーライド:
クラス java.lang.Object 内の toString
戻り値:
このマップを表す文字列。

getValue

protected abstract V getValue(java.lang.Object column)
このレコードの、指定されたカラムの値を取得する。

パラメータ:
column - カラム・キー。
戻り値:
カラムの値。
例外:
java.lang.ClassCastException - 引数のカラム・キーのクラスが、このマップに 不適当な場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルのキーを許可 していない場合。

putValue

protected abstract V putValue(C column,
                              V value)
指定されたカラム・キーと値の組を、このマップに設定する。

パラメータ:
column - カラム・キー。
value - カラム・キーに対応付けられる値。
戻り値:
引数のカラム・キーにそれまで対応付けられていた前回値。
例外:
java.lang.UnsupportedOperationException - このマップがこのメソッドの処理を サポートしていない場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルのキーや値を 許可していない場合。

removeValue

protected abstract V removeValue(java.lang.Object column)
指定されたカラム・キーに対する値をヌルに設定する。

パラメータ:
column - カラム・キー。
戻り値:
引数のカラム・キーにそれまで対応付けられていた前回値。
例外:
java.lang.ClassCastException - 引数のカラム・キーのクラスが、このマップに 不適当な場合。
java.lang.NullPointerException - 引数がヌルで、このマップがヌルのキーを許可 していない場合。

satisfyCondition

public boolean satisfyCondition(java.util.Map<C,V> condition)
このレコードが、指定された条件を満たすかどうかを判定する。
条件である引数のマップが保持する要素のキーと値の組み合わせが、 このレコードが保持する組み合わせと一致する場合にtrueを返す。
条件が保持するキーがこのレコードのカラム・キーにない場合や、同じキーに 対する値が条件とレコードで異なる場合はfalseを返す。
反対に、条件にないキーがこのレコードのカラム・キーに存在しても、判定結果 には影響を与えない。

パラメータ:
condition - 条件とするカラムとその値を格納したマップ・オブジェクト。
戻り値:
このレコードが、指定された条件を満たす場合はtrueを返す。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)。


Copyright (C) SATOH Takayuki All Rights Reserved.