8.4.13 executeUpdate(String sql)
- 〈この項の構成〉
(1) 機能
SQL文(検索系SQL以外のSQL文)を実行し,更新行数をint型で返却します。更新行数がInteger.MAX_VALUEを超える可能性がある場合は,executeUpdate(String sql)メソッドではなく,executeLargeUpdate(String sql)メソッドを使用してください。executeUpdate(String sql)メソッドを使用した場合に,Integer.MAX_VALUEを超えると0が返却されます。
(2) 形式
public synchronized int executeUpdate(String sql) throws SQLException
(3) 引数
- String sql:
-
実行するSQL文(検索系SQL以外のSQL文)を指定します。
(4) 戻り値
INSERT文,UPDATE文,およびDELETE文を実行した場合は,更新行数がint型で返却されます。これら以外のSQL文を実行した場合は,0が返却されます。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
Statementオブジェクトがクローズされている場合
-
Statementオブジェクトを生成したConnectionオブジェクトがクローズされている場合
-
検索系SQL(SELECT文)を実行した場合
-
sqlにnullまたは長さ0の文字列を指定した場合
-
データベースのアクセスエラーが発生した場合
-
指定されたSQL文の長さが,16,000,000文字を超えている場合