NamedParameterStatement (jdbc-util 0.3.3 API)

java.lang.Object
- net.osdn.util.sql.NamedParameterStatement

```
public class NamedParameterStatement
extends java.lang.Object
```
名前付きパラメーターを使用してSQL文を作成するためのユーティリティー・クラスです。
JDBCのPreparedStatementはパラメーターのプレースホルダーとして ? をサポートしていますが、これは名前によるパラメーターの指定をサポートしておらず、? の出現順によってパラメーターを指定する必要があります。一部のデータベース製品のJDBCドライバーには独自に名前付きパラメーターをサポートしているものもありますが、データベース製品固有の方法で名前付きパラメーターを実装しているため、汎用性がなくなります。

このユーティリティークラスは特定のJDBCドライバー実装に依存することなく名前付きパラメーターをサポートします。

NamedParameterStatementではパラメーターのプレースホルダーとして :name という形式を使用します。 :に続く文字列がパラメーター名です。

id列に値を指定してPersonテーブルを取得する場合は以下のようになります。
```
 String sql = "SELECT * FROM Person WHERE id = :id";
 NamedParameterStatement npst = new NamedParameterStatement(sql);
 npst.setInt("id", 3);
 
 PreparedStatement st = cn.prepareStatement(npst.getSql());
 for(NamedParameter parameter : npst.getParameters()) {
     parameter.applyTo(st);
 }
 
 ResultSet rs = st.executeQuery();
 
```
getSql()は名前付きパラメーターのプレースホルダーを名前なしパラメーターのプレースホルダー ? に置き換えたSQL文を返します。そのため、getSql()が返すSQL文はJDBC標準のPreparedStatementを作成するのに使えます。 NamedParameterStatementにパラメーターの値を設定するメソッド(setInt(String, int) など)は第1引数にパラメーターの出現順ではなく、パラメーターの名前を指定することができます。 NamedParameterStatementにパラメーターを設定すると、内部にNamedParameterが作成されます。 NamedParameterはパラメーターの名前と値だけでなくパラメーターの出現順序も保持しています。 NamedParameter.applyTo(PreparedStatement)を呼び出すと、パラメーターの出現順序を使用して PreparedStatementにパラメーターを設定します。
```
 PreparedStatement st = cn.prepareStatement(npst.getSql());
 for(NamedParameter parameter : npst.getParameters()) {
     parameter.applyTo(st);
 }
 
```
このコードは以下のように書くこともできます。
```
 PreparedStatement st = cn.prepareStatement(npst.getSql());
     for(NamedParameter parameter : npst.getParameters()) {
     st.setObject(parameter.getIndex(), parameter.getValue());
 }
 
```
NamedParameterStatementは名前付きパラメーターを持つSQL文から、パラメーターのプレースホルダー ? を使ったJDBC標準のSQL文とパラメーターのプレースホルダー出現順(インデックス)を保持したパラメーターに分解する機能を提供します。これにより任意のPreparedStatemntで名前付きパラメーターを利用できるようになります。 NamedParameterStatementはユーティリティー・クラスであり、実際にデータベースへアクセスするのはJDBCドライバー固有のPreparedStatement実装です。そのため、JDBCドライバー固有のPreparedStatementが持つプリコンパイル機能や最適化が損なわれることもありません。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`NamedParameterStatement(java.lang.String sql)` 指定したSQL文で名前付きパラメーター・ステートメントを作ります。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`void`	`clearParameters()` パラメーターに設定していた値をすべてクリアします。
`int[]`	`getIndexesBy(java.lang.String parameterName)` 指定したパラメーターの出現順を配列で取得します。
`java.lang.String`	`getOriginalSql()` コンストラクタで指定された元のSQL文を取得します。
`java.util.Set<java.lang.String>`	`getParameterNames()` このNamedParameterStatementが持つパラメーター名のセットを取得します。
`NamedParameter[]`	`getParameters()` 設定したパラメーターの値を持つ`NamedParameter`配列を返します。
`java.lang.String`	`getSql()` JDBCで使用するSQL文を取得します。
`void`	`setArray(java.lang.String parameterName, java.sql.Array x)` 指定されたパラメーターを指定されたjava.sql.Arrayオブジェクトに設定します。
`void`	`setAsciiStream(java.lang.String parameterName, java.io.InputStream x)` 指定されたパラメーターを指定された入力ストリームに設定します。
`void`	`setAsciiStream(java.lang.String parameterName, java.io.InputStream x, int length)` 指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
`void`	`setAsciiStream(java.lang.String parameterName, java.io.InputStream x, long length)` 指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
`void`	`setBigDecimal(java.lang.String parameterName, java.math.BigDecimal x)` 指定されたパラメーターを指定されたjava.math.BigDecimal値に設定します。
`void`	`setBinaryStream(java.lang.String parameterName, java.io.InputStream x)` 指定されたパラメーターを指定された入力ストリームに設定します。
`void`	`setBinaryStream(java.lang.String parameterName, java.io.InputStream x, int length)` 指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
`void`	`setBinaryStream(java.lang.String parameterName, java.io.InputStream x, long length)` 指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
`void`	`setBlob(java.lang.String parameterName, java.sql.Blob x)` 指定されたパラメーターを指定されたjava.sql.Blobオブジェクトに設定します。
`void`	`setBlob(java.lang.String parameterName, java.io.InputStream x)` 指定されたパラメーターをInputStreamオブジェクトに設定します。
`void`	`setBlob(java.lang.String parameterName, java.io.InputStream x, long length)` 指定されたパラメーターをInputStreamオブジェクトに設定します。
`void`	`setBoolean(java.lang.String parameterName, boolean x)` 指定されたパラメーターを指定されたJavaのboolean値に設定します。
`void`	`setByte(java.lang.String parameterName, byte x)` 指定されたパラメーターを指定されたJavaのbyte値に設定します。
`void`	`setBytes(java.lang.String parameterName, byte[] x)` 指定されたパラメーターを指定されたJavaのバイト配列に設定します。
`void`	`setCharacterStream(java.lang.String parameterName, java.io.Reader x)` 指定されたパラメーターを指定されたReaderオブジェクトに設定します。
`void`	`setCharacterStream(java.lang.String parameterName, java.io.Reader x, int length)` 指定されたパラメーターを指定された文字数である指定されたReaderオブジェクトに設定します。
`void`	`setCharacterStream(java.lang.String parameterName, java.io.Reader x, long length)` 指定されたパラメーターを指定された文字数である指定されたReaderオブジェクトに設定します。
`void`	`setClob(java.lang.String parameterName, java.sql.Clob x)` 指定されたパラメーターを指定されたjava.sql.Clobオブジェクトに設定します。
`void`	`setClob(java.lang.String parameterName, java.io.Reader x)` 指定されたパラメーターをReaderオブジェクトに設定します。
`void`	`setClob(java.lang.String parameterName, java.io.Reader x, long length)` 指定されたパラメーターをReaderオブジェクトに設定します。
`void`	`setDate(java.lang.String parameterName, java.sql.Date x)` アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメーターを指定されたjava.sql.Date値に設定します。
`void`	`setDate(java.lang.String parameterName, java.sql.Date x, java.util.Calendar calendar)` 指定されたCalendarオブジェクトを使用して、指定されたパラメーターを指定されたjava.sql.Date値に設定します。
`void`	`setDouble(java.lang.String parameterName, double x)` 指定されたパラメーターを指定されたJavaのdouble値に設定します。
`void`	`setFloat(java.lang.String parameterName, float x)` 指定されたパラメーターを指定されたJavaのfloat値に設定します。
`void`	`setInt(java.lang.String parameterName, int x)` 指定されたパラメーターを指定されたJavaのint値に設定します。
`void`	`setLong(java.lang.String parameterName, long x)` 指定されたパラメーターを指定されたJavaのlong値に設定します。
`void`	`setNCharacterStream(java.lang.String parameterName, java.io.Reader x)` 指定されたパラメーターをReaderオブジェクトに設定します。
`void`	`setNCharacterStream(java.lang.String parameterName, java.io.Reader x, long length)` 指定されたパラメーターをReaderオブジェクトに設定します。
`void`	`setNClob(java.lang.String parameterName, java.sql.NClob x)` 指定されたパラメーターをjava.sql.NClobオブジェクトに設定します。
`void`	`setNClob(java.lang.String parameterName, java.io.Reader x)` 指定されたパラメーターをReaderオブジェクトに設定します。
`void`	`setNClob(java.lang.String parameterName, java.io.Reader x, long length)` 指定されたパラメーターをReaderオブジェクトに設定します。
`void`	`setNString(java.lang.String parameterName, java.lang.String x)` 指定されたパラメーターを指定されたStringオブジェクトに設定します。
`void`	`setNull(java.lang.String parameterName, int sqlType)` 指定されたパラメーターをSQL NULLに設定します。
`void`	`setNull(java.lang.String parameterName, int sqlType, java.lang.String typeName)` 指定されたパラメーターをSQL NULLに設定します。
`void`	`setObject(java.lang.String parameterName, java.lang.Object x)` 指定されたパラメーターの値を指定されたオブジェクトを使用して設定します。
`void`	`setObject(java.lang.String parameterName, java.lang.Object x, int targetSqlType)` 指定されたパラメーター値を指定されたオブジェクトで設定します。
`void`	`setObject(java.lang.String parameterName, java.lang.Object x, int targetSqlType, int scaleOrLength)` 指定されたパラメーターの値を指定されたオブジェクトで設定します。
`void`	`setRef(java.lang.String parameterName, java.sql.Ref x)` 指定されたパラメーターを指定されたREF(<structured-type>)値に設定します。
`void`	`setRowId(java.lang.String parameterName, java.sql.RowId x)` 指定されたパラメーターを指定されたjava.sql.RowIdオブジェクトに設定します。
`void`	`setShort(java.lang.String parameterName, short x)` 指定されたパラメーターを指定したJavaのshort値に設定します。
`void`	`setSQLXML(java.lang.String parameterName, java.sql.SQLXML x)` 指定されたパラメーターを指定されたjava.sql.SQLXMLオブジェクトに設定します。
`void`	`setString(java.lang.String parameterName, java.lang.String x)` 指定されたパラメーターを指定されたJavaのString値に設定します。
`void`	`setTime(java.lang.String parameterName, java.sql.Time x)` 指定されたパラメーターを指定されたjava.sql.Time値に設定します。
`void`	`setTime(java.lang.String parameterName, java.sql.Time x, java.util.Calendar calendar)` 指定されたCalendarオブジェクトを使用して、指定されたパラメーターを指定されてjava.sql.Time値に設定します。
`void`	`setTimestamp(java.lang.String parameterName, java.sql.Timestamp x)` 指定されたパラメーターを指定されたjava.sql.Timestamp値に設定します。
`void`	`setTimestamp(java.lang.String parameterName, java.sql.Timestamp x, java.util.Calendar calendar)` 指定されたCalendarオブジェクトを使用して、指定されたパラメーターを指定されたjava.sql.Timestamp値に設定します。
`void`	`setURL(java.lang.String parameterName, java.net.URL x)` 指定されたパラメーターを指定されたjava.net.URL値に設定します。
`java.lang.String`	`toString()` オブジェクトの文字列表現を返します。

