すべてのスーパー・インタフェース:: AutoCloseable, Statement, Wrapper

既知のすべてのサブインタフェース:: CallableStatement

public interface PreparedStatement extends Statement

プリコンパイルされたSQL文を表すオブジェクトです。

SQL文は、プリコンパイルされ、PreparedStatementオブジェクトに� �納されます。その後、このオブジェクトは、この文を複数回効率的に実行するために使用できます。

ノート: INパラメータ値を設定する設定機能メソッド(setShort、setStringなど)は、入力パラメータの定義されたSQL型と互換のある型を指定する必要があります。たとえば、INパラメータがINTEGERというSQL型の� �合、setIntメソッドを使用するようにしてく� さい。

任意のパラメータ型変換が必要な� �合は、目的のSQL型を指定してsetObjectメソッドを使用するようにしてく� さい。

パラメータ設定の例を次に示します。conはアクティブな接続を表します。


   BigDecimal sal = new BigDecimal("153833.00");
   PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES
                                     SET SALARY = ? WHERE ID = ?");
   pstmt.setBigDecimal(1, sal);
   pstmt.setInt(2, 110592);

導入されたバージョン:

1.1

関連� �目:

フィールドのサマリー

インタフェースjava.sql.Statementで宣言されているフィールド
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO
メソッドのサマリー

修飾子と型

メソッド

説明

void

addBatch()

このPreparedStatementオブジェクトのコマンドのバッチに、パラメータのセットを追� します。

void

clearParameters()

現在のパラメータ値をすぐにクリアします。

boolean

execute()

このPreparedStatementオブジェクトの、あらゆる種類のSQL文を実行します。

default long

executeLargeUpdate()

このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。

ResultSet

executeQuery()

このPreparedStatementオブジェクトのSQLクエリーを実行し、そのクエリーによって生成されたResultSetオブジェクトを返します。

int

executeUpdate()

このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。

ResultSetMetaData

getMetaData()

このPreparedStatementオブジェクトが実行されるときに返されるResultSetオブジェクトの列に関する情� �を� �納するResultSetMetaDataオブジェクトを取得します。

ParameterMetaData

getParameterMetaData()

このPreparedStatementオブジェクトのパラメータの数、型、およびプロパティを取得します。

void

setArray(int parameterIndex, Array x)

指定されたパラメータを指定されたjava.sql.Arrayオブジェクトに設定します。

void

setAsciiStream(int parameterIndex, InputStream x)

指定されたパラメータを指定された入力ストリー� に設定します。

void

setAsciiStream(int parameterIndex, InputStream x, int length)

指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。

void

setAsciiStream(int parameterIndex, InputStream x, long length)

指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。

void

setBigDecimal(int parameterIndex, BigDecimal x)

指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。

void

setBinaryStream(int parameterIndex, InputStream x)

指定されたパラメータを指定された入力ストリー� に設定します。

void

setBinaryStream(int parameterIndex, InputStream x, int length)

指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。

void

setBinaryStream(int parameterIndex, InputStream x, long length)

指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。

void

setBlob(int parameterIndex, InputStream inputStream)

指定されたパラメータをInputStreamオブジェクトに設定します。

void

setBlob(int parameterIndex, InputStream inputStream, long length)

指定されたパラメータをInputStreamオブジェクトに設定します。

void

setBlob(int parameterIndex, Blob x)

指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。

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, Reader reader)

指定されたパラメータを指定されたReaderオブジェクトに設定します。

void

setCharacterStream(int parameterIndex, Reader reader, int length)

指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。

void

setCharacterStream(int parameterIndex, Reader reader, long length)

指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。

void

setClob(int parameterIndex, Reader reader)

指定されたパラメータをReaderオブジェクトに設定します。

void

setClob(int parameterIndex, Reader reader, long length)

指定されたパラメータをReaderオブジェクトに設定します。

void

setClob(int parameterIndex, Clob x)

指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。

void

setDate(int parameterIndex, Date x)

アプリケーションを実行している仮想マシンのデフォルトのタイ� ゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。

void

setDate(int parameterIndex, Date x, Calendar cal)

指定された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, Reader value)

指定されたパラメータをReaderオブジェクトに設定します。

void

setNCharacterStream(int parameterIndex, Reader value, long length)

指定されたパラメータをReaderオブジェクトに設定します。

void

