スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド
PreparedStatementインタフェースでは,主に次の機能が提供されます。
また,PreparedStatementインタフェースはStatementインタフェースのサブインタフェースであるため,Statementインタフェースの機能をすべて継承します。
PreparedStatementインタフェースのメソッド一覧を次の表に示します。なお,表に記載されていないメソッドはサポートしていません。サポートしていないメソッドを指定すると,SQLExceptionを投入します。
表18-24 PreparedStatementインタフェースのメソッド一覧
記載箇所 | メソッド | 機能 |
---|---|---|
(a) | addBatch() | このPreparedStatementオブジェクトのバッチに,現在のパラメタセットを追加します。 |
(b) | clearParameters() | 現在設定されているパラメタセットの値をすべてクリアします。 |
(c) | execute() | 前処理済みのSQLを実行します。 |
(d) | execute(String sql) | 指定されたSQL文を実行します。 |
(e) | executeQuery() | 前処理済みの検索系SQLを実行し,その結果のResultSetオブジェクトを返します。 |
(f) | executeQuery(String sql) | 指定された検索系SQLを実行し,その結果のResultSetオブジェクトを返します。 |
(g) | executeUpdate() | 前処理済みの検索系以外のSQLを実行し,更新行数を返します。 |
(h) | executeUpdate(String sql) | 指定された検索系以外のSQLを実行し,更新行数を返します。 |
(i) | setArray(int i, Array x) | Arrayオブジェクトを指定されたパラメタに設定します。 |
(j) | setAsciiStream(int parameterIndex, java.io.InputStream x, int length) | 指定されたInputStreamオブジェクトの持つ値を?パラメタ値に設定します。 |
(k) | setBigDecimal(int parameterIndex,BigDecimal x) | 指定されたBigDecimalオブジェクトを?パラメタ値に設定します。 |
(l) | setBinaryStream(int parameterIndex, InputStream x,int length) | 指定されたInputStreamオブジェクトの持つ値を?パラメタ値に設定します。 |
(m) | setBlob(int parameterIndex, Blob x) | 指定されたBlobオブジェクトの持つ値を?パラメタ値に設定します。 |
(n) | setBoolean(int parameterIndex,boolean x) | 指定されたboolean値を?パラメタ値に設定します。 |
(o) | setByte(int parameterIndex,byte x) | 指定されたbyte値を?パラメタ値に設定します。 |
(p) | setBytes(int parameterIndex,byte x[]) | 指定されたbyte配列を?パラメタ値に設定します。 |
(q) | setCharacterStream(int parameterIndex,Reader reader,int length) | 指定されたReaderオブジェクトの持つ値を?パラメタ値に設定します。 |
(r) | setDate(int parameterIndex,Date x) | 指定されたjava.sql.Dateオブジェクトを?パラメタ値に設定します。 |
(s) | setDate(int parameterIndex,Date x,Calendar cal) | ローカルタイムで指定されたjava.sql.Dateオブジェクトを,指定されたカレンダーのタイムゾーンの時間に変換し,?パラメタ値に設定します。 |
(t) | setDouble(int parameterIndex,double x) | 指定されたdouble値を?パラメタ値に設定します。 |
(u) | setFloat(int parameterIndex,float x) | 指定されたfloat値を?パラメタ値に設定します。 |
(v) | setInt(int parameterIndex,int x) | 指定されたint値を?パラメタ値に設定します。 |
(w) | setLong(int parameterIndex,long x) | 指定されたlong値を?パラメタ値に設定します。 |
(x) | setNull(int parameterIndex,int sqlType) | 指定された?パラメタにNULL値を設定します。 |
(y) | setObject(int parameterIndex,Object x) | 指定されたオブジェクトの持つ値を?パラメタ値に設定します。 |
(z) | setObject(int parameterIndex,Object x,int targetSqlType) | 指定されたオブジェクトの持つ値を?パラメタ値に設定します。 |
(aa) | setObject(int parameterIndex,Object x,int targetSqlType,int scale) | 指定されたオブジェクトの持つ値を?パラメタ値に設定します。 |
(ab) | setShort(int parameterIndex,short x) | 指定されたshort値を?パラメタ値に設定します。 |
(ac) | setString(int parameterIndex,String x) | 指定されたStringオブジェクトを?パラメタ値に設定します。 |
(ad) | setTime(int parameterIndex,Time x) | 指定されたjava.sql.Timeオブジェクトを?パラメタ値に設定します。 |
(ae) | setTime(int parameterIndex,Time x,Calendar cal) | ローカルタイムで指定されたjava.sql.Timeオブジェクトを,指定されたカレンダーのタイムゾーンの時間に変換し,?パラメタ値に設定します。 |
(af) | setTimestamp(int parameterIndex, Timestamp x) | 指定されたjava.sql.Timestampオブジェクトを?パラメタ値に設定します。 |
(ag) | setTimestamp(int parameterIndex, Timestamp x,Calendar cal) | ローカルタイムで指定されたjava.sql.Timestampオブジェクトを,指定されたカレンダーのタイムゾーンの時間に変換し,?パラメタ値に設定します。 |
public synchronized void addBatch() throws SQLException
public synchronized void clearParameters() throws SQLException
public synchronized boolean execute() throws SQLException
public synchronized boolean execute(String sql) throws SQLException
public synchronized ResultSet executeQuery() throws SQLException
public synchronized ResultSet executeQuery(String sql) throws SQLException
public synchronized int executeUpdate() throws SQLException
実行したSQLの種類 | システムプロパティHiRDB_for_Java_DAB_EXECUTESQL_NOCHK指定 | ||
---|---|---|---|
TRUE以外 | TRUE | ||
検索系SQL | − | -1 | |
検索系以外のSQL | INSERT,UPDATE,DELETE | 更新行数 | 更新行数 |
その他 | 0 | 0 |
public synchronized int executeUpdate(String sql) throws SQLException
実行したSQLの種類 | システムプロパティHiRDB_for_Java_DAB_EXECUTESQL_NOCHK指定 | ||
---|---|---|---|
TRUE以外 | TRUE | ||
検索系SQL | − | -1 | |
検索系以外のSQL | INSERT,UPDATE,DELETE | 更新行数 | 更新行数 |
その他 | 0 | 0 |
public void setArray(int i,Array x) throws SQLException
getBaseType()で取得したデータ型 | getArray()で取得したObject配列のデータ型 |
---|---|
java.sql.Types.SMALLINT | short[],java.lang.Short[] |
java.sql.Types.INTEGER | int[],java.lang.Integer[] |
java.sql.Types.REAL | float[],java.lang.Float[] |
java.sql.Types.FLOAT | double[],java.lang.Double[] |
java.sql.Types.Decimal | java.math.BigDecimal[] |
java.sql.Types.CHAR | java.lang.String[] |
java.sql.Types.VARCHAR | java.lang.String[] |
java.sql.Types.DATE | java.sql.Date |
java.sql.Types.TIME | java.sql.Time |
java.sql.Types.TIMESTAMP | java.sql.Timestamp |
引数i | 引数x | getArrayで取り出したObject配列の要素数 | Object配列の各要素 | HiRDBに設定される繰返し列の要素 |
---|---|---|---|---|
存在する?パラメタ番号 | !=null | 0<要素数<=30000 | すべての要素がnull | すべての要素がnullである繰返し列 |
上記以外 | 上記以外の繰返し列 | |||
要素数>30000 | − | SQLException | ||
0 | − | 要素数0の繰返し列 | ||
null | − | − | 列全体がnull | |
存在するが,繰返し列ではない?パラメタ番号 | − | − | − | SQLException |
存在しない?パラメタ番号 | SQLException |
(凡例) −:該当しません。
public synchronized void setAsciiStream(int parameterIndex, java.io.InputStream x, int length) throws SQLException
public synchronized void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
public synchronized void setBinaryStream(int parameterIndex, java.io.InputStream x, int length) throws SQLException
public synchronized void setBlob(int parameterIndex, Blob x) throws SQLException
public synchronized void setBoolean(int parameterIndex, boolean x) throws SQLException
public synchronized void setByte(int parameterIndex, byte x) throws SQLException
public synchronized void setBytes(int parameterIndex, byte x[]) throws SQLException
public synchronized void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException
public synchronized void setDate(int parameterIndex, java.sql.Date x) throws SQLException
public synchronized void setDate(int parameterIndex, java.sql.Date x,Calendar cal) throws SQLException
public synchronized void setDouble(int parameterIndex, double x) throws SQLException
public synchronized void setFloat(int parameterIndex, float x) throws SQLException
public synchronized void setInt(int parameterIndex, int x) throws SQLException
public synchronized void setLong(int parameterIndex, long x) throws SQLException
public synchronized void setNull(int parameterIndex,int sqlType) throws SQLException
public synchronized void setObject(int parameterIndex, Object x) throws SQLException
public synchronized void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
public synchronized void setObject(int parameterIndex, Object x, int targetSqlType, int scale) throws SQLException
public synchronized void setShort(int parameterIndex, short x) throws SQLException
public synchronized void setString(int parameterIndex, String x) throws SQLException
?パラメタのデータ型 | ?パラメタの設定値 |
---|---|
[M|N][VAR]CHAR |
|
BINARY,又はBLOB | 0長文字列 |
その他 | null |
public synchronized void setTime(int parameterIndex, java.sql.Time x) throws SQLException
public synchronized void setTime(int parameterIndex, java.sql.Time x,Calendar cal) throws SQLException
public synchronized void setTimestamp(int parameterIndex, java.sql.Timestamp x) throws SQLException
public synchronized void setTimestamp(int parameterIndex, java.sql.Timestamp x,Calendar cal) throws SQLException
このインタフェースを実装するパッケージ名称とクラス名称を次に示します。
PreparedStatementインタフェースはStatementインタフェースのサブインタフェースであるため,Statementインタフェースの注意事項はすべて該当します。
ここでは,それ以外のPreparedStatementインタフェースの注意事項を次に示します。
コミット,ロールバックをわたるSQLの前処理結果保持については,「18.2.2(1)(c) HIRDB_CURSOR及びSTATEMENT_COMMIT_BEHAVIOR指定時の注意事項」を参照してください。
HiRDBのDECIMAL型の?パラメタに対してsetXXXメソッドで値を指定する場合,?パラメタの精度及び位取りと値の精度及び位取りが一致していないときの動作を次に示します。
HiRDBのTIMESTAMP型の?パラメタに対してsetXXXメソッドで値を指定する場合,?パラメタの小数秒精度よりも値の小数秒精度が大きいときは,?パラメタの小数秒精度に合わせて,小数秒精度を切り捨てます。
HiRDBのCHAR,VARCHAR,NCHAR,NVARCHAR,MCHAR,又はMVARCHAR型の?パラメタに対してsetXXXメソッドで値を指定する場合,?パラメタの定義長よりも値を文字列表現にしたときの長さが大きいと,SQLExceptionを投入します。
setObjectの引数xに指定できるオブジェクトは,次に示す型のオブジェクトです。
All Rights Reserved. Copyright (C) 2006, 2016, Hitachi, Ltd.