nga.sql
インタフェース Updater

public interface Updater

Update / Insert / Delete 用 SQL オブジェクト。

関連項目:

SQL.createUpdater(Connection, String)

メソッドの概要

Updater	add(String s) 現在の SQL 文の末尾に文字列を追加する。
Updater	and(String s) 現在の SQL 文の末尾に「"AND " + 指定した文字列」を追加する。
int	execute() 指定した SQL 文を実行する。
int[]	execute(List parameterObjectList) 指定した SQL 文を一括実行する。
int[]	execute(List parameterObjectList, int batchSize) 指定した SQL 文を一括実行する。
int	execute(Object parameterObject) 指定した SQL 文を実行する。
boolean	isDebugMode() 現在デバッグモードかどうかを調べる。
Updater	or(String s) 現在の SQL 文の末尾に「"OR " + 指定した文字列」を追加する。
void	setDebugMode(boolean mode) デバッグ状態を設定する。

メソッドの詳細

isDebugMode

boolean isDebugMode()

現在デバッグモードかどうかを調べる。

戻り値:

デバッグモードならば true。デバッグモードでなければ false。

setDebugMode

void setDebugMode(boolean mode)

デバッグ状態を設定する。

パラメータ:

mode - デバッグモードの場合は true を指定する。

add

Updater add(String s)

現在の SQL 文の末尾に文字列を追加する。

パラメータ:

s - SQL 文の末尾に追加する文字列。

戻り値:

現在の SQL オブジェクト。

and

Updater and(String s)

現在の SQL 文の末尾に「"AND " + 指定した文字列」を追加する。
なお，現在の SQL 文中にまだ "WHERE" 文字列が存在しない場合は，「"WHERE " + 指定した文字列」を追加する。 また，現在の SQL 文の末尾の文字が '(' だった場合は，"AND" は追加せず，指定された文字列のみを追加する。

パラメータ:

s - SQL 文の末尾に追加する文字列。

戻り値:

現在の SQL オブジェクト。

or

Updater or(String s)

現在の SQL 文の末尾に「"OR " + 指定した文字列」を追加する。
なお，現在の SQL 文中にまだ "WHERE" 文字列が存在しない場合は，「"WHERE " + 指定した文字列」を追加する。 また，現在の SQL 文の末尾の文字が '(' だった場合は，"OR" は追加せず，指定された文字列のみを追加する。

パラメータ:

s - SQL 文の末尾に追加する文字列。

戻り値:

現在の SQL オブジェクト。

execute

int execute()
            throws DuplicatedException,
                   SQLException

指定した SQL 文を実行する。

戻り値:

SQL実行結果件数。

例外:

DuplicatedException - 重複エラーが発生した場合。

SQLException

execute

int execute(Object parameterObject)
            throws DuplicatedException,
                   SQLException

指定した SQL 文を実行する。

パラメータ:

parameterObject - SQLに埋め込む値を格納しているパラメタオブジェクト。

戻り値:

SQL実行結果件数。

例外:

DuplicatedException - 重複エラーが発生した場合。

SQLException

execute

int[] execute(List parameterObjectList)
              throws DuplicatedException,
                     SQLException

指定した SQL 文を一括実行する。
指定されたパラメタオブジェクトの件数分 PreparedStatement.executeUpdate() を実行する。

パラメータ:

parameterObjectList - SQLに埋め込む値を格納しているパラメタオブジェクトのリスト。

戻り値:

SQL実行結果件数。

例外:

DuplicatedException - 重複エラーが発生した場合。

SQLException

execute

int[] execute(List parameterObjectList,
              int batchSize)
              throws DuplicatedException,
                     SQLException

指定した SQL 文を一括実行する。
PreparedStatement.addBatch() を実行し，batchSize 引数で指定した件数に達したら PreparedStatement.executeBatch() の実行を行う。

パラメータ:

parameterObjectList - SQLに埋め込む値を格納しているパラメタオブジェクトのリスト。

batchSize - 一括実行件数。

戻り値:

SQL実行結果件数。

例外:

DuplicatedException

SQLException