setNClob(int parameterIndex, Reader reader)

指定されたパラメータをReaderオブジェクトに設定します。

void

setNClob(int parameterIndex, Reader reader, long length)

指定されたパラメータをReaderオブジェクトに設定します。

void

setNClob(int parameterIndex, NClob value)

指定されたパラメータをjava.sql.NClobオブジェクトに設定します。

void

setNString(int parameterIndex, String value)

指定されたパラメータを指定されたStringオブジェクトに設定します。

void

setNull(int parameterIndex, int sqlType)

指定されたパラメータをSQL NULLに設定します。

void

setNull(int parameterIndex, int sqlType, String typeName)

指定されたパラメータをSQL NULLに設定します。

void

setObject(int parameterIndex, Object x)

指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。

void

setObject(int parameterIndex, Object x, int targetSqlType)

指定されたパラメータの値を、指定されたオブジェクトで設定します。

void

setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)

指定されたパラメータの値を、指定されたオブジェクトで設定します。

default void

setObject(int parameterIndex, Object x, SQLType targetSqlType)

指定されたパラメータの値を、指定されたオブジェクトで設定します。

default void

setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength)

指定されたパラメータの値を、指定されたオブジェクトで設定します。

void

setRef(int parameterIndex, Ref x)

指定されたパラメータを、指定されたREF(<structured-type>)値に設定します。

void

setRowId(int parameterIndex, RowId x)

指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。

void

setShort(int parameterIndex, short x)

指定されたパラメータを指定されたJavaのshort値に設定します。

void

setSQLXML(int parameterIndex, SQLXML xmlObject)

指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。

void

setString(int parameterIndex, String x)

指定されたパラメータを指定されたJavaのString値に設定します。

void

setTime(int parameterIndex, Time x)

指定されたパラメータを、指定されたjava.sql.Time値に設定します。

void

setTime(int parameterIndex, Time x, Calendar cal)

指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。

void

setTimestamp(int parameterIndex, Timestamp x)

指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。

void

setTimestamp(int parameterIndex, Timestamp x, Calendar cal)

指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。

void

setUnicodeStream(int parameterIndex, InputStream x, int length)

非推奨。
setCharacterStreamを使用

void

setURL(int parameterIndex, URL x)

指定されたパラメータを、指定されたjava.net.URL値に設定します。

インタフェースjava.sql.Statementで宣言されたメソッド
addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

インタフェースjava.sql.Wrapperで宣言されたメソッド
isWrapperFor, unwrap

メソッドの詳細
- executeQuery
  
  ResultSet executeQuery() throws SQLException
  
  このPreparedStatementオブジェクトのSQLクエリーを実行し、そのクエリーによって生成されたResultSetオブジェクトを返します。
  
  戻り値:
  
  クエリーによって作成されたデータを含むResultSetオブジェクト。nullにはならない
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、またはSQL文がResultSetオブジェクトを返さない� �合
  
  SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイ� ・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき
- executeUpdate
  
  int executeUpdate() throws SQLException
  
  このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
  
  戻り値:
  
  (1) SQLデータ操作言語(DML)文の� �合は行数、(2)何も返さないSQL文の� �合は0
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、またはSQL文がResultSetオブジェクトを返した� �合
  
  SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイ� ・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき
