-
- 既知のすべての実装クラス:
TabularDataSupport
public interface TabularData
TabularData
インタフェースは、テーブル・データ構造を表現する特定の型の複合公開データ・オブジェクトの動作を指定します。- 導入されたバージョン:
- 1.5
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 Object[]
calculateIndex(CompositeData value)
このTabularData
インスタンスに、指定された複合データvalueパラメータを参照するために使用されるインデックスが追加されている場合、このインデックスを計算します。void
clear()
このTabularData
インスタンスからすべてのCompositeData
値(行)を削除します。boolean
containsKey(Object[] key)
このTabularData
インスタンスに、インデックスが指定されたkeyになっているCompositeData
値(行)が含まれる場合にかぎりtrue
を返します。boolean
containsValue(CompositeData value)
このTabularData
インスタンスに、指定されたCompositeData
値が含まれる場合にかぎりtrue
を返します。boolean
equals(Object obj)
指定されたobjパラメータとこのTabularData
インスタンスが等しいかどうかを比較します。CompositeData
get(Object[] key)
このTabularData
インスタンス内で、keyをインデックスに持つCompositeData
値(keyに値がマッピングされていない場合はnull
)を返します。TabularType
getTabularType()
このTabularData
インスタンスを記述する表型を返します。int
hashCode()
このTabularData
インスタンスのハッシュ・コード値を返します。boolean
isEmpty()
このTabularData
インスタンスに含まれるCompositeData
値の数(行数)がゼロの場合、true
を返します。Set<?>
keySet()
このTabularData
インスタンスに含まれるCompositeData
値(行)のキー(インデックス値)のセット・ビューを返します。void
put(CompositeData value)
このTabularData
インスタンスにvalueを追加します。void
putAll(CompositeData[] values)
values内のすべての要素をこのTabularData
インスタンスに追加します。CompositeData
remove(Object[] key)
keyをインデックスに持つCompositeData
値をこのTabularData
インスタンスから削除し、その削除した値を返します。keyをインデックスに持つ値が存在しない場合はnull
を返します。int
size()
このTabularData
インスタンスに含まれるCompositeData
値の数(行数)を返します。String
toString()
このTabularData
インスタンスの文字列表現を返します。Collection<?>
values()
このTabularData
インスタンスに含まれるCompositeData
値(行)のコレクション・ビューを返します。
-
-
-
メソッドの詳細
-
getTabularType
TabularType getTabularType()
このTabularData
インスタンスを記述する表型を返します。- 戻り値:
- 表型。
-
calculateIndex
Object[] calculateIndex(CompositeData value)
このTabularData
インスタンスに、指定された複合データvalueパラメータを参照するために使用されるインデックスが追加されている場合、このインデックスを計算します。 このメソッドは、指定されたvalueの型の妥当性を検査します。ただし、計算されたインデックスが、このTabularData
インスタンス内の値を参照するためにすでに使用されているかどうかは検査しません。- パラメータ:
value
- 複合データ値。このTabularData
インスタンス内のこのデータ値のインデックスを計算する。このインスタンスの行の型と同じ複合型で、null以外。- 戻り値:
- 指定されたvalueがこの
TabularData
インスタンス内に持つインデックス。 - 例外:
NullPointerException
- valueがnull
の場合InvalidOpenTypeException
- valueがこのTabularData
インスタンスの行の型定義に準拠していない場合。
-
size
int size()
このTabularData
インスタンスに含まれるCompositeData
値の数(行数)を返します。- 戻り値:
- 含まれる値の数。
-
isEmpty
boolean isEmpty()
このTabularData
インスタンスに含まれるCompositeData
値の数(行数)がゼロの場合、true
を返します。- 戻り値:
- この
TabularData
が空の場合はtrue。
-
containsKey
boolean containsKey(Object[] key)
このTabularData
インスタンスに、インデックスが指定されたkeyになっているCompositeData
値(行)が含まれる場合にかぎりtrue
を返します。 keyがnull
の場合、またはこのTabularData
インスタンスのTabularType
定義に準拠していない場合、このメソッドはfalse
を返します。- パラメータ:
key
- このTabularData
内にあるかどうかテストされるインデックス値。- 戻り値:
- この
TabularData
が指定されたキーを持つ行の値を示す場合はtrue
。
-
containsValue
boolean containsValue(CompositeData value)
このTabularData
インスタンスに、指定されたCompositeData
値が含まれる場合にかぎりtrue
を返します。 valueがnull
の場合、またはこのTabularData
インスタンスの行の型定義に準拠していない場合、このメソッドはfalse
を返します。- パラメータ:
value
- このTabularData
内にあるかどうかテストされる行の値。- 戻り値:
- この
TabularData
インスタンスに指定された行の値が含まれる場合はtrue
。
-
get
CompositeData get(Object[] key)
このTabularData
インスタンス内で、keyをインデックスに持つCompositeData
値(keyに値がマッピングされていない場合はnull
)を返します。- パラメータ:
key
- 返される行のキー。- 戻り値:
- keyに対応する値。
- 例外:
NullPointerException
- keyがnull
の場合InvalidKeyException
- keyがこのTabularData
インスタンスのTabularType
定義に適合しない場合
-
put
void put(CompositeData value)
このTabularData
インスタンスにvalueを追加します。 valueの複合型は、このインスタンスの行の型(this.getTabularType().
によって返される複合型)と同じである必要があります。また、このgetRowType()
TabularData
インスタンス内に、追加されるvalue用に計算されたものと同じインデックスを持つ既存の値が存在していてはいけません。 valueのインデックスは、このTabularData
インスタンスのTabularType
定義に従って計算されます(TabularType.
を参照)。getIndexNames()
- パラメータ:
value
- このTabularData
インスタンスに新しい行として追加される複合データ値。このインスタンスの行の型と同じ複合型で、null以外でなければならない。- 例外:
NullPointerException
- valueがnull
の場合InvalidOpenTypeException
- valueがこのTabularData
インスタンスの行の型定義に準拠していない場合。KeyAlreadyExistsException
- このTabularData
インスタンスのTabularType
定義に準拠するように計算されたvalueのインデックスが、配下のHashMap内の既存の値とすでに一致している場合。
-
remove
CompositeData remove(Object[] key)
keyをインデックスに持つCompositeData
値をこのTabularData
インスタンスから削除し、その削除した値を返します。keyをインデックスに持つ値が存在しない場合はnull
を返します。- パラメータ:
key
- このTabularData
インスタンス内に取得する値のインデックス。このTabularData
インスタンスの行の型定義に対して有効かつnull以外でなければならない。- 戻り値:
- 指定されたキーと関連付けられていた以前の値。キーのマッピングがなかった場合は
null
。 - 例外:
NullPointerException
- keyがnull
の場合InvalidKeyException
- keyがこのTabularData
インスタンスのTabularType
定義に適合しない場合
-
putAll
void putAll(CompositeData[] values)
values内のすべての要素をこのTabularData
インスタンスに追加します。 valuesの要素がput
で定義された制約を満たさない場合、またはvaluesの2つの要素がこのTabularData
インスタンスTabularType
の定義に従って計算された同じインデックスを持つ場合は、その障害を記述する例外がスローされ、valuesの要素が追加されず、このTabularData
インスタンスは変更されません。- パラメータ:
values
- 複合データ値の配列。この値が、新しい行としてこのTabularData
インスタンスに追加される。valuesがnull
または空文字列の場合、このメソッドは何もせずに終了する。- 例外:
NullPointerException
- valueの要素がnull
の場合InvalidOpenTypeException
- valueの要素がこのTabularData
インスタンスの行の型定義に準拠していない場合。KeyAlreadyExistsException
- このTabularData
インスタンスのTabularType
定義に準拠するように計算されたvaluesの要素のインデックスが、このインスタンス内の既存の値にすでに一致している場合、またはvalues内に同じインデックスを持つ要素が2つ存在する場合
-
clear
void clear()
このTabularData
インスタンスからすべてのCompositeData
値(行)を削除します。
-
keySet
Set<?> keySet()
このTabularData
インスタンスに含まれるCompositeData
値(行)のキー(インデックス値)のセット・ビューを返します。 返されるSet
はSet<List<?>>
ですが、互換性を維持するためにSet<?>
として宣言されます。 返されるセットを使って、キーの繰返し処理を行うことができます。- 戻り値:
- この
TabularData
インスタンスで使用されるインデックス値のセット・ビュー(Set<List<?>>
)。
-
values
Collection<?> values()
このTabularData
インスタンスに含まれるCompositeData
値(行)のコレクション・ビューを返します。 返されるCollection
はCollection<CompositeData>
ですが、互換性を維持するためにCollection<?>
として宣言されます。 返されるコレクションを使って、値の繰返し処理を行うことができます。- 戻り値:
- この
TabularData
インスタンスに格納されている行のコレクション・ビュー(Collection<CompositeData>
)。
-
equals
boolean equals(Object obj)
指定されたobjパラメータとこのTabularData
インスタンスが等しいかどうかを比較します。次のすべての条件が満たされている場合に限り、
true
を返します。- objがnullでない
- objが
TabularData
インタフェースも実装している - 行型が等しい
- 内容(インデックスと値のマッピング)が等しい
equals
メソッドは、TabularData
インタフェースの異なった実装であるobjパラメータに対して正常に機能します。
- オーバーライド:
equals
、クラスObject
- パラメータ:
obj
- このTabularData
インスタンスと等しいかどうかを比較するオブジェクト。- 戻り値:
- 指定されたオブジェクトがこの
TabularData
インスタンスと等しい場合はtrue
。 - 関連項目:
Object.hashCode()
、HashMap
-
hashCode
int hashCode()
このTabularData
インスタンスのハッシュ・コード値を返します。TabularData
インスタンスのハッシュ・コードは、equals
の比較で使用されるすべての情報要素(表型と、すべての値マッピングのインデックスとして定義された内容)のハッシュ・コードの合計です。これにより、
Object.hashCode()
メソッドの一般規約によって要求される、任意の2つのTabularDataSupport
インスタンスt1
とt2
で、t1.equals(t2)
であればt1.hashCode()==t2.hashCode()
となることが保証されます。- オーバーライド:
hashCode
、クラスObject
- 戻り値:
- この
TabularDataSupport
インスタンスのハッシュ・コード値 - 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-