クラスから継承されたメソッド java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - NamedParameterStatement
```
public NamedParameterStatement(java.lang.String sql)
```
    指定したSQL文で名前付きパラメーター・ステートメントを作ります。
    パラメーターのプレースホルダーには ? ではなく :name 形式を使用します。
    
    パラメータ:
    
    sql - 名前付きパラーメーターのプレースホルダーを含むSQL文
- メソッドの詳細
  - getOriginalSql
```
public java.lang.String getOriginalSql()
```
    コンストラクタで指定された元のSQL文を取得します。
    このメソッドが返すSQL文は加工されていないため、名前付きパラメーターのプレースホルダー :name を含みます。
    
    戻り値:
    
    コンストラクタで指定された元のSQL文
  - getSql
```
public java.lang.String getSql()
```
    JDBCで使用するSQL文を取得します。
    このメソッドが返すSQL文は名前付きパラメーターのプレースホルダー :name が JDBC標準のパラメーター・プレースホルダー ? に置き換えられています。
    
    戻り値:
    
    パラメーターのプレースホルダーを ? に置き換えたSQL文
  - getParameterNames
```
public java.util.Set<java.lang.String> getParameterNames()
```
    このNamedParameterStatementが持つパラメーター名のセットを取得します。
    "SELECT * FROM Product WHERE category = :category AND price > :price" というSQL文をコンストラクタで指定した場合、このメソッドが返すパラメーター名のセットには "category" と "price" が含まれます。パラメータ名には : は含まれません。
    
    戻り値:
    
    パラメーター名のセット
  - getIndexesBy