- setNull
  
  void setNull(int parameterIndex, int sqlType) throws SQLException
  
  指定されたパラメータをSQL NULLに設定します。
  ノート: パラメータのSQLの型を指定する必要があります。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  sqlType - java.sql.Typesで定義されるSQL型コード
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない� �合
- setBoolean
  
  void setBoolean(int parameterIndex, boolean x) throws SQLException
  
  指定されたパラメータを指定されたJavaのboolean値に設定します。データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setByte
  
  void setByte(int parameterIndex, byte x) throws SQLException
  
  指定されたパラメータを指定されたJavaのbyte値に設定します。データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setShort
  
  void setShort(int parameterIndex, short x) throws SQLException
  
  指定されたパラメータを指定されたJavaのshort値に設定します。データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setInt
  
  void setInt(int parameterIndex, int x) throws SQLException
  
  指定されたパラメータを指定されたJavaのint値に設定します。データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setLong
  
  void setLong(int parameterIndex, long x) throws SQLException
  
  指定されたパラメータを指定されたJavaのlong値に設定します。データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setFloat
  
  void setFloat(int parameterIndex, float x) throws SQLException
  
  指定されたパラメータを指定されたJavaのfloat値に設定します。データベースに送るときに、ドライバはこれをSQL REAL値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setDouble
  
  void setDouble(int parameterIndex, double x) throws SQLException
  
  指定されたパラメータを指定されたJavaのdouble値に設定します。データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setBigDecimal
  
  void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
  
  指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setString
  
  void setString(int parameterIndex, String x) throws SQLException
  
  指定されたパラメータを指定されたJavaのString値に設定します。データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setBytes
  
  void setBytes(int parameterIndex, byte[] x) throws SQLException
  
  指定されたパラメータを指定されたJavaのバイト配列に設定します。データベースに送るときに、ドライバはこれをSQL VARBINARYまたはLONGVARBINARY (ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setDate
  
  void setDate(int parameterIndex, Date x) throws SQLException
  
  アプリケーションを実行している仮想マシンのデフォルトのタイ� ゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。データベースに送るときに、ドライバはこれをSQL DATE値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setTime
  
  void setTime(int parameterIndex, Time x) throws SQLException
  
  指定されたパラメータを、指定されたjava.sql.Time値に設定します。データベースに送るときに、ドライバはこれをSQL TIME値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setTimestamp
  
  void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
  
  指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setAsciiStream
  
  void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException
  
  指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - ASCIIパラメータ値を含むJava入力ストリー�
  
  length - ストリー� のバイト数
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- setUnicodeStream
  
  @Deprecated(since="1.2") void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
  
  非推奨。
  setCharacterStreamを使用
  
  指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。 LONGVARCHARパラメータに非常に大きなUnicode値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。 JDBCドライバは、データをUnicodeからデータベースのchar形式に変換します。 Unicodeストリー� のバイト形式は、Java仮想マシン仕様に定義されているJava UTF-8である必要があります。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - Unicodeパラメータ値を含むjava.io.InputStreamオブジェクト
  
  length - ストリー� のバイト数
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
- setBinaryStream
  
  void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException
  
  指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - バイナリ・パラメータ値を含むJava入力ストリー�
  
  length - ストリー� のバイト数
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
- clearParameters
  
  void clearParameters() throws SQLException
  
  現在のパラメータ値をすぐにクリアします。
  通常、文を繰返し使用するために、パラメータ値は強制的に残されます。パラメータ値を設定すると、前の値は自動的にクリアされます。しかし、現在のパラメータ値によって使用されたリソースをた� ちに解放した方が役に立つ� �合があります。これは、clearParametersメソッドを呼び出して実行することができます。
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された� �合
- setObject
  void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
  
  指定されたパラメータの値を、指定されたオブジェクトで設定します。このメソッドは、setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)に似ていますが、scaleに0を仮定している点が異なります。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - 入力パラメータ値を含むオブジェクト
  
  targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない� �合
  
  関連� �目:
  
  Types
- setObject
  
  void setObject(int parameterIndex, Object x) throws SQLException
  
  指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。
  JDBCの仕様では、JavaのObject型からSQL型への標準マッピングを規定しています。指定された引数は、データベースに送られる前に、対応するSQL型に変換されます。
  このメソッドは、ドライバ固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用できます。オブジェクトがインタフェースSQLDataを実装するクラスのインスタンスである� �合、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリー� へ書き込む必要があります。また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、RowId、SQLXML、またはArrayを実装するクラスのオブジェクトである� �合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡すべきです。
  ノート: すべてのデータベースで、バックエンドに対する型のないNullの送信が許可されるわけではありません。移植性を最大限にするには、setObject(int parameterIndex, Object x)の代わりにsetNullメソッドまたはsetObject(int parameterIndex, Object x, int sqlType)メソッドを使用するようにしてく� さい。
  ノート: たとえば、オブジェクトが上記のインタフェースを複数実装するクラスであるなど、あいまいさがある� �合、このメソッドは例外をスローします。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - 入力パラメータ値を含むオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、または指定されたオブジェクトの型があいまいな� �合
