database
b2007102101

org.phosphoresce.commons.database.accessor
クラス RecordListBufferedAccessor

java.lang.Object
  拡張org.phosphoresce.commons.database.accessor.RecordAccessorAbstract
      拡張org.phosphoresce.commons.database.accessor.RecordBufferedAccessor
          拡張org.phosphoresce.commons.database.accessor.RecordListBufferedAccessor
すべての実装インタフェース:
java.util.Collection, java.util.List, RecordAccessor

public class RecordListBufferedAccessor
extends RecordBufferedAccessor
implements java.util.List

レコードデータリストバッファアクセスオブジェクト

Listインタフェースを実現するレコードアクセス機能を提供します。
バッファリング動作仕様はRecordBufferedAccessorにすべて委譲します。

作成者:
Kitagawa
関連項目:
RecordAccessorAbstract, RecordBufferedAccessor

フィールドの概要
 
クラス org.phosphoresce.commons.database.accessor.RecordBufferedAccessor から継承したフィールド
fetchBuffer
 
クラス org.phosphoresce.commons.database.accessor.RecordAccessorAbstract から継承したフィールド
listener, log, resultSet, rowDefinition
 
コンストラクタの概要
RecordListBufferedAccessor(java.sql.ResultSet resultSet)
          コンストラクタ
 
メソッドの概要
 void add(int index, java.lang.Object element)
          リスト内の指定された位置に、指定された要素を挿入します。
 boolean add(java.lang.Object object)
          指定された要素をリストの最後に追加します。
 boolean addAll(java.util.Collection collection)
          指定されたコレクション内のすべての要素を、指定されたコレクションの 反復子によって返される順序でリストの最後に追加します。
 boolean addAll(int index, java.util.Collection collection)
          指定されたコレクション内のすべての要素を、リストの指定された位置に挿入します。
 void clear()
          すべての要素をリストから削除します。
 boolean contains(java.lang.Object object)
          リストに指定された要素が含まれているか判定します。
 boolean containsAll(java.util.Collection collection)
          指定されたコレクションのすべての要素がリストに含まれているか判定します。
 java.lang.Object get(int index)
          リスト内の指定された位置にある要素を取得します。
 int indexOf(java.lang.Object object)
          指定された要素がリスト内で最初に検出された位置のインデックスを提供します。
 boolean isEmpty()
          リストが空であるか判定します。
 java.util.Iterator iterator()
          リスト内の要素を適切な順序で繰り返し処理するイテレータオブジェクトを提供します。
 int lastIndexOf(java.lang.Object object)
          指定された要素がリスト内で最後に検出された位置のインデックスを提供します。
 java.util.ListIterator listIterator()
          リスト内の要素を適切な順序で繰り返し処理するイテレータオブジェクトを提供します。
 java.util.ListIterator listIterator(int index)
          リスト内の要素を適切な順序で繰り返し処理するイテレータオブジェクトを提供します。
 java.lang.Object remove(int index)
          リスト内の指定された位置にある要素を削除します。
 boolean remove(java.lang.Object object)
          リスト内で指定された要素が最初に検出されたとき、その要素を削除します。
 boolean removeAll(java.util.Collection collection)
          指定されたコレクションに格納されているすべての要素をリストから削除します。
 boolean retainAll(java.util.Collection collection)
          指定されたコレクションに格納されている要素だけがリスト内に含まれるようにします。
 java.lang.Object set(int index, java.lang.Object element)
          リスト内の指定された位置にある要素を、指定された要素に置き換えます。
 int size()
          レコードリストサイズを提供します。
 java.util.List subList(int fromIndex, int toIndex)
          指定された範囲のリストビューを提供します。
 java.lang.Object[] toArray()
          リストが保持する内容をObject配列として提供します。
 java.lang.Object[] toArray(java.lang.Object[] objects)
          リストが保持する内容をObject配列として提供します。
 
クラス org.phosphoresce.commons.database.accessor.RecordBufferedAccessor から継承したメソッド
clearStaticRecords, deleteRow, fetch, fetchAll, fetchRemainAll, finalize, getErrors, getResultColumn, getResultRow, hasError, insertRow, insertRow, refreshResult, setResultColumn, toString, updateResult
 