```
public int[] getIndexesBy(java.lang.String parameterName)
```
    指定したパラメーターの出現順を配列で取得します。
    このメソッドが返すパラメーターの出現順は0ではなく1から始まります。この値はPreparedStatementのパラメーター指定に使用することができます。
    
    "SELECT * FROM Product WHERE price >= :price AND (flag = :param1 OR (:param1 is null AND flag is null))" というSQL文をコンストラクタで指定した場合、getIndexesBy("param1") は int[] { 2, 3 } を返します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    戻り値:
    
    パラメーターの出現順配列
  - clearParameters
```
public void clearParameters()
```
    パラメーターに設定していた値をすべてクリアします。
  - getParameters
```
public NamedParameter[] getParameters()
```
    設定したパラメーターの値を持つNamedParameter配列を返します。
    
    戻り値:
    
    設定したパラメーターの配列。パラメーターが設定されていない場合はサイズ 0 の配列。null が返されることはありません。
  - setArray
```
public void setArray(java.lang.String parameterName,
                     java.sql.Array x)
```
    指定されたパラメーターを指定されたjava.sql.Arrayオブジェクトに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - SQL ARRAY値をマッピングするArrayオブジェクト
  - setAsciiStream
```
public void setAsciiStream(java.lang.String parameterName,
                           java.io.InputStream x)
```
    指定されたパラメーターを指定された入力ストリームに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - ASCIIパラメーター値を含むJava入力ストリーム
  - setAsciiStream
