9.7 ResultSetクラス

説明
ResultSetクラスでは,主に次の機能を提供します。
  • 行単位のResultSet内の移動
  • 結果データの返却
  • 検索結果データがNULL値かどうかの通知
ResultSetクラスの提供する各メソッドの詳細および使用方法については,JavaSoft提供のJDBC関連ドキュメントを参照してください。
注意事項
制限事項
Cosminexus DABroker Libraryで使用するResultSetクラスの制限事項を,次に示します。

表9-11 ResultSetクラスの制限事項

メソッド名制限事項JDBC1.0での制限JDBC2.0での制限
closeステートメントのクローズ時,または次のSQL実行時に暗黙的にクローズします。プーリング使用時(ConnectionPoolDataSourceを使用した接続),およびXA使用時(XADataSourceを使用した接続)でResultSet.closeメソッド実行中にデータベースとの物理的な切断でエラーが発生しコネクションプーリングが使用できなくなった場合ConnectionEventListener.connectionErrorOccurredは発生しません。
cancelRowUpdates更新可能型ResultSetをサポートしていないため,無条件にSQLExceptionをスローします。
deleteRow
findColumn指定された列名がResultSetオブジェクトに含まれていないため列インデックスが取得できない場合,SQLExceptionをスローします。
absoluteabsolute(-2)と指定した場合,カーソルは最終行の前の行へ移動します。
afterLast結果セットに行がない場合,何も処理しません。
beforeFirst
cancelRowUpdates更新可能型ResultSetをサポートしていないため,無条件にSQLExceptionをスローします。
deleteRow
getArraySQL配列型をサポートしていないため,無条件にSQLExceptionをスローします。
getBlob接続データベースがHiRDB,Oracle9i,またはOracle10g以外の場合,SQL LONGVARBINARY型およびSQL BLOB型をサポートしていないため,無条件にSQLExceptionをスローします。
getClob接続データベースがOracle9i,またはOracle10g以外の場合,SQL CLOB型をサポートしていないため,無条件にSQLExceptionをスローします。
getFetchSize0,またはsetFetchSizeメソッドで指定された値がsetMaxRowsメソッドで指定された値より小さい場合はsetFetchSizeメソッドで指定された値を,setFetchSizeメソッドで指定された値がsetMaxRowsメソッドで指定された値より大きい場合はsetMaxRowsメソッドで指定された値を返却します。
getRefSQL構造化型をサポートしていないため,無条件にSQLExceptionをスローします。
isFirst結果セットに行がない場合falseを返却します。
isLast結果セットに行がない場合falseを返却します。
insertRow更新可能型ResultSetをサポートしていないため,無条件にSQLExceptionをスローします。
moveToCurrentRow
moveToInsertRow
previousカーソルの移動方向がnextメソッドと逆方向になります。
refreshRow更新可能型ResultSetをサポートしていないため,無条件にSQLExceptionをスローします。
relative結果セットに行がない場合SQLExceptionをthrowします。カーソルが先頭行の前,または最終行の後ろにある場合は有効として処理します。処理結果が結果セットの先頭行,最終行を超える場合はそれぞれ先頭行の前,最終行の後ろへ移動します。
rowDeleted更新可能型ResultSetをサポートしていないため,無条件にSQLExceptionをスローします。
rowInserted
rowUpdated
setFetchDirectionFETCH_FORWARD以外を指定した場合,SQLExceptionをスローします。
setFetchSize接続データベース種別がHiRDB,またはORACLEの場合で,CLOBやBLOBなどのLONG VARCHAR・LONG VARBINARY型データ列の検索を含まないときだけ有効となります。
updateAsciiStream更新可能型ResultSetをサポートしていないため,無条件にSQLExceptionをスローします。
updateBigDecimal
updateBinaryStream
updateBoolean
updateByte
updateBytes
updateCharacterStream
updateDate
updateDouble
updateFloat
updateInt
updateLong
updateNull
updateObject
updateRow
updateShort
updateString
updateTime
updateTimestamp
(凡例)
○:該当します。
-:該当しません。