public class PreparedStatement extends Statement implements java.sql.PreparedStatement
| 修飾子とタイプ | メソッドと説明 |
|---|---|
void |
addBatch()
この
PreparedStatement オブジェクトのコマンドのバッチに、
パラメータのセットを追加します。 |
void |
clearBatch()
この
PreparedStatement オブジェクトの現在の
パラメータリストを空にします。 |
void |
clearParameters()
現在のパラメータ値をすぐにクリアします。
|
void |
close()
自動的にクローズされるときに
java.sql.Statement
オブジェクトのデータベースと JDBC リソースが解放されるのを
待つのではなく、ただちにそれらを解放します。 |
boolean |
execute()
この
PreparedStatement オブジェクトの、
あらゆる種類の SQL 文を実行します。 |
int[] |
executeBatch()
設定されているバッチ更新用のパラメータをデータベースに送信して
バッチ更新を実行し、すべてのパラメータが正常に実行されると、
更新カウントの配列を返します。
|
java.sql.ResultSet |
executeQuery()
この
PreparedStatement オブジェクトの
SQL クエリーを実行し、そのクエリーによって生成された
java.sql.ResultSet オブジェクトを返します。 |
java.sql.ResultSet |
executeQuery(java.lang.String sql_)
[サポート外]
単一の
java.sql.ResultSetオブジェクトを返す、
指定された SQL文を実行します。 |
int |
executeUpdate()
この
PreparedStatement オブジェクトの
SQL INSERT 文、 UPDATE 文、
または DELETE 文を実行します。 |
int |
executeUpdate(java.lang.String sql_)
[サポート外]
指定された SQL 文を実行します。
|
protected void |
finalize()
このオブジェクトへの参照がないと、ガベージコレクションによって
判断された時に、ガベージコレクタによって呼び出されます。
|
java.sql.ResultSetMetaData |
getMetaData()
[サポート外]
この
PreparedStatement が実行されるときに返される
java.sql.ResultSet オブジェクトの列に関する情報を格納する
java.sql.ResultSetMetaData オブジェクトを取得します。 |
java.sql.ParameterMetaData |
getParameterMetaData()
[サポート外]
この
PreparedStatement オブジェクトの
パラメータの数、型、およびプロパティを取得します。 |
boolean |
isClosed()
この
PreparedStatement オブジェクトがクローズ
されているかどうかを取得します。 |
boolean |
isPoolable()
常に
false を返す |
boolean |
isWrapperFor(java.lang.Class<?> iface)
[サポート外]
常に
falseを返します |
void |
setArray(int parameterIndex_,
java.sql.Array x_)
指定されたパラメータを指定された
java.sql.Array
オブジェクトに設定します。 |
void |
setAsciiStream(int parameterIndex,
java.io.InputStream x)
[サポート外]
|
void |
setAsciiStream(int parameterIndex_,
java.io.InputStream x_,
int length_)
指定されたパラメータを、指定されたバイト数を持つ指定された
入力ストリームに設定します。
|
void |
setAsciiStream(int parameterIndex,
java.io.InputStream x,
long length)
[サポート外]
|
void |
setBigDecimal(int parameterIndex_,
java.math.BigDecimal x_)
指定されたパラメータを指定された
java.math.BigDecimal 値に
設定します。 |
void |
setBinaryStream(int parameterIndex,
java.io.InputStream x)
[サポート外]
|
void |
setBinaryStream(int parameterIndex_,
java.io.InputStream x_,
int length_)
指定されたパラメータを、指定されたバイト数を持つ指定された
入力ストリームに設定します。
|
void |
setBinaryStream(int parameterIndex,
java.io.InputStream x,
long length)
[サポート外]
|
void |
setBlob(int parameterIndex_,
java.sql.Blob x_)
[サポート外]
指定されたパラメータを指定された
java.sql.Blob
オブジェクトに設定します。 |
void |
setBlob(int parameterIndex,
java.io.InputStream inputStream)
[サポート外]
|
void |
setBlob(int parameterIndex,
java.io.InputStream inputStream,
long length)
[サポート外]
|
void |
setBoolean(int parameterIndex_,
boolean x_)
[サポート外]
指定されたパラメータを指定された Java の
boolean 値に
設定します。 |
void |
setByte(int parameterIndex_,
byte x_)
指定されたパラメータを指定された Java の
byte 値に
設定します。 |
void |
setBytes(int parameterIndex_,
byte[] x_)
指定されたパラメータを指定された Java のバイト配列に設定します。
|
void |
setCharacterStream(int parameterIndex,
java.io.Reader reader)
[サポート外]
|
void |
setCharacterStream(int parameterIndex_,
java.io.Reader reader_,
int length_)
指定されたパラメータを、指定された文字数である指定された
java.io.Reader オブジェクトに設定します。 |
void |
setCharacterStream(int parameterIndex,
java.io.Reader reader,
long length)
[サポート外]
|
void |
setClob(int parameterIndex_,
java.sql.Clob x_)
[サポート外]
指定されたパラメータを指定された
java.sql.Clob
オブジェクトに設定します。 |
void |
setClob(int parameterIndex,
java.io.Reader reader)
[サポート外]
|
void |
setClob(int parameterIndex,
java.io.Reader reader,
long length)
[サポート外]
|
void |
setDate(int parameterIndex_,
java.sql.Date x_)
[制限あり]
指定されたパラメータを指定された
java.sql.Date 値に
設定します。 |
void |
setDate(int parameterIndex_,
java.sql.Date x_,
java.util.Calendar cal_)
[サポート外]
指定された
java.util.Calendar オブジェクトを使用して、
指定されたパラメータを指定された java.sql.Date 値に
設定します。 |
void |
setDouble(int parameterIndex_,
double x_)
指定されたパラメータを指定された Java の
double 値に
設定します。 |
void |
setFloat(int parameterIndex_,
float x_)
指定されたパラメータを指定された Java の
float 値に
設定します。 |
void |
setInt(int parameterIndex_,
int x_)
指定されたパラメータを指定された Java の
int 値に
設定します。 |
void |
setLong(int parameterIndex_,
long x_)
指定されたパラメータを指定された Java の
long 値に
設定します。 |
void |
setNCharacterStream(int parameterIndex,
java.io.Reader value)
[サポート外]
|
void |
setNCharacterStream(int parameterIndex,
java.io.Reader value,
long length)
[サポート外]
|
void |
setNClob(int parameterIndex,
java.sql.NClob value)
[サポート外]
|
void |
setNClob(int parameterIndex,
java.io.Reader reader)
[サポート外]
|
void |
setNClob(int parameterIndex,
java.io.Reader reader,
long length)
[サポート外]
|
void |
setNString(int parameterIndex,
java.lang.String value)
指定されたパラメータを、指定された Java の
String
オブジェクトに設定します。 |
void |
setNull(int parameterIndex_)
指定されたパラメータを SQL
NULL に設定します。 |
void |
setNull(int parameterIndex_,
int sqlType_)
[制限あり]
指定されたパラメータを SQL
NULL に設定します。 |
void |
setNull(int parameterIndex_,
int sqlType_,
java.lang.String typeName_)
[制限あり]
指定されたパラメータを SQL
NULL に設定します。 |
void |
setObject(int parameterIndex_,
java.lang.Object x_)
指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。
|
void |
setObject(int parameterIndex_,
java.lang.Object x_,
int sqlType_)
[制限あり]
指定されたパラメータの値を、指定されたオブジェクトで設定します。
|
void |
setObject(int parameterIndex_,
java.lang.Object x_,
int sqlType_,
int scale_)
[制限あり]
指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。
|
void |
setPoolable(boolean poolable)
[サポート外]
|
void |
setRef(int parameterIndex_,
java.sql.Ref x_)
[サポート外]
指定されたパラメータを指定された
java.sql.Types.REF(<structured-type>) 値に
設定します。 |
void |
setRowId(int parameterIndex,
java.sql.RowId x)
[サポート外]
|
void |
setShort(int parameterIndex_,
short x_)
指定されたパラメータを指定された Java の
short 値に
設定します。 |
void |
setSQLXML(int parameterIndex,
java.sql.SQLXML xmlObject)
[サポート外]
|
void |
setString(int parameterIndex_,
java.lang.String x_)
指定されたパラメータを指定された Java の
java.lang.String 値に設定します。 |
void |
setTime(int parameterIndex_,
java.sql.Time x_)
[サポート外]
指定されたパラメータを指定された
java.sql.Time 値に
設定します。 |
void |
setTime(int parameterIndex_,
java.sql.Time x_,
java.util.Calendar cal_)
[サポート外]
指定された
java.util.Calendar オブジェクトを使用して、
指定されたパラメータを指定された java.sql.Time 値に
設定します。 |
void |
setTimestamp(int parameterIndex_,
java.sql.Timestamp x_)
[制限あり]
指定されたパラメータを指定された
java.sql.Timestamp 値に
設定します。 |
void |
setTimestamp(int parameterIndex_,
java.sql.Timestamp x_,
java.util.Calendar cal_)
[サポート外]
指定された
java.util.Calendar オブジェクトを使用して、
指定されたパラメータを指定された java.sql.Timestamp 値に
設定します。 |
void |
setUnicodeStream(int parameterIndex_,
java.io.InputStream x_,
int length_)
非推奨です。
|
void |
setURL(int parameterIndex_,
java.net.URL x_)
[サポート外]
指定されたパラメータを指定された
java.net.URL 値に
設定します。 |
<T> T |
unwrap(java.lang.Class<T> iface)
[サポート外]
|
addBatch, cancel, clearWarnings, closeOnCompletion, execute, execute, execute, execute, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isCloseOnCompletion, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setMaxFieldSize, setMaxRows, setQueryTimeoutclone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitaddBatch, cancel, clearWarnings, closeOnCompletion, execute, execute, execute, execute, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isCloseOnCompletion, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setQueryTimeoutpublic java.sql.ResultSet executeQuery()
throws java.sql.SQLException
PreparedStatement オブジェクトの
SQL クエリーを実行し、そのクエリーによって生成された
java.sql.ResultSet オブジェクトを返します。executeQuery インタフェース内 java.sql.PreparedStatementjava.sql.ResultSet オブジェクト。
null にはならない。java.sql.SQLException - データベースアクセスエラーが発生した場合、
または SQL 文が java.sql.ResultSet オブジェクトを
返さない場合。public int executeUpdate()
throws java.sql.SQLException
PreparedStatement オブジェクトの
SQL INSERT 文、 UPDATE 文、
または DELETE 文を実行します。
さらに、DDL 文のような何も返さない SQL 文を実行することもできます。executeUpdate インタフェース内 java.sql.PreparedStatementINSERT 文、 UPDATE 文、
DELETE 文の場合は行数。
何も返さない SQL 文の場合は 0 。java.sql.SQLException - データベースアクセスエラーが発生した場合、
または SQL 文が java.sql.ResultSet オブジェクトを
返す場合。public void setNull(int parameterIndex_,
int sqlType_)
throws java.sql.SQLException
NULL に設定します。
注:
現在のバージョンでは、 sqlType_ は無視されます。
setNull インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。sqlType_ - java.sql.Types で定義される、
JDBC 型と呼ばれる、汎用の SQL 型を識別するためのコード。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setBoolean(int parameterIndex_,
boolean x_)
throws java.sql.SQLException
boolean 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.BIT 値に変換します。
注:
現在のバージョンでは、
SQL BIT 型をサポートしていないので、
このメソッドはサポートしていません。
setBoolean インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setByte(int parameterIndex_,
byte x_)
throws java.sql.SQLException
byte 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.TINYINT 値に
変換します。setByte インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setShort(int parameterIndex_,
short x_)
throws java.sql.SQLException
short 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.SMALLINT 値に
変換します。setShort インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setInt(int parameterIndex_,
int x_)
throws java.sql.SQLException
int 値に
設定します。データベースに送るときに、ドライバはこれを
SQL java.sql.Types.INTEGER 値に変換します。setInt インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setLong(int parameterIndex_,
long x_)
throws java.sql.SQLException
long 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.BIGINT 値に変換します。setLong インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setFloat(int parameterIndex_,
float x_)
throws java.sql.SQLException
float 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.FLOAT 値に変換します。setFloat インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setDouble(int parameterIndex_,
double x_)
throws java.sql.SQLException
double 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.DOUBLE 値に変換します。setDouble インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setBigDecimal(int parameterIndex_,
java.math.BigDecimal x_)
throws java.sql.SQLException
java.math.BigDecimal 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.NUMERIC 値に
変換します。
注:
ただし変換された値は SQL java.sql.Types.DECIMAL 型になります。
setBigDecimal インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setString(int parameterIndex_,
java.lang.String x_)
throws java.sql.SQLException
java.lang.String 値に設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.VARCHAR または
java.sql.Types.LONGVARCHAR 値
(ドライバの java.sql.Types.VARCHAR 値に関する
制限に関する引数のサイズに依存) に変換します。setString インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setBytes(int parameterIndex_,
byte[] x_)
throws java.sql.SQLException
java.sql.Types.VARBINARY
または java.sql.Types.LONGVARBINARY
(ドライバの java.sql.Types.VARBINARY 値
に関する制限に関する引数のサイズに依存) に変換します。setBytes インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setDate(int parameterIndex_,
java.sql.Date x_)
throws java.sql.SQLException
java.sql.Date 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.DATE 値に変換します。
注:
現在のバージョンでは、
SQL DATETIME 値に変換します。
setDate インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setTime(int parameterIndex_,
java.sql.Time x_)
throws java.sql.SQLException
java.sql.Time 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.TIME 値に変換します。
注:
現在のバージョンでは、 SQL TIME 型を
サポートしていないため、このメソッドはサポートしていません。
setTime インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setTimestamp(int parameterIndex_,
java.sql.Timestamp x_)
throws java.sql.SQLException
java.sql.Timestamp 値に
設定します。データベースに送るときに、
ドライバはこれを SQL java.sql.Types.TIMESTAMP 値に
変換します。
注:
現在のバージョンでは、
SQL DATETIME 値に変換します。
setTimestamp インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setAsciiStream(int parameterIndex_,
java.io.InputStream x_,
int length_)
throws java.sql.SQLException
java.sql.Types.LONGVARCHAR パラメータに
非常に大きな ASCII 値が入力されるときには、
java.io.InputStream を介して送るのが現実的です。
ファイルの終わりに達するまで必要に応じてストリームからデータが
読み込まれます。 JDBC ドライバは、データを ASCII から
データベースの char 形式に変換します。
注: このストリームオブジェクトは、標準の Java ストリームオブジェクト、 または標準インタフェースを実装する独自のサブクラスの どちらでもかまいません。
setAsciiStream インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - ASCII パラメータ値を含む Java 入力ストリーム。length_ - ストリームのバイト数。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setUnicodeStream(int parameterIndex_,
java.io.InputStream x_,
int length_)
throws java.sql.SQLException
java.sql.Types.LONGVARCHAR パラメータに
非常に大きな Unicode 値が入力されるときには、
java.io.InputStream を介して送るのが現実的です。
ファイルの終わりに達するまで必要に応じてストリームからデータが
読み込まれます。 JDBC ドライバは、データを Unicode から
データベースの char 形式に変換します。
注: このストリームオブジェクトは、標準の Java ストリームオブジェクト、 または標準インタフェースを実装する独自のサブクラスの どちらでもかまいません。
setUnicodeStream インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - Unicode パラメータを 2 バイトの Unicode 文字として格納する
java.io.InputStream オブジェクト。length_ - ストリームのバイト数。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setBinaryStream(int parameterIndex_,
java.io.InputStream x_,
int length_)
throws java.sql.SQLException
java.sql.Types.LONGVARBINARY パラメータに、
非常に大きなバイナリ値が入力されるときには、
java.io.InputStream オブジェクトを介して送るのが
現実的です。ファイルの終わりに達するまで必要に応じて
ストリームからデータが読み込まれます。setBinaryStream インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値を含む Java 入力ストリーム。length_ - ストリームのバイト数。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void clearParameters()
throws java.sql.SQLException
通常、文を繰り返し使用するために、パラメータ値は強制的に残されます。
パラメータ値を設定すると、前の値は自動的にクリアされます。
しかし、現在のパラメータ値によって使用されたリソースを
ただちに解放した方が役に立つ場合があります。
これは、clearParameters メソッドを呼び出して
実行することができます。
clearParameters インタフェース内 java.sql.PreparedStatementjava.sql.SQLException - データベースアクセスエラーが発生した場合。public void setObject(int parameterIndex_,
java.lang.Object x_,
int sqlType_,
int scale_)
throws java.sql.SQLException
注:
現在のバージョンでは、 sqlType_ および
scale_ は無視されます。
setObject インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - 入力パラメータ値を含むオブジェクト。sqlType_ - データベースに送られる、
java.sql.Types で定義される、
JDBC 型と呼ばれる、汎用の SQL 型を識別するためのコード。
スケール引数で、さらに型を限定できる。scale_ - java.sql.Types.DECIMAL や
java.sql.Types.NUMERIC 型では、小数点以下の桁数。
ほかのすべての型では、この値は無視される。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setObject(int parameterIndex_,
java.lang.Object x_,
int sqlType_)
throws java.sql.SQLException
setObject に似ていますが、
スケールに 0 を仮定している点が異なります。
注:
現在のバージョンでは、 sqlType_ は無視されます。
setObject インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - 入力パラメータ値を含むオブジェクト。sqlType_ - データベースに送られる、
java.sql.Types で定義される、
JDBC 型と呼ばれる、汎用の SQL 型を識別するためのコード。
スケール引数で、さらに型を限定できる。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setObject(int parameterIndex_,
java.lang.Object x_)
throws java.sql.SQLException
java.lang.Object の型で
なければなりません。
したがって、組み込み型の場合、等価な java.lang
オブジェクトを使用する必要があります。
JDBC は、Java の java.lang.Object 型から
SQL 型への標準マッピングを
指定しています。指定された引数は、データベースに送られる前に、
対応する SQL 型に変換されます。
このメソッドは、ドライバ固有の Java 型を使用して、データベース固有の
抽象データ型を渡すために使用することに注意してください。
オブジェクトがインタフェース SQLData を実装するクラスの
場合、JDBC ドライバは SQLData.writeSQL メソッドを
呼び出して、そのオブジェクトを SQL データストリームへ書き込む必要が
あります。また、オブジェクトが java.sql.Ref 、
java.sql.Blob 、 java.sql.Clob 、
java.sql.Struct 、または java.sql.Array を
実装するクラスの場合、ドライバは対応する SQL 型の値として
オブジェクトをデータベースに渡さなければなりません。
たとえば、オブジェクトが上記のインタフェースを複数実装するクラスで あるなど、あいまいさがある場合、このメソッドは例外をスローします。
setObject インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - 入力パラメータ値を含むオブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合、
または指定されたオブジェクトの型があいまいである場合。public boolean execute()
throws java.sql.SQLException
PreparedStatement オブジェクトの、
あらゆる種類の SQL 文を実行します。 PreparedStatement
オブジェクトで用意された文には複数の結果を返すものがあります。
execute メソッドは、 executeQuery メソッドと
executeUpdate メソッドによって処理される、
より簡単な形式の文と同様に、複雑な文も処理します。
execute メソッドは、 boolean を返し
最初の結果の形式を示します。 getResultSet メソッドまたは
getUpdateCount メソッドを呼び出して結果を取得します。
そして、 getMoreResults メソッドを呼び出して
引き続き任意の結果の取得 (複数可) に移動します。
execute インタフェース内 java.sql.PreparedStatementjava.sql.ResultSet オブジェクトの
場合は true 。更新カウントであるか、
または結果がない場合は false 。java.sql.SQLException - データベースアクセスエラーが発生した場合、
またはこのメソッドに引数が指定された場合。public void addBatch()
throws java.sql.SQLException
PreparedStatement オブジェクトのコマンドのバッチに、
パラメータのセットを追加します。addBatch インタフェース内 java.sql.PreparedStatementjava.sql.SQLException - データベースアクセスエラーが発生した場合。public void clearBatch()
throws java.sql.SQLException
PreparedStatement オブジェクトの現在の
パラメータリストを空にします。clearBatch インタフェース内 java.sql.StatementclearBatch クラス内 Statementjava.sql.SQLException - データベースアクセスエラーが発生した場合。Statement.addBatch(java.lang.String)public int[] executeBatch()
throws java.sql.SQLException
注: 一旦更新に失敗すると以後のコマンドは実行されません。 また、自動コミットモードを解除するかどうかはアプリケーションに 委ねます。
注:
バッチ更新後、この PreparedStatement オブジェクトの現在の
パラメータリストは自動的に空となります。
executeBatch インタフェース内 java.sql.StatementexecuteBatch クラス内 Statementjava.sql.SQLException - データベースアクセスエラーが発生した場合。
データベースに送信されたコマンドの 1 つが正常に
実行されなかった場合や、結果セットを返そうとすると
BatchUpdateException ( SQLException
のサブクラス) がスローされる。public void setCharacterStream(int parameterIndex_,
java.io.Reader reader_,
int length_)
throws java.sql.SQLException
java.io.Reader オブジェクトに設定します。
java.sql.Types.LONGVARCHAR パラメータに
非常に大きな UNICODE 値を入力するときには、
java.io.Reader オブジェクトを介して
送るほうが現実的です。ファイルの終わりに達するまで必要に応じて
ストリームからデータが読み込まれます。JDBC ドライバは、
データを UNICODE からデータベースの char 形式に変換します。
注: このストリームオブジェクトは、標準の Java ストリームオブジェクト、 または標準インタフェースを実装する独自のサブクラスの どちらでもかまいません。
setCharacterStream インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。reader_ - Unicode データを格納する
java.io.Reader オブジェクト。length_ - ストリーム内の文字数。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setRef(int parameterIndex_,
java.sql.Ref x_)
throws java.sql.SQLException
java.sql.Types.REF(<structured-type>) 値に
設定します。
データベースに送るときに、ドライバはこれを
SQL java.sql.Types.REF 値に
変換します。
注:
現在のバージョンでは、 SQL REF 型を
サポートしていないため、このメソッドはサポートしていません。
setRef インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - SQL java.sql.Types.REF 値。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setBlob(int parameterIndex_,
java.sql.Blob x_)
throws java.sql.SQLException
java.sql.Blob
オブジェクトに設定します。データベースに送るときに、ドライバはこれを
SQL java.sql.Types.BLOB 値に変換します。
注:
現在のバージョンでは、 SQL BLOB 型を
サポートしていないため、このメソッドはサポートしていません。
setBlob インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - SQL java.sql.Types.BLOB 値をマッピングする
java.sql.Blob オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setClob(int parameterIndex_,
java.sql.Clob x_)
throws java.sql.SQLException
java.sql.Clob
オブジェクトに設定します。データベースに送るときに、ドライバはこれを
SQL java.sql.Types.CLOB 値に変換します。
注:
現在のバージョンでは、 SQL CLOB 型を
サポートしていないため、このメソッドはサポートしていません。
setClob インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - SQL java.sql.Types.CLOB 値をマッピングする
java.sql.Clob オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setArray(int parameterIndex_,
java.sql.Array x_)
throws java.sql.SQLException
java.sql.Array
オブジェクトに設定します。データベースに送るときに、ドライバはこれを
SQL java.sql.Types.ARRAY 値に変換します。setArray インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - SQL java.sql.Types.ARRAY 値をマッピングする
java.sql.Array オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。public java.sql.ResultSetMetaData getMetaData()
throws java.sql.SQLException
PreparedStatement が実行されるときに返される
java.sql.ResultSet オブジェクトの列に関する情報を格納する
java.sql.ResultSetMetaData オブジェクトを取得します。
java.sql.PreparedStatement オブジェクトは
プリコンパイルされるので、
実行されずに返される java.sql.ResultSet について
知ることが可能です。
したがって、 java.sql.PreparedStatement について
getMetaData メソッドの実行を待ち、それから返された
java.sql.ResultSet について
ResultSet.getMetaData メソッドを呼び出すのではなく、
getMetaData メソッドを呼び出すことができます。
注: このメソッドの使用は、ドライバによっては 基本となる DBMS サポートが不足しているため 負荷が大きくなる場合があります。
注: 現在のバージョンでは、サポートしていません。
getMetaData インタフェース内 java.sql.PreparedStatementjava.sql.ResultSet オブジェクトの列の記述、
またはドライバが java.sql.ResultSetMetaData
オブジェクトを返すことができない場合は null 。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setDate(int parameterIndex_,
java.sql.Date x_,
java.util.Calendar cal_)
throws java.sql.SQLException
java.util.Calendar オブジェクトを使用して、
指定されたパラメータを指定された java.sql.Date 値に
設定します。ドライバは java.util.Calendar オブジェクトを
使用して SQL java.sql.Types.DATE 値を作成し、
続いてそれをデータベースに送ります。
java.util.Calendar オブジェクトを使用すると、
ドライバはカスタムタイムゾーンを考慮して日付を計算できます。
java.util.Calendar オブジェクトを指定しない場合、
ドライバは、アプリケーションで実行される仮想マシンのタイムゾーンである
デフォルトのタイムゾーンを使用します。
注: 現在のバージョンでは、 サポートしていません。
setDate インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。cal_ - ドライバが日付を作成するために使用する
java.util.Calendar オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setTime(int parameterIndex_,
java.sql.Time x_,
java.util.Calendar cal_)
throws java.sql.SQLException
java.util.Calendar オブジェクトを使用して、
指定されたパラメータを指定された java.sql.Time 値に
設定します。ドライバは java.util.Calendar オブジェクトを
使用して SQL java.sql.Types.TIME 値を作成し、
続いてそれをデータベースに送ります。
java.util.Calendar オブジェクトを使用すると、
ドライバはカスタムタイムゾーンを考慮して時刻を計算できます。
java.util.Calendar オブジェクトを指定しない場合、
ドライバは、アプリケーションで実行される仮想マシンのタイムゾーンである
デフォルトのタイムゾーンを使用します。
注: 現在のバージョンでは、 サポートしていません。
setTime インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。cal_ - ドライバが時刻を作成するために使用する
java.util.Calendar オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setTimestamp(int parameterIndex_,
java.sql.Timestamp x_,
java.util.Calendar cal_)
throws java.sql.SQLException
java.util.Calendar オブジェクトを使用して、
指定されたパラメータを指定された java.sql.Timestamp 値に
設定します。ドライバは java.util.Calendar オブジェクトを
使用して SQL java.sql.Types.TIMESTAMP 値を作成し、
続いてそれをデータベースに送ります。
java.util.Calendar オブジェクトを使用すると、
ドライバはカスタムタイムゾーンを考慮してタイムスタンプを計算できます。
java.util.Calendar オブジェクトを指定しない場合、
ドライバは、アプリケーションで実行される仮想マシンのタイムゾーンである
デフォルトのタイムゾーンを使用します。
注: 現在のバージョンでは、 サポートしていません。
setTimestamp インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - パラメータ値。cal_ - ドライバがタイムスタンプを作成するために使用する
java.util.Calendar オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setNull(int parameterIndex_,
int sqlType_,
java.lang.String typeName_)
throws java.sql.SQLException
NULL に設定します。
ユーザ定義型および java.sql.Types.REF 型のパラメータでは、
このバージョンのメソッド setNull メソッドを
使用しなければなりません。
ユーザ定義型の例には、 java.sql.Types.STRUCT 、
java.sql.Types.DISTINCT 、
java.sql.Types.JAVA_OBJECT 、
および名前付き配列があります。
注:
移植性を実現するためには、アプリケーションは NULL の
ユーザ定義パラメータまたは java.sql.Types.REF パラメータを
指定するときに SQL 型コードおよび完全指定の SQL 型名を
指定しなければなりません。
ユーザ定義型の場合、名前はパラメータ自体の型名です。
java.sql.Types.REF パラメータの場合、
名前は参照される型の型名です。
JDBC ドライバが型コードまたは型名の情報を必要としない場合、
それは無視されます。ユーザ定義パラメータおよび
java.sql.Types.REF パラメータを対象としていますが、
このメソッドは任意の JDBC 型の null パラメータを
設定するために使用できます。
パラメータがユーザ定義の型または java.sql.Types.REF 型を
持たない場合、指定された typeName_ は無視されます。
注:
現在のバージョンでは、
sqlType_ および typeName_ は無視されます。
setNull インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。sqlType_ - java.sql.Types で定義される、
JDBC 型と呼ばれる、汎用の SQL 型を識別するためのコード。typeName_ - SQL ユーザ定義型の完全指定の名前。
パラメータがユーザ定義型でも
java.sql.Types.REF でもない場合は
無視される。java.sql.SQLException - データベースアクセスエラーが発生した場合。public void setURL(int parameterIndex_,
java.net.URL x_)
throws java.sql.SQLException
java.net.URL 値に
設定します。データベースに送るときに、ドライバはこれを
SQL java.sql.Types.DATALINK 値に変換します。
注:
現在のバージョンでは、 SQL DATALINK 型を
サポートしていないため、このメソッドはサポートしていません。
setURL インタフェース内 java.sql.PreparedStatementparameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。x_ - 設定される java.net.URL オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。public java.sql.ParameterMetaData getParameterMetaData()
throws java.sql.SQLException
PreparedStatement オブジェクトの
パラメータの数、型、およびプロパティを取得します。
注: 現在のバージョンでは、サポートしていません。
getParameterMetaData インタフェース内 java.sql.PreparedStatementPreparedStatement オブジェクトの
パラメータの数、型、およびプロパティについての情報を格納する
ParameterMetaData オブジェクト。java.sql.SQLException - データベースアクセスエラーが発生した場合。ParameterMetaDatapublic java.sql.ResultSet executeQuery(java.lang.String sql_)
throws java.sql.SQLException
java.sql.ResultSetオブジェクトを返す、
指定された SQL文を実行します。
注:
このメソッドは、
PreparedStatement オブジェクトに対して使用できません。
executeQuery インタフェース内 java.sql.StatementexecuteQuery クラス内 Statementsql_ - データベースに送られる SQL 文。
通常静的 SQL SELECT 文。java.sql.ResultSet オブジェクト。
null にはならない。java.sql.SQLException - データベースアクセスエラーが発生した場合、
または指定された SQL 文が単一の
java.sql.ResultSet オブジェクト以外のものを
生成する場合。public int executeUpdate(java.lang.String sql_)
throws java.sql.SQLException
INSERT 文、
UPDATE 文、 DELETE 文、
または SQL DDL 文のような何も返さない SQL 文の場合があります。
注:
このメソッドは、
PreparedStatement オブジェクトに対して使用できません。
executeUpdate インタフェース内 java.sql.StatementexecuteUpdate クラス内 Statementsql_ - SQL INSERT 文、 UPDATE 文、
または DELETE 文、
あるいは何も返さない SQL 文。INSERT 文、 UPDATE 文、
DELETE 文の場合は行数。
何も返さない SQL 文の場合は 0 。java.sql.SQLException - データベースアクセスエラーが発生した場合、
または指定された SQL 文が
java.sql.ResultSet オブジェクトを生成する場合。public void close()
throws java.sql.SQLException
java.sql.Statement
オブジェクトのデータベースと JDBC リソースが解放されるのを
待つのではなく、ただちにそれらを解放します。
データベースのリソースを占有するのを避けるために、
通常は、作業が終了したらすぐにリソースを解放するようにしてください。
すでにクローズされた java.sql.Statement オブジェクトで
close メソッドを呼び出すと、操作は行われません。
public void setNull(int parameterIndex_)
throws java.sql.SQLException
NULL に設定します。parameterIndex_ - 最初のパラメータは 1 、 2 番目のパラメータは 2 、などとする。java.sql.SQLException - データベースアクセスエラーが発生した場合。protected void finalize()
throws java.lang.Throwable
public boolean isClosed()
throws java.sql.SQLException
PreparedStatement オブジェクトがクローズ
されているかどうかを取得します。public void setPoolable(boolean poolable)
throws java.sql.SQLException
setPoolable インタフェース内 java.sql.StatementsetPoolable クラス内 Statementjava.sql.SQLExceptionpublic boolean isPoolable()
throws java.sql.SQLException
false を返すisPoolable インタフェース内 java.sql.StatementisPoolable クラス内 Statementjava.sql.SQLExceptionpublic <T> T unwrap(java.lang.Class<T> iface)
throws java.sql.SQLException
public boolean isWrapperFor(java.lang.Class<?> iface)
throws java.sql.SQLException
常にfalseを返します
isWrapperFor インタフェース内 java.sql.WrapperisWrapperFor クラス内 Statementjava.sql.SQLExceptionpublic void setRowId(int parameterIndex,
java.sql.RowId x)
throws java.sql.SQLException
setRowId インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setNString(int parameterIndex,
java.lang.String value)
throws java.sql.SQLException
String
オブジェクトに設定します。
データベースに送るときに、ドライバはこでをSQL NCHAR、
NVARCHAR 値に変換します。setNString インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setNCharacterStream(int parameterIndex,
java.io.Reader value,
long length)
throws java.sql.SQLException
setNCharacterStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setNClob(int parameterIndex,
java.sql.NClob value)
throws java.sql.SQLException
setNClob インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setClob(int parameterIndex,
java.io.Reader reader,
long length)
throws java.sql.SQLException
setClob インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setBlob(int parameterIndex,
java.io.InputStream inputStream,
long length)
throws java.sql.SQLException
setBlob インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setNClob(int parameterIndex,
java.io.Reader reader,
long length)
throws java.sql.SQLException
setNClob インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setSQLXML(int parameterIndex,
java.sql.SQLXML xmlObject)
throws java.sql.SQLException
setSQLXML インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setAsciiStream(int parameterIndex,
java.io.InputStream x,
long length)
throws java.sql.SQLException
setAsciiStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setBinaryStream(int parameterIndex,
java.io.InputStream x,
long length)
throws java.sql.SQLException
setBinaryStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setCharacterStream(int parameterIndex,
java.io.Reader reader,
long length)
throws java.sql.SQLException
setCharacterStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setAsciiStream(int parameterIndex,
java.io.InputStream x)
throws java.sql.SQLException
setAsciiStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setBinaryStream(int parameterIndex,
java.io.InputStream x)
throws java.sql.SQLException
setBinaryStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setCharacterStream(int parameterIndex,
java.io.Reader reader)
throws java.sql.SQLException
setCharacterStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setNCharacterStream(int parameterIndex,
java.io.Reader value)
throws java.sql.SQLException
setNCharacterStream インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setClob(int parameterIndex,
java.io.Reader reader)
throws java.sql.SQLException
setClob インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setBlob(int parameterIndex,
java.io.InputStream inputStream)
throws java.sql.SQLException
setBlob インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionpublic void setNClob(int parameterIndex,
java.io.Reader reader)
throws java.sql.SQLException
setNClob インタフェース内 java.sql.PreparedStatementjava.sql.SQLExceptionCopyright © 2023 RICOH Co., Ltd. All Rights Reserved.