クラス org.phosphoresce.commons.database.accessor.RecordAccessorAbstract から継承したメソッド
createTemplateRow, getResultColumnCount, getResultColumnDefinition, getResultColumnDefinition, getResultRowCount, getResultRowDefinition, getResultSetRowIndex, isReadOnly, moveCurser, refreshResult, validateStateListener
 
クラス java.lang.Object から継承したメソッド
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
インタフェース java.util.List から継承したメソッド
equals, hashCode
 

コンストラクタの詳細

RecordListBufferedAccessor

public RecordListBufferedAccessor(java.sql.ResultSet resultSet)
                           throws ResultSetAccessException,
                                  IllegalResultSetLocationIndexException,
                                  IllegalResultSetAdjustmentException
コンストラクタ

パラメータ:
resultSet - ResultSetオブジェクト
例外:
ResultSetAccessException - 正常にResultSetへの操作が行えなかった場合に発生
IllegalResultSetLocationIndexException - 不正な位置情報を操作した場合に発生
IllegalResultSetAdjustmentException - 指定されたReusltSetオブジェクトのカーソル位置が先頭手前になっていない場合に発生
DatabaseConnectionException - データベースコネクションオブジェクトがレコードアクセス不可能なオブジェクトの場合に発生
メソッドの詳細

add

public boolean add(java.lang.Object object)
指定された要素をリストの最後に追加します。
当メソッドパラメータに指定できるオブジェクトはResultTemplateRowに限られます。
以外のオブジェクトが指定された場合は不正なパラメータとして例外(IllegalArgumentException)がスローされます。
また、行挿入処理において何らかの例外がスローされた場合はIllegalOperateRuntimeExceptionにラップされて例外がスローされます。
RuntimeExceptionではなく、明示的に例外を上位でキャッチしたい場合はRecordBufferedAccessor.insertRow(ResultTemplateRow)を 使用することを強く推奨します。

定義:
インタフェース java.util.List 内の add
パラメータ:
object - リストに追加される要素
戻り値:
常にtrueを返却(Collection.addメソッドの一般規約に従う)
関連項目:
List.add(java.lang.Object)

add

public void add(int index,
                java.lang.Object element)
リスト内の指定された位置に、指定された要素を挿入します。
指定されるエレメントオブジェクトはResultTemplateRowクラスである必要があります。
当メソッドを使用することでレコードの挿入処理は完了しますが、追加される位置は末尾に限定されます。
すなわち、List.add(int, Object)が提供するインデックスは無視されList.add(Object)と同様の動作となります。

定義:
インタフェース java.util.List 内の add
パラメータ:
index - 指定の要素が挿入されるインデックス
element - 挿入される要素
関連項目:
List.add(int, java.lang.Object), add(Object)

addAll

public boolean addAll(java.util.Collection collection)
指定されたコレクション内のすべての要素を、指定されたコレクションの 反復子によって返される順序でリストの最後に追加します。
尚、コレクションに含まれれる要素は全てResultTemplateRowである必要があります。

定義:
インタフェース java.util.List 内の addAll
パラメータ:
collection - 要素がリストに追加されるコレクション
戻り値:
この呼び出しの結果、このリストが変更された場合はtrueを返却
関連項目:
List.addAll(java.util.Collection)

addAll

public boolean addAll(int index,
                      java.util.Collection collection)
指定されたコレクション内のすべての要素を、リストの指定された位置に挿入します。
当メソッドを使用することでレコードの挿入処理は完了しますが、追加される位置は末尾に限定されます。
すなわち、List#addAll(int, Collection))が提供するインデックスは無視されList#addAll(Collection)と同様の動作となります。
尚、コレクションに含まれれる要素は全てResultTemplateRowである必要があります。

定義:
インタフェース java.util.List 内の addAll
パラメータ:
index - 指定されたコレクションから最初の要素を挿入する位置のインデックス
collection - リストに挿入される要素
戻り値:
この呼び出しの結果、このリストが変更された場合はtrueを返却
関連項目:
List.addAll(int, java.util.Collection)

clear

public void clear()
すべての要素をリストから削除します。

このフェッチバッファから削除処理が完了したタイミングでResultSetへの反映も同時に行われます。
削除指示のみを行うRecordBufferedAccessor.deleteRow(int)とは動作が異なります。
即ち、ResultSet内のレコード全てを対象に削除が行われることになります。