```
public void setAsciiStream(java.lang.String parameterName,
                           java.io.InputStream x,
                           int length)
```
    指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - ASCIIパラメーター値を含むJava入力ストリーム
    
    length - ストリームのバイト数
  - setAsciiStream
```
public void setAsciiStream(java.lang.String parameterName,
                           java.io.InputStream x,
                           long length)
```
    指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - ASCIIパラメーター値を含むJava入力ストリーム
    
    length - ストリームのバイト数
  - setBigDecimal
```
public void setBigDecimal(java.lang.String parameterName,
                          java.math.BigDecimal x)
```
    指定されたパラメーターを指定されたjava.math.BigDecimal値に設定します。データベースに送るときに、ドライバーはこれを SQL NUMERIC値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setBinaryStream
```
public void setBinaryStream(java.lang.String parameterName,
                            java.io.InputStream x)
```
    指定されたパラメーターを指定された入力ストリームに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - バイナリ・パラメーター値を含むJava入力ストリーム
  - setBinaryStream
```
public void setBinaryStream(java.lang.String parameterName,
                            java.io.InputStream x,
                            int length)
```
    指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - バイナリ・パラメーター値を含むJava入力ストリーム
    
    length - ストリームのバイト数
  - setBinaryStream
```
public void setBinaryStream(java.lang.String parameterName,
                            java.io.InputStream x,
                            long length)
```
    指定されたパラメーターを指定されたバイト数を持つ指定された入力ストリームに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - バイナリ・パラメーター値を含むJava入力ストリーム
    
    length - ストリームのバイト数
  - setBlob
