statementConfig
statementConfigとは?
JDBCパラメータを設定するクラスです。
設定ポイント
DBFluteConfig にて、全ての検索に適用するデフォルトの挙動を設定することができます。 明示的に設定された項目のみデフォルトとして適用されます。
また、ConditionBean や外だしsQLなどで、デフォルトの挙動を上書きすることができます。 同じく、明示的に設定された項目のみ上書きをします。
主なメソッド
それぞれの項目のJDBCとしての仕様は、JDBCのドキュメントを参考にして下さい。 また、具体的な挙動は、DBMs (JDBCドライバ)に依存しますのでご注意下さい。
Resultsetタイプ
どれか一つを設定します。何も設定しない場合は、デフォルトの挙動(DBFlute内部で必要に応じて自動調整)となります。
- typeForwardOnly()
- Resultset に TYPE_FORWARD_ONLY を設定します。DBFluteにおけるほとんどの検索におけるデフォルトです。
- typescrollInsensitive()
- Resultset に TYPE_sCROLL_INsENsITIVE を設定します。カーソルのポインタシフトが利用できるようになります。 DBFluteでは、ポインタシフトが必要になる場面(外だしsQLの AutoPaging など)で内部的に自動で利用されます。DBMs によっては、フェッチし終わったレコードもメモリ上に保持する可能性がありますので、大量データを扱うカーソル検索などでこれを利用するとカーソル検索の意味が無くなります。
- typescrollsensitive()
- Resultset に TYPE_sCROLL_sENsITIVE を設定します。TYPE_sCROLL_INsENsITIVE と比べて、Resultset にデータベース上の最新の状態が自動的に反映される、という特徴を持ちます。DBFlute では、内部的な調整でこのタイプを利用することはありません。
statementパラメータ
それぞれ独立した項目として設定します。何も設定しない場合は、デフォルトの挙動(statementに対して、何も設定しないのと同じ)となります。
- queryTimeout(int)
- Preparedstatement.setQueryTimeout() (sQLの実行時間の制限)を設定します。指定されたミリ秒を超えるとsQLは中断し例外になります。statementConfig の中で最も活躍すると想定されるメソッドです。
- fetchsize(int)
- Preparedstatement.setFetchsize() (JDBC内部での一度の通信で取得するレコード数)を設定します。
- maxRows(int)
- Preparedstatement.setMaxRows() (フェッチする最大レコード数)を設定します。
クラス仕様
- serializableである
- スレッドセーフではない (読み取りのみであればスレッドセーフ)
- 同じスレッド内での(別項目への)再利用はできる