PreparedStatement (Java Platform SE 7)

すべてのスーパーインタフェース:

AutoCloseable, Statement, Wrapper

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

CallableStatement
```
public interface PreparedStatement
extends Statement
```
プリコンパイルされた SQL 文を表すオブジェクトです。
SQL 文は、プリコンパイルされ、PreparedStatement オブジェクトに格納されます。その後、このオブジェクトは、この文を複数回効率的に実行するために使用できます。
注:IN パラメータ値を設定する設定機能メソッド (setShort、setString など) は、入力パラメータの定義された SQL 型と互換のある型を指定する必要があります。たとえば、IN パラメータが INTEGER という SQL 型の場合、setInt メソッドを使用するようにしてください。
任意のパラメータ型変換が必要な場合は、目的の SQL 型を指定して setObject メソッドを使用するようにしてください。
パラメータ設定の例を次に示します。con はアクティブな接続を表します。
```
   PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES
                                     SET SALARY = ? WHERE ID = ?");
   pstmt.setBigDecimal(1, 153833.00)
   pstmt.setInt(2, 110592)
 
```
関連項目:
Connection.prepareStatement(java.lang.String)、ResultSet

フィールドのサマリー
- インタフェース 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 文を実行します。
`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, Blob x)` 指定されたパラメータを指定された `java.sql.Blob` オブジェクトに設定します。
`void`	`setBlob(int parameterIndex, InputStream inputStream)` 指定されたパラメータを `InputStream` オブジェクトに設定します。
`void`	`setBlob(int parameterIndex, InputStream inputStream, long length)` 指定されたパラメータを `InputStream` オブジェクトに設定します。
`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, Clob x)` 指定されたパラメータを指定された `java.sql.Clob` オブジェクトに設定します。
`void`	`setClob(int parameterIndex, Reader reader)` 指定されたパラメータを `Reader` オブジェクトに設定します。
`void`	`setClob(int parameterIndex, Reader reader, long length)` 指定されたパラメータを `Reader` オブジェクトに設定します。
`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, NClob value)` 指定されたパラメータを `java.sql.NClob` オブジェクトに設定します。
`void`	`setNClob(int parameterIndex, Reader reader)` 指定されたパラメータを `Reader` オブジェクトに設定します。
`void`	`setNClob(int parameterIndex, Reader reader, long length)` 指定されたパラメータを `Reader` オブジェクトに設定します。
`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)` 指定されたパラメータの値を、指定されたオブジェクトで設定します。
`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)` 非推奨。
`void`	`setURL(int parameterIndex, URL x)` 指定されたパラメータを、指定された `java.net.URL` 値に設定します。

インタフェース java.sql.Statement から継承されたメソッド
addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, execute, execute, execute, execute, executeBatch, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, 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 - 次で定義される SQL 型コード: java.sql.Types
    
    例外:
    
    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
```
void setUnicodeStream(int parameterIndex,
                    InputStream x,
                    int length)
                      throws SQLException
```
    非推奨。
    
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 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 メソッドに似ていますが、scale に 0 を仮定している点が異なります。
    
    パラメータ:
    parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
    x - 入力パラメータ値を含むオブジェクト
    targetSqlType - データベースに送られる (java.sql.Types で定義される) SQL 型
    
    例外:
    
    SQLException - parameterIndex が SQL 文のパラメータマーカーに対応しない場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた次のもので呼び出された場合: PreparedStatement
    
    SQLFeatureNotSupportedException - targetSqlType のデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、または STRUCT で、JDBC ドライバがこのデータ型をサポートしていない場合
    関連項目:
    Types
  - setObject
```
void setObject(int parameterIndex,
             Object x)
               throws SQLException
```
    指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。2 番目のパラメータは、Object 型である必要があります。したがって、組み込み型の場合、等価な java.lang オブジェクトを使用する必要があります。
    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 文を実行します。PreparedStatement オブジェクトで用意された文には複数の結果を返すものがあります。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 には、length で指定される文字数が含まれる必要があります。そうでない場合、PreparedStatement の実行時に SQLException が生成されます。このメソッドは、setBinaryStream (int, InputStream, int) メソッドと異なり、パラメータ値を BLOB としてサーバーに送信するべきであることをドライバに通知します。setBinaryStream メソッドを使用すると、ドライバは、パラメータデータを LONGVARBINARY と BLOB のどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
    
    パラメータ:
    parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
    inputStream - パラメータ値に設定されるデータを含むオブジェクト
    length - パラメータデータ内のバイト数
    
    例外:
    
    SQLException - parameterIndex が SQL 文のパラメータマーカーに対応しない場合、データベースアクセスエラーが発生した場合、このメソッドがクローズされた PreparedStatement で呼び出された場合、指定された length が 0 より小さい場合、または inputStream 内のバイト数が指定された length に一致しない場合。
    
    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 番目の引数は、オブジェクト型である必要があります。整数値の場合は、等価な java.lang オブジェクトを使用する必要があります。 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 - targetSqlType のデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、または STRUCT で、JDBC ドライバがこのデータ型をサポートしていない場合
    導入されたバージョン:
    
    1.6
    
    関連項目:
    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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース 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