```
public void setBlob(java.lang.String parameterName,
                    java.sql.Blob x)
```
    指定されたパラメーターを指定されたjava.sql.Blobオブジェクトに設定します。データベースに送るときに、ドライバーはこれをSQL BLOB値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - SQL BLOB値をマッピングするBlobオブジェクト
  - setBlob
```
public void setBlob(java.lang.String parameterName,
                    java.io.InputStream x)
```
    指定されたパラメーターをInputStreamオブジェクトに設定します。このメソッドはsetBinaryStream(String, InputStream)メソッドと異なり、パラメーター値をBLOBとしてサーバーに送信するべきであることをドライバーに通知します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーター値に設定されるデータを含むオブジェクト
  - setBlob
```
public void setBlob(java.lang.String parameterName,
                    java.io.InputStream x,
                    long length)
```
    指定されたパラメーターをInputStreamオブジェクトに設定します。ストリームにはlengthで指定される文字数が含まれる必要があります。そうでない場合は、PreparedStatementの実行時にSQLExceptionが生成されます。このメソッドはsetBinaryStream(String, InputStream, int)メソッドと異なり、パラメーター値をBLOBとしてサーバーに送信するべきであることをドライバーに通知します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーター値に設定されるデータを含むオブジェクト
    
    length - パラメーター・データ内のバイト数
  - setBoolean
```
public void setBoolean(java.lang.String parameterName,
                       boolean x)
```
    指定されたパラメーターを指定されたJavaのboolean値に設定します。データベースに送るときに、ドライバーはこれをSQL BITまたはBOOLEAN値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setByte
```
public void setByte(java.lang.String parameterName,
                    byte x)
```
    指定されたパラメーターを指定されたJavaのbyte値に設定します。データベースに送るときに、ドライバーはこれをSQL TINYINT値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setBytes
```
public void setBytes(java.lang.String parameterName,
                     byte[] x)
```
    指定されたパラメーターを指定されたJavaのバイト配列に設定します。データベースに送るときに、ドライバーはこれをSQL VARBINARYまたはLONGVARBINARYに変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setCharacterStream
```
public void setCharacterStream(java.lang.String parameterName,
                               java.io.Reader x)
```
    指定されたパラメーターを指定されたReaderオブジェクトに設定します。 JDBCドライバーはデータをUNICODEからデータベースのchar形式に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - Unicodeを格納するjava.io.Readerオブジェクト
  - setCharacterStream
```
public void setCharacterStream(java.lang.String parameterName,
                               java.io.Reader x,
                               int length)
```
    指定されたパラメーターを指定された文字数である指定されたReaderオブジェクトに設定します。 JDBCドライバーはデータをUNICODEからデータベースのchar形式に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - Unicodeデータを格納するjava.io.Readerオブジェクト
    
    length - ストリーム内の文字数
  - setCharacterStream
```
public void setCharacterStream(java.lang.String parameterName,
                               java.io.Reader x,
                               long length)
```
    指定されたパラメーターを指定された文字数である指定されたReaderオブジェクトに設定します。 JDBCドライバーはデータをUNICODEからデータベースのchar形式に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - Unicodeデータを格納するjava.io.Readerオブジェクト
    
    length - ストリーム内の文字数
  - setClob
```
public void setClob(java.lang.String parameterName,
                    java.sql.Clob x)
```
    指定されたパラメーターを指定されたjava.sql.Clobオブジェクトに設定します。データベースに送るときに、ドライバーはこれをSQL CLOB値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - SQL CLOB値をマッピングするClobオブジェクト
  - setClob