- execute
  boolean execute() throws SQLException
  
  このPreparedStatementオブジェクトの、あらゆる種類のSQL文を実行します。プリペアド文オブジェクトで用意された文には複数の結果を返すものがあります。executeメソッドは、executeQueryメソッドとexecuteUpdateメソッドによって処理される、より簡単な形式の文と同様に、複雑な文も処理します。
  executeメソッドは、booleanを返し最初の結果の形式を示します。 getResultSetまたはgetUpdateCountメソッドを呼び出して結果を取得します。後続の結果がある� �合はgetMoreResultsを呼び出してその結果に移動します。
  
  戻り値:
  
  最初の結果がResultSetオブジェクトの� �合はtrue。更新カウントであるか、または結果がない� �合はfalse
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、または引数がこのメソッドに指定された� �合
  
  SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイ� ・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき
  
  関連� �目:
  
  Statement.execute(java.lang.String)
  
  Statement.getResultSet()
  
  Statement.getUpdateCount()
  
  Statement.getMoreResults()
- addBatch
  void addBatch() throws SQLException
  
  このPreparedStatementオブジェクトのコマンドのバッチに、パラメータのセットを追� します。
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された� �合
  
  導入されたバージョン:
  
  1.2
  
  関連� �目:
  
  Statement.addBatch(java.lang.String)
- setCharacterStream
  
  void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException
  
  指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  reader - Unicodeデータを� �納するjava.io.Readerオブジェクト
  
  length - ストリー� 内の文字数
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  導入されたバージョン:
  
  1.2
- setRef
  
  void setRef(int parameterIndex, Ref x) throws SQLException
  
  指定されたパラメータを、指定されたREF(<structured-type>)値に設定します。データベースに送るときに、ドライバはこれをSQL REF値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - SQL REF値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.2
- setBlob
  
  void setBlob(int parameterIndex, Blob x) throws SQLException
  
  指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - SQL BLOB値をマッピングするBlobオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.2
- setClob
  
  void setClob(int parameterIndex, Clob x) throws SQLException
  
  指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - SQL CLOB値をマッピングするClobオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.2
- setArray
  
  void setArray(int parameterIndex, Array x) throws SQLException
  
  指定されたパラメータを指定されたjava.sql.Arrayオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL ARRAY値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - SQL ARRAY値をマッピングするArrayオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.2
- getMetaData
  
  ResultSetMetaData getMetaData() throws SQLException
  
  このPreparedStatementオブジェクトが実行されるときに返されるResultSetオブジェクトの列に関する情� �を� �納するResultSetMetaDataオブジェクトを取得します。
  PreparedStatementオブジェクトはプリコンパイルされるので、実行せずに、返されるResultSetオブジェクトについて知ることが可能です。したがって、PreparedStatementオブジェクトのgetMetaDataメソッドを呼び出すことができます。その実行を待ち、それから返されたResultSetオブジェクトに対してResultSet.getMetaDataメソッドを呼び出す必要はありません。
  ノート: このメソッドの使用は、ドライバによっては基本となるDBMSサポートが不足しているため� 荷が大きくなる� �合があります。
  
  戻り値:
  
  ResultSetオブジェクトの列の記述、またはドライバがResultSetMetaDataオブジェクトを返すことができない� �合はnull
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.2
- setDate
  
  void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
  
  指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。ドライバはCalendarオブジェクトを使用してSQL DATE値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタ� ・タイ� ゾーンを考慮して日付を計算できます。 Calendarオブジェクトを指定しない� �合、ドライバは、アプリケーションを実行している仮想マシンのタイ� ゾーンであるデフォルトのタイ� ゾーンを使用します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  cal - ドライバが日付を作成するために使用するCalendarオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  導入されたバージョン:
  
  1.2
- setTime
  
  void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
  
  指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。ドライバはCalendarオブジェクトを使用してSQL TIME値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタ� ・タイ� ゾーンを考慮して時間を計算できます。 Calendarオブジェクトを指定しない� �合、ドライバは、アプリケーションを実行している仮想マシンのタイ� ゾーンであるデフォルトのタイ� ゾーンを使用します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  cal - ドライバが時間を作成するために使用するCalendarオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  導入されたバージョン:
  
  1.2
- setTimestamp
  
  void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
  
  指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。ドライバはCalendarオブジェクトを使用してSQL TIMESTAMP値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタ� ・タイ� ゾーンを考慮してタイ� スタンプを計算できます。 Calendarオブジェクトを指定しない� �合、ドライバは、アプリケーションを実行している仮想マシンのタイ� ゾーンであるデフォルトのタイ� ゾーンを使用します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  cal - ドライバがタイ� スタンプを作成するために使用するCalendarオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  導入されたバージョン:
  
  1.2