定義:
インタフェース java.util.List 内の clear
関連項目:
List.clear()

contains

public boolean contains(java.lang.Object object)
リストに指定された要素が含まれているか判定します。
指定されるエレメントオブジェクトはResultRowクラスである必要があります。

定義:
インタフェース java.util.List 内の contains
パラメータ:
object - 検索する要素
戻り値:
リストが、指定された要素を保持している場合にtrueを返却
関連項目:
List.contains(java.lang.Object)

containsAll

public boolean containsAll(java.util.Collection collection)
指定されたコレクションのすべての要素がリストに含まれているか判定します。

定義:
インタフェース java.util.List 内の containsAll
パラメータ:
collection - このリストにあるかどうかを調べるコレクション
戻り値:
指定されたコレクションのすべての要素がリストに含まれている場合にtrueを返却
関連項目:
List.containsAll(java.util.Collection)

get

public java.lang.Object get(int index)
リスト内の指定された位置にある要素を取得します。

定義:
インタフェース java.util.List 内の get
パラメータ:
index - インデックス
戻り値:
指定された位置にある要素
関連項目:
List.get(int)

indexOf

public int indexOf(java.lang.Object object)
指定された要素がリスト内で最初に検出された位置のインデックスを提供します。
指定されるエレメントオブジェクトはResultRowクラスである必要があります。

定義:
インタフェース java.util.List 内の indexOf
パラメータ:
object - 検索する要素
戻り値:
指定された要素がリスト内で最初に検出された位置のインデックス(存在しない場合は-1)
関連項目:
List.indexOf(java.lang.Object)

isEmpty

public boolean isEmpty()
リストが空であるか判定します。

定義:
インタフェース java.util.List 内の isEmpty
戻り値:
リストが空である場合にtrueを返却
関連項目:
List.isEmpty()

iterator

public java.util.Iterator iterator()
リスト内の要素を適切な順序で繰り返し処理するイテレータオブジェクトを提供します。

定義:
インタフェース java.util.List 内の iterator
戻り値:
イテレータオブジェクト
関連項目:
List.iterator()

lastIndexOf

public int lastIndexOf(java.lang.Object object)
指定された要素がリスト内で最後に検出された位置のインデックスを提供します。 指定されるエレメントオブジェクトはResultRowクラスである必要があります。

定義:
インタフェース java.util.List 内の lastIndexOf
パラメータ:
object - 検索する要素
戻り値:
指定された要素がリスト内で最後に検出された位置の要素のインデックス(存在しない場合は-1)
関連項目:
List.lastIndexOf(java.lang.Object)

listIterator

public java.util.ListIterator listIterator()
リスト内の要素を適切な順序で繰り返し処理するイテレータオブジェクトを提供します。

定義:
インタフェース java.util.List 内の listIterator
戻り値:
イテレータオブジェクト
関連項目:
List.listIterator()

listIterator

public java.util.ListIterator listIterator(int index)
リスト内の要素を適切な順序で繰り返し処理するイテレータオブジェクトを提供します。

定義:
インタフェース java.util.List 内の listIterator
パラメータ:
index - 最初の要素のインデックス
戻り値:
イテレータオブジェクト
関連項目:
List.listIterator(int)

remove

public java.lang.Object remove(int index)
リスト内の指定された位置にある要素を削除します。
行削除処理において何らかの例外がスローされた場合はIllegalOperateRuntimeExceptionにラップされて例外がスローされます。
RuntimeExceptionではなく、明示的に例外を上位でキャッチしたい場合はRecordBufferedAccessor.deleteRow(int)を 使用することを強く推奨します。

このフェッチバッファから削除処理が完了したタイミングでResultSetへの反映も同時に行われます。
削除指示のみを行うRecordBufferedAccessor.deleteRow(int)とは動作が異なります。

定義:
インタフェース java.util.List 内の remove
パラメータ:
index - 削除される要素のインデックス
戻り値:
指定された位置に以前あった要素
関連項目:
List.remove(int)

remove

public boolean remove(java.lang.Object object)
リスト内で指定された要素が最初に検出されたとき、その要素を削除します。
指定されるエレメントオブジェクトはResultRowクラスである必要があります。