```
public void setClob(java.lang.String parameterName,
                    java.io.Reader x)
```
    指定されたパラメーターをReaderオブジェクトに設定します。このメソッドはsetCharacterStream(String, Reader)メソッドと異なり、パラメーター値をCLOBとしてサーバーに送信するべきであることをドライバーに通知します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーター値に設定されるデータを含むオブジェクト
  - setClob
```
public void setClob(java.lang.String parameterName,
                    java.io.Reader x,
                    long length)
```
    指定されたパラメーターをReaderオブジェクトに設定します。 Reader xにはlengthで指定される文字数が含まれる必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。このメソッドはsetCharacterStream(String, Reader, int)メソッドと異なり、パラメーター値をCLOBとしてサーバーに送信するべきであることをドライバーに通知します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーター値に設定されるデータを含むオブジェクト
    
    length - パラメーター・データ内の文字数
  - setDate
```
public void setDate(java.lang.String parameterName,
                    java.sql.Date x)
```
    アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメーターを指定されたjava.sql.Date値に設定します。データベースに送るときに、ドライバーはこれを SQL DATE値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setDate
```
public void setDate(java.lang.String parameterName,
                    java.sql.Date x,
                    java.util.Calendar calendar)
```
    指定されたCalendarオブジェクトを使用して、指定されたパラメーターを指定されたjava.sql.Date値に設定します。ドライバーはCalendarオブジェクトを使用してSQL DATE値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバーはカスタム・タイムゾーンを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバーはアプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
    
    calendar - ドライバーが日付を作成するために使用するCalendarオブジェクト
  - setDouble
```
public void setDouble(java.lang.String parameterName,
                      double x)
```
    指定されたパラメーターを指定されたJavaのdouble値に設定します。データベースに送るときに、ドライバーはこれをSQL DOUBLE値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setFloat
```
public void setFloat(java.lang.String parameterName,
                     float x)
```
    指定されたパラメーターを指定されたJavaのfloat値に設定します。データベースに送るときに、ドライバーはこれをSQL REAL値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setInt
```
public void setInt(java.lang.String parameterName,
                   int x)
```
    指定されたパラメーターを指定されたJavaのint値に設定します。データベースに送るときに、ドライバーはこれをSQL INTEGER値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setLong
```
public void setLong(java.lang.String parameterName,
                    long x)
```
    指定されたパラメーターを指定されたJavaのlong値に設定します。データベースに送るときに、ドライバーはこれをSQL BIGINT値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setNCharacterStream
```
public void setNCharacterStream(java.lang.String parameterName,
                                java.io.Reader x)
```
    指定されたパラメーターをReaderオブジェクトに設定します。ドライバーは必要に応じて、Javaの文字列表現をデータベース内の各国文字セットに変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setNCharacterStream
```
public void setNCharacterStream(java.lang.String parameterName,
                                java.io.Reader x,
                                long length)
```
    指定されたパラメーターをReaderオブジェクトに設定します。ドライバーは必要に応じて、Javaの文字列表現をデータベース内の各国文字セットに変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
    
    length - パラメーター・データ内の文字数
  - setNClob
```
public void setNClob(java.lang.String parameterName,
                     java.sql.NClob x)
```
    指定されたパラメーターをjava.sql.NClobオブジェクトに設定します。データベースに送るときに、ドライバーはこれをSQL NCLOB値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setNClob
```
public void setNClob(java.lang.String parameterName,
                     java.io.Reader x)
```
    指定されたパラメーターをReaderオブジェクトに設定します。このメソッドは、setCharacterStream(String, Reader)メソッドと異なり、パラメーター値をNCLOBとしてサーバーに送信するべきであることをドライバーに通知します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setNClob
```
public void setNClob(java.lang.String parameterName,
                     java.io.Reader x,
                     long length)
```
    指定されたパラメーターをReaderオブジェクトに設定します。 Reader xにはlengthで指定される文字数が含まれる必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。このメソッドは、setCharacterStream(String, Reader, int)メソッドと異なり、パラメーター値をNCLOBとしてサーバーに送信するべきであることをドライバーに通知します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
    
    length - パラメーター・データ内の文字数
  - setNString