- setNull
  
  void setNull(int parameterIndex, int sqlType, String typeName) throws SQLException
  
  指定されたパラメータをSQL NULLに設定します。ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用するべきです。ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。
  ノート: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全修飾SQL型名を指定しなければいけません。ユーザー定義型の� �合、名前はパラメータ自体の型名です。 REFパラメータの� �合、名前は参照される型の型名です。 JDBCドライバが型コードまたは型名の情� �を必要としない� �合、それは無視されます。ユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。パラメータがユーザー定義の型またはREF型を持たない� �合、指定されたtypeNameは無視されます。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  sqlType - java.sql.Typesからの値
  
  typeName - SQLユーザー定義型の完全指定の名前。パラメータがユーザー定義型でもREFでもない� �合は無視される
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない� �合。またはJDBCドライバがこのメソッドをサポートしていない� �合
  
  導入されたバージョン:
  
  1.2
- setURL
  
  void setURL(int parameterIndex, URL x) throws SQLException
  
  指定されたパラメータを、指定されたjava.net.URL値に設定します。データベースに送るときに、ドライバはこれをSQL DATALINK値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - 設定されるjava.net.URLオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.4
- getParameterMetaData
  ParameterMetaData getParameterMetaData() throws SQLException
  
  このPreparedStatementオブジェクトのパラメータの数、型、およびプロパティを取得します。
  
  戻り値:
  
  このPreparedStatementオブジェクトの各パラメータ・マーカーの数、型、およびプロパティについての情� �を� �納するParameterMetaDataオブジェクト
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された� �合
  
  導入されたバージョン:
  
  1.4
  
  関連� �目:
  
  ParameterMetaData
- setRowId
  
  void setRowId(int parameterIndex, RowId x) throws SQLException
  
  指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL ROWID値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setNString
  
  void setNString(int parameterIndex, String value) throws SQLException
  
  指定されたパラメータを指定されたStringオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHAR値(ドライバのNVARCHAR値に関する制限に関する引数のサイズに依存)に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  value - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、ドライバが各国の文字セットをサポートしない� �合、ドライバがデータ変換エラーが発生したことを検出できる� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setNCharacterStream
  
  void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
  
  指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  value - パラメータ値
  
  length - パラメータ・データ内の文字数。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、ドライバが各国の文字セットをサポートしない� �合、ドライバがデータ変換エラーが発生したことを検出できる� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setNClob
  
  void setNClob(int parameterIndex, NClob value) throws SQLException
  
  指定されたパラメータをjava.sql.NClobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL NCLOB値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  value - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、ドライバが各国の文字セットをサポートしない� �合、ドライバがデータ変換エラーが発生したことを検出できる� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setClob
  
  void setClob(int parameterIndex, Reader reader, long length) throws SQLException
  
  指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない� �合、PreparedStatementの実行時にSQLExceptionが生成されます。このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  reader - パラメータ値に設定されるデータを含むオブジェクト。
  
  length - パラメータ・データ内の文字数。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、または指定されたlengthが0より小さい� �合。
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setBlob
  
  void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException
  
  指定されたパラメータをInputStreamオブジェクトに設定します。 Inputstreamには、長さで指定された文字数が含まれている必要があります。そうでない� �合、PreparedStatementの実行時にSQLExceptionが生成されます。このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  inputStream - パラメータ値に設定されるデータを含むオブジェクト。
  
  length - パラメータ・データ内のバイト数。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応していない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドはクローズされたPreparedStatementでコールされます。指定された長さがゼロ未満の� �合、またはInputStreamのバイト数が指定された長さと一致しない� �合。
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setNClob
  
  void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
  
  指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない� �合、PreparedStatementの実行時にSQLExceptionが生成されます。このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  reader - パラメータ値に設定されるデータを含むオブジェクト。
  
  length - パラメータ・データ内の文字数。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない� �合、長さとしてゼロ未満の値が指定された� �合、ドライバが各国文字セットをサポートしない� �合、ドライバがデータ変換エラーが発生した可能性を検出できる� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatement上で呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setSQLXML
  
  void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
  
  指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL XML値に変換します。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  xmlObject - SQL XML値をマッピングするSQLXMLオブジェクト
  
  スロー:
  
  SQLException - parameterIndexが指定されたSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementまたはjava.xml.transform.Resultで呼び出された� �合、WriterまたはOutputStreamがSQLXMLオブジェクトに対してクローズされていない� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setObject
  void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException
  
  指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数がInputStreamである� �合、ストリー� にはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderである� �合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。これらの条件がtrueではない� �合、準備された文の実行時にドライバはSQLExceptionを生成します。
  指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。オブジェクトがカスタ� ・マッピングを持つ� �合(オブジェクトがインタフェースSQLDataを実装するクラスのインスタンスである� �合)、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリー� へ書き込む必要があります。また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである� �合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。
  このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - 入力パラメータ値を含むオブジェクト
  
  targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。
  
  scaleOrLength - java.sql.Types.DECIMALまたはjava.sql.Types.NUMERIC typesの� �合、これは小数点のあとの桁数になる。 Javaオブジェクト型InputStreamおよびReaderの� �合は、ストリー� またはリーダーのデータ長。ほかのすべての型では、この値は無視される。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、またはxで指定されたJavaオブジェクトがInputStreamオブジェクトかReaderオブジェクトで、かつscaleパラメータの値が0より小さい� �合
  
  SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない� �合
  
  関連� �目:
  
  Types