このフェッチバッファから削除処理が完了したタイミングでResultSetへの反映も同時に行われます。
削除指示のみを行うRecordBufferedAccessor.deleteRow(int)とは動作が異なります。

定義:
インタフェース java.util.List 内の remove
パラメータ:
object - リストから削除される要素
戻り値:
リストが、指定された要素を保持している場合はtrueを返却
関連項目:
List.remove(java.lang.Object)

removeAll

public boolean removeAll(java.util.Collection collection)
指定されたコレクションに格納されているすべての要素をリストから削除します。
尚、コレクションに含まれれる要素は全てResultTemplateRowである必要があります。

このフェッチバッファから削除処理が完了したタイミングでResultSetへの反映も同時に行われます。
削除指示のみを行うRecordBufferedAccessor.deleteRow(int)とは動作が異なります。

定義:
インタフェース java.util.List 内の removeAll
パラメータ:
collection - どの要素がリストから削除されるかを定義するコレクション
戻り値:
この呼び出しの結果、このリストが変更された場合はtrueを返却
関連項目:
List.removeAll(java.util.Collection)

retainAll

public boolean retainAll(java.util.Collection collection)
指定されたコレクションに格納されている要素だけがリスト内に含まれるようにします。
つまり、指定されたコレクションに含まれていない要素をリストからすべて削除します。
尚、コレクションに含まれれる要素は全てResultTemplateRowである必要があります。

このフェッチバッファから削除処理が完了したタイミングでResultSetへの反映も同時に行われます。
削除指示のみを行うRecordBufferedAccessor.deleteRow(int)とは動作が異なります。

定義:
インタフェース java.util.List 内の retainAll
パラメータ:
collection - セットが保持する要素を定義するコレクション
戻り値:
この呼び出しの結果、このリストが変更された場合はtrueを返却
関連項目:
List.retainAll(java.util.Collection)

set

public java.lang.Object set(int index,
                            java.lang.Object element)
リスト内の指定された位置にある要素を、指定された要素に置き換えます。
当処理が提供する要素の置換処理は要素自体の置換処理とは異なることを注意して下さい。
指定された要素が保持する行情報の内容を指定されたインデックスに存在する行情報に対して複写を行うことを置換と表現します。
即ち、指定した要素の参照が指定したインデックスの位置の要素に設定されるわけではありません。
当メソッドパラメータに指定できるオブジェクトはResultTemplateRowまたはResultRowに限られます。

定義:
インタフェース java.util.List 内の set
パラメータ:
index - 置換される要素のインデックス
element - 指定された位置に格納される要素
戻り値:
指定された位置に以前あった要素、即ち変更が反映された要素そのもの
関連項目:
List.set(int, java.lang.Object)

size

public int size()
レコードリストサイズを提供します。
ここで提供するサイズはフェッチ済みのレコードリストであり、ResultSetが保持するサイズとは異なります。
また、レコードの追加が行われている場合は、そのサイズ分の増加が結果に反映されます。
しかし、削除指示が行われており、コミットが行われていないレコードに関しては結果から減算されることはありません。

定義:
インタフェース java.util.List 内の size
戻り値:
レコードリストサイズ
関連項目:
List.size()

subList

public java.util.List subList(int fromIndex,
                              int toIndex)
指定された範囲のリストビューを提供します。

定義:
インタフェース java.util.List 内の subList
パラメータ:
fromIndex - 範囲下端点(これを含む)
toIndex - 範囲上端点(これを含まない)
戻り値:
このリスト内の指定された範囲のビュー
関連項目:
List.subList(int, int)

toArray

public java.lang.Object[] toArray()
リストが保持する内容をObject配列として提供します。

定義:
インタフェース java.util.List 内の toArray
戻り値:
リストの要素が格納されている配列
関連項目:
List.toArray()

toArray

public java.lang.Object[] toArray(java.lang.Object[] objects)
リストが保持する内容をObject配列として提供します。

定義:
インタフェース java.util.List 内の toArray
パラメータ:
objects - リストの要素の格納先の配列
戻り値:
リストの要素が格納されている配列
関連項目:
List.toArray(java.lang.Object[])

database
b2007102101