```
public void setNString(java.lang.String parameterName,
                       java.lang.String x)
```
    指定されたパラメーターを指定されたStringオブジェクトに設定します。データベースに送るときに、ドライバーはこれをSQL NCHAR、またはLONGVARCHAR値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setNull
```
public void setNull(java.lang.String parameterName,
                    int sqlType)
```
    指定されたパラメーターをSQL NULLに設定します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    sqlType - java.sql.Typesで定義されるSQL型コード
  - setNull
```
public void setNull(java.lang.String parameterName,
                    int sqlType,
                    java.lang.String typeName)
```
    指定されたパラメーターをSQL NULLに設定します。ユーザー定義型およびREF型のパラメーターでは、このバージョンのsetNullメソッドを使用するべきです。ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    sqlType - java.sql.Typesで定義されるSQL型コード
    
    typeName - SQLユーザー定義型の完全指定の名前。パラメーターがユーザー定義型でもREFでもない場合は無視されます。
  - setObject
```
public void setObject(java.lang.String parameterName,
                      java.lang.Object x)
```
    指定されたパラメーターの値を指定されたオブジェクトを使用して設定します。
    JDBCの仕様では、JavaのObject型からSQL型への標準マッピングを規定しています。指定された引数は、データベースに送られる前に、対応するSQL型に変換されます。
    
    このメソッドは、ドライバー固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用することに注意してください。オブジェクトがインターフェースSQLDataを実装するクラスのインスタンスである場合、 JDBCドライバーはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、RowId、SQLXML、またはArrayを実装するクラスのオブジェクトである場合、ドライバーはこのオブジェクトを対応するSQL型の値としてデータベースに渡すべきです。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - 入力パラメーター値を含むオブジェクト
  - setObject
```
public void setObject(java.lang.String parameterName,
                      java.lang.Object x,
                      int targetSqlType)
```
    指定されたパラメーター値を指定されたオブジェクトで設定します。
    このメソッドは、setObject(String, Object, int, int) に似ていますが、scaleOrLengthに0を仮定している点が異なります。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - 入力パラメーター値を含むオブジェクト
    
    targetSqlType - データベースに送られる(java.sql.Typesで定義される)SQL型
  - setObject
```
public void setObject(java.lang.String parameterName,
                      java.lang.Object x,
                      int targetSqlType,
                      int scaleOrLength)
```
    指定されたパラメーターの値を指定されたオブジェクトで設定します。
    2番目の引数がInputStreamである場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderである場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。そうでない場合は、PreparedStatementの実行時にSQLExceptionが生成されます。
    
    指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインターフェースSQLDataを実装するクラスのインスタンスである場合)、 JDBCドライバーはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバーはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。
    
    このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - 入力パラメーター値を含むオブジェクト
    
    targetSqlType - データベースに送られる(java.sql.Typesで定義される)SQL型。scaleOrLength引数で、さらにこの型を限定できます。
    
    scaleOrLength - java.sql.Types.DECIMALまたはjava.sql.Types.NUMERICの場合、これは小数点のあとの桁数になります。Javaオブジェクト型InputStreamおよびReaderの場合はストリームまたはReaderのデータ長。ほかのすべての型ではこの値は無視されます。
  - setRef
```
public void setRef(java.lang.String parameterName,
                   java.sql.Ref x)
```
    指定されたパラメーターを指定されたREF(<structured-type>)値に設定します。データベースに送るときに、ドライバーはこれをSQL REF値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - SQL REF値
  - setRowId
```
public void setRowId(java.lang.String parameterName,
                     java.sql.RowId x)
```
    指定されたパラメーターを指定されたjava.sql.RowIdオブジェクトに設定します。データベースに送るときに、ドライバーはこれをSQL ROWID値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setShort
```
public void setShort(java.lang.String parameterName,
                     short x)
```
    指定されたパラメーターを指定したJavaのshort値に設定します。データベースに送るときに、ドライバーはこれをSQL SMALLINT値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setSQLXML