- setAsciiStream
  
  void setAsciiStream(int parameterIndex, InputStream x, long length) throws SQLException
  
  指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - ASCIIパラメータ値を含むJava入力ストリー�
  
  length - ストリー� のバイト数
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  導入されたバージョン:
  
  1.6
- setBinaryStream
  
  void setBinaryStream(int parameterIndex, InputStream x, long length) throws SQLException
  
  指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリー� に設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - バイナリ・パラメータ値を含むJava入力ストリー�
  
  length - ストリー� のバイト数
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  導入されたバージョン:
  
  1.6
- setCharacterStream
  
  void setCharacterStream(int parameterIndex, Reader reader, long length) throws SQLException
  
  指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  reader - Unicodeデータを� �納するjava.io.Readerオブジェクト
  
  length - ストリー� 内の文字数
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  導入されたバージョン:
  
  1.6
- setAsciiStream
  
  void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
  
  指定されたパラメータを指定された入力ストリー� に設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  ノート: lengthパラメータを使用するバージョンのsetAsciiStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - ASCIIパラメータ値を含むJava入力ストリー�
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setBinaryStream
  
  void setBinaryStream(int parameterIndex, InputStream x) throws SQLException
  
  指定されたパラメータを指定された入力ストリー� に設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  ノート: lengthパラメータを使用するバージョンのsetBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - バイナリ・パラメータ値を含むJava入力ストリー�
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setCharacterStream
  
  void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
  
  指定されたパラメータを指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリー� からデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  ノート: lengthパラメータを使用するバージョンのsetCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  reader - Unicodeデータを� �納するjava.io.Readerオブジェクト
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setNCharacterStream
  
  void setNCharacterStream(int parameterIndex, Reader value) throws SQLException
  
  指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。
  ノート: このストリー� ・オブジェクトは、標準のJavaストリー� ・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
  ノート: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  value - パラメータ値
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、ドライバが各国の文字セットをサポートしない� �合、ドライバがデータ変換エラーが発生したことを検出できる� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setClob
  
  void setClob(int parameterIndex, Reader reader) throws SQLException
  
  指定されたパラメータをReaderオブジェクトに設定します。このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
  ノート: lengthパラメータを使用するバージョンのsetClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  reader - パラメータ値に設定されるデータを含むオブジェクト。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、またはparameterIndexがSQL文のパラメータ・マーカーに対応しない� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setBlob
  
  void setBlob(int parameterIndex, InputStream inputStream) throws SQLException
  
  指定されたパラメータをInputStreamオブジェクトに設定します。このメソッドは、setBinaryStream (int, InputStream)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
  ノート: lengthパラメータを使用するバージョンのsetBlobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  inputStream - パラメータ値に設定されるデータを含むオブジェクト。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、またはparameterIndexがSQL文のパラメータ・マーカーに対応しない� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setNClob
  
  void setNClob(int parameterIndex, Reader reader) throws SQLException
  
  指定されたパラメータをReaderオブジェクトに設定します。このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
  ノート: lengthパラメータを使用するバージョンのsetNClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してく� さい。
  
  パラメータ:
  
  parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
  
  reader - パラメータ値に設定されるデータを含むオブジェクト。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、ドライバが各国の文字セットをサポートしない� �合、ドライバがデータ変換エラーが発生したことを検出できる� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない� �合
  
  導入されたバージョン:
  
  1.6