```
public void setSQLXML(java.lang.String parameterName,
                      java.sql.SQLXML x)
```
    指定されたパラメーターを指定されたjava.sql.SQLXMLオブジェクトに設定します。データベースに送るときに、ドライバーはこれをSQL XML値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - SQL XML値をマッピングするSQLXMLオブジェクト
  - setString
```
public void setString(java.lang.String parameterName,
                      java.lang.String x)
```
    指定されたパラメーターを指定されたJavaのString値に設定します。データベースに送るときに、ドライバーはこれをSQL VARCHARまたはLONGVARCHAR値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setTime
```
public void setTime(java.lang.String parameterName,
                    java.sql.Time x)
```
    指定されたパラメーターを指定されたjava.sql.Time値に設定します。データベースに送るときに、ドライバーはこれをSQL TIME値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setTime
```
public void setTime(java.lang.String parameterName,
                    java.sql.Time x,
                    java.util.Calendar calendar)
```
    指定されたCalendarオブジェクトを使用して、指定されたパラメーターを指定されてjava.sql.Time値に設定します。ドライバーはCalendarオブジェクトを使用してSQL TIME値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバーはカスタム・タイムゾーンを考慮して時間を計算できます。 Calendarオブジェクトを指定しない場合、ドライバーはアプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
    
    calendar - ドライバーが時間作成するために使用するCalendarオブジェクト
  - setTimestamp
```
public void setTimestamp(java.lang.String parameterName,
                         java.sql.Timestamp x)
```
    指定されたパラメーターを指定されたjava.sql.Timestamp値に設定します。データベースに送るときに、ドライバーはこれをSQL TIMESTAMP値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - setTimestamp
```
public void setTimestamp(java.lang.String parameterName,
                         java.sql.Timestamp x,
                         java.util.Calendar calendar)
```
    指定されたCalendarオブジェクトを使用して、指定されたパラメーターを指定されたjava.sql.Timestamp値に設定します。ドライバーはCalendarオブジェクトを使用してSQL TIMESTAMP値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバーはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。 Calendarオブジェクトを指定しない場合、ドライバーはアプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
    
    calendar - ドライバーがタイムスタンプを作成するために使用するCalendarオブジェクト
  - setURL
```
public void setURL(java.lang.String parameterName,
                   java.net.URL x)
```
    指定されたパラメーターを指定されたjava.net.URL値に設定します。データベースに送るときに、ドライバーはこれをSQL DATALINK値に変換します。
    
    パラメータ:
    
    parameterName - パラメーターの名前
    
    x - パラメーターの値
  - toString
```
public java.lang.String toString()
```
    オブジェクトの文字列表現を返します。このメソッドは、プレースホルダーを設定されたパラメーターで置き換えたSQL文を返します。通常、JDBCドライバーはパラメーターを文字列置換することなくSQLとパラメーターをデータベースに送信します。このメソッドが返すSQL文はデータベースで実行されるSQLとは厳密には一致しないことに注意してください。
    
    オーバーライド:
    
    toString クラス内 java.lang.Object

クラス NamedParameterStatement

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

コンストラクタの詳細

NamedParameterStatement

メソッドの詳細

getOriginalSql

getSql

getParameterNames

getIndexesBy

clearParameters

getParameters

setArray

setAsciiStream

setAsciiStream

setAsciiStream

setBigDecimal

setBinaryStream

setBinaryStream

setBinaryStream

setBlob

setBlob

setBlob

setBoolean

setByte

setBytes

setCharacterStream

setCharacterStream

setCharacterStream

setClob

setClob

setClob

setDate

setDate

setDouble

setFloat

setInt

setLong

setNCharacterStream

setNCharacterStream

setNClob

setNClob

setNClob

setNString

setNull

setNull

setObject

setObject

setObject

setRef

setRowId

setShort

setSQLXML

setString

setTime

setTime

setTimestamp

setTimestamp

setURL

toString