- setObject
  default void setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
  
  指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数がInputStreamである� �合、ストリー� にはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderである� �合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。これらの条件がtrueではない� �合、準備された文の実行時にドライバはSQLExceptionを生成します。
  指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。オブジェクトがカスタ� ・マッピングを持つ� �合(オブジェクトがインタフェースSQLDataを実装するクラスのインスタンスである� �合)、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリー� へ書き込む必要があります。また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである� �合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。
  このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してく� さい。
  デフォルト実装はSQLFeatureNotSupportedExceptionをスローします
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - 入力パラメータ値を含むオブジェクト
  
  targetSqlType - データベースに送られるSQL型。 scale引数で、さらにこの型を限定できる。
  
  scaleOrLength - java.sql.JDBCType.DECIMALまたはjava.sql.JDBCType.NUMERIC型の� �合、これは小数点の後の桁数になる。 Javaオブジェクト型InputStreamおよびReaderの� �合は、ストリー� またはリーダーのデータ長。ほかのすべての型では、この値は無視される。
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、またはxで指定されたJavaオブジェクトがInputStreamオブジェクトかReaderオブジェクトで、かつscaleパラメータの値が0より小さい� �合
  
  SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない� �合
  
  導入されたバージョン:
  
  1.8
  
  関連� �目:
  
  JDBCType
  
  SQLType
- setObject
  default void setObject(int parameterIndex, Object x, SQLType targetSqlType) throws SQLException
  
  指定されたパラメータの値を、指定されたオブジェクトで設定します。このメソッドは、setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength)に似ていますが、scaleに0を仮定している点が異なります。
  デフォルト実装はSQLFeatureNotSupportedExceptionをスローします
  
  パラメータ:
  
  parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
  
  x - 入力パラメータ値を含むオブジェクト
  
  targetSqlType - データベースに送られるSQL型
  
  スロー:
  
  SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない� �合、データベース・アクセス・エラーが発生した� �合、またはこのメソッドがクローズされたPreparedStatementで呼び出された� �合
  
  SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない� �合
  
  導入されたバージョン:
  
  1.8
  
  関連� �目:
  
  JDBCType
  
  SQLType
- executeLargeUpdate
  
  default long executeLargeUpdate() throws SQLException
  
  このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
  返される行数がInteger.MAX_VALUEを超える可能性がある� �合は、このメソッドを使用するようにしてく� さい。
  デフォルト実装はUnsupportedOperationExceptionをスローします
  
  戻り値:
  
  (1) SQLデータ操作言語(DML)文の� �合は行数、(2)何も返さないSQL文の� �合は0
  
  スロー:
  
  SQLException - データベース・アクセス・エラーが発生した� �合、このメソッドがクローズされたPreparedStatementで呼び出された� �合、またはSQL文がResultSetオブジェクトを返した� �合
  
  SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイ� ・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき
  
  導入されたバージョン:
  
  1.8

インタフェースPreparedStatement

フィールドのサマリー

インタフェースjava.sql.Statementで宣言されているフィールド

メソッドのサマリー

インタフェースjava.sql.Statementで宣言されたメソッド

インタフェースjava.sql.Wrapperで宣言されたメソッド

メソッドの詳細

executeQuery

executeUpdate

setNull

setBoolean

setByte

setShort

setInt

setLong

setFloat

setDouble

setBigDecimal

setString

setBytes

setDate

setTime

setTimestamp

setAsciiStream

setUnicodeStream

setBinaryStream

clearParameters

setObject

setObject

execute

addBatch

setCharacterStream

setRef

setBlob

setClob

setArray

getMetaData

setDate

setTime

setTimestamp

setNull

setURL

getParameterMetaData

setRowId

setNString

setNCharacterStream

setNClob

setClob

setBlob

setNClob

setSQLXML

setObject

setAsciiStream

setBinaryStream

setCharacterStream

setAsciiStream

setBinaryStream

setCharacterStream

setNCharacterStream

setClob

setBlob

setNClob

setObject

setObject

executeLargeUpdate