モジュール java.sql
パッケージ java.sql

インタフェースCallableStatement

すべてのスーパー・インタフェース:
AutoCloseable, PreparedStatement, Statement, Wrapper
public interface CallableStatement extends PreparedStatement
SQLストアド・プロシージャを実行するのに使用されるインタフェースです。 JDBC APIは、ストアド・プロシージャSQLエスケープ構文を提供します。これにより、すべてのRDBMSに対し標準の方法でストアド・プロシージャを呼び出せます。 このエスケープ構文には、結果パラメータを含めるものと含めないものとがあります。 結果パラメータを使用する場合、結果パラメータをOUTパラメータとして登録しなければいけません。 その他のパラメータは、入力または出力、あるいはその両方に対して使用できます。 パラメータは、番号により順番に参照されます。最初のパラメータは1です。 
   {?= call <procedure-name>[(<arg1>,<arg2>, ...)]}
   {call <procedure-name>[(<arg1>,<arg2>, ...)]}

INパラメータ値は、PreparedStatementから継承したsetメソッドを使用して設定されます。 すべてのOUTパラメータの型はストアド・プロシージャの実行前に登録する必要があります。実行後に、それらの値は、ここで提供されるgetメソッド経由で取り出されます。

CallableStatementは1つのResultSetオブジェクトまたは複数のResultSetオブジェクトを返すことができます。 複数のResultSetオブジェクトは、Statementから継承した操作を使用して処理されます。

移植性を高めるため、出力パラメータを取得する前に、呼出しのResultSetオブジェクトと更新カウントを処理するようにします。

導入されたバージョン:
1.1
関連項目:
Connection.prepareCall(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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Array
    getArray​(int parameterIndex)
    指定されたJDBC ARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。
    Array
    getArray​(String parameterName)
    JDBC ARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。
    BigDecimal
    getBigDecimal​(int parameterIndex)
    指定されたJDBC NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。
    BigDecimal
    getBigDecimal​(int parameterIndex, int scale)
    非推奨。
    getBigDecimal(int parameterIndex)またはgetBigDecimal(String parameterName)を使用します。
    BigDecimal
    getBigDecimal​(String parameterName)
    JDBC NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。
    Blob
    getBlob​(int parameterIndex)
    指定されたJDBC BLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。
    Blob
    getBlob​(String parameterName)
    JDBC BLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。
    boolean
    getBoolean​(int parameterIndex)
    指定されたJDBC BITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。
    boolean
    getBoolean​(String parameterName)
    JDBC BITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。
    byte
    getByte​(int parameterIndex)
    指定されたJDBC TINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。
    byte
    getByte​(String parameterName)
    JDBC TINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。
    byte[]
    getBytes​(int parameterIndex)
    指定されたJDBC BINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。
    byte[]
    getBytes​(String parameterName)
    JDBC BINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。
    Reader
    getCharacterStream​(int parameterIndex)
    指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。
    Reader
    getCharacterStream​(String parameterName)
    指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。
    Clob
    getClob​(int parameterIndex)
    指定されたJDBC CLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。
    Clob
    getClob​(String parameterName)
    JDBC CLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。
    Date
    getDate​(int parameterIndex)
    指定されたJDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。
    Date
    getDate​(int parameterIndex, Calendar cal)
    指定されたJDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。
    Date
    getDate​(String parameterName)
    JDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。
    Date
    getDate​(String parameterName, Calendar cal)
    JDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。
    double
    getDouble​(int parameterIndex)
    指定されたJDBC DOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。
    double
    getDouble​(String parameterName)
    JDBC DOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。
    float
    getFloat​(int parameterIndex)
    指定されたJDBC FLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。
    float
    getFloat​(String parameterName)
    JDBC FLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。
    int
    getInt​(int parameterIndex)
    指定されたJDBC INTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。
    int
    getInt​(String parameterName)
    JDBC INTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。
    long
    getLong​(int parameterIndex)
    指定されたJDBC BIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。
    long
    getLong​(String parameterName)
    JDBC BIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。
    Reader
    getNCharacterStream​(int parameterIndex)
    指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。
    Reader
    getNCharacterStream​(String parameterName)
    指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。
    NClob
    getNClob​(int parameterIndex)
    指定されたJDBC NCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。
    NClob
    getNClob​(String parameterName)
    JDBC NCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。
    String
    getNString​(int parameterIndex)
    指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
    String
    getNString​(String parameterName)
    指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
    Object
    getObject​(int parameterIndex)
    指定されたパラメータの値をJavaプログラミング言語のObjectとして取り出します。
    <T> T
    getObject​(int parameterIndex, Class<T> type)
    OUTパラメータparameterIndexの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。
    Object
    getObject​(int parameterIndex, Map<String,​Class<?>> map)
    OUTパラメータparameterIndexの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。
    Object
    getObject​(String parameterName)
    パラメータの値をJavaプログラミング言語のObjectとして取り出します。
    <T> T
    getObject​(String parameterName, Class<T> type)
    OUTパラメータparameterNameの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。
    Object
    getObject​(String parameterName, Map<String,​Class<?>> map)
    OUTパラメータparameterNameの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。
    Ref
    getRef​(int parameterIndex)
    指定されたJDBC REF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。
    Ref
    getRef​(String parameterName)
    JDBC REF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。
    RowId
    getRowId​(int parameterIndex)
    指定されたJDBC ROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。
    RowId
    getRowId​(String parameterName)
    指定されたJDBC ROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。
    short
    getShort​(int parameterIndex)
    指定されたJDBC SMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。
    short
    getShort​(String parameterName)
    JDBC SMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。
    SQLXML
    getSQLXML​(int parameterIndex)
    指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。
    SQLXML
    getSQLXML​(String parameterName)
    指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。
    String
    getString​(int parameterIndex)
    指定されたJDBC CHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
    String
    getString​(String parameterName)
    JDBC CHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
    Time
    getTime​(int parameterIndex)
    指定されたJDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。
    Time
    getTime​(int parameterIndex, Calendar cal)
    指定されたJDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。
    Time
    getTime​(String parameterName)
    JDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。
    Time
    getTime​(String parameterName, Calendar cal)
    JDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。
    Timestamp
    getTimestamp​(int parameterIndex)
    指定されたJDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。
    Timestamp
    getTimestamp​(int parameterIndex, Calendar cal)
    指定されたJDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。
    Timestamp
    getTimestamp​(String parameterName)
    JDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。
    Timestamp
    getTimestamp​(String parameterName, Calendar cal)
    JDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。
    URL
    getURL​(int parameterIndex)
    指定されたJDBC DATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。
    URL
    getURL​(String parameterName)
    JDBC DATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。
    void
    registerOutParameter​(int parameterIndex, int sqlType)
    順番parameterIndexのOUTパラメータをJDBC型sqlTypeとして登録します。
    void
    registerOutParameter​(int parameterIndex, int sqlType, int scale)
    順番parameterIndexのパラメータをJDBC型sqlTypeとして登録します。
    void
    registerOutParameter​(int parameterIndex, int sqlType, String typeName)
    指定された出力パラメータを登録します。
    default void
    registerOutParameter​(int parameterIndex, SQLType sqlType)
    順番parameterIndexのOUTパラメータをJDBC型sqlTypeとして登録します。
    default void
    registerOutParameter​(int parameterIndex, SQLType sqlType, int scale)
    順番parameterIndexのパラメータをJDBC型sqlTypeとして登録します。
    default void
    registerOutParameter​(int parameterIndex, SQLType sqlType, String typeName)
    指定された出力パラメータを登録します。
    void
    registerOutParameter​(String parameterName, int sqlType)
    parameterNameという名前のOUTパラメータをJDBC型sqlTypeとして登録します。
    void
    registerOutParameter​(String parameterName, int sqlType, int scale)
    parameterNameという名前のパラメータをJDBC型sqlTypeとして登録します。
    void
    registerOutParameter​(String parameterName, int sqlType, String typeName)
    指定された出力パラメータを登録します。
    default void
    registerOutParameter​(String parameterName, SQLType sqlType)
    parameterNameという名前のOUTパラメータをJDBC型sqlTypeとして登録します。
    default void
    registerOutParameter​(String parameterName, SQLType sqlType, int scale)
    parameterNameという名前のパラメータをJDBC型sqlTypeとして登録します。
    default void
    registerOutParameter​(String parameterName, SQLType sqlType, String typeName)
    指定された出力パラメータを登録します。
    void
    setAsciiStream​(String parameterName, InputStream x)
    指定されたパラメータを指定された入力ストリームに設定します。
    void
    setAsciiStream​(String parameterName, InputStream x, int length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setAsciiStream​(String parameterName, InputStream x, long length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setBigDecimal​(String parameterName, BigDecimal x)
    指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。
    void
    setBinaryStream​(String parameterName, InputStream x)
    指定されたパラメータを指定された入力ストリームに設定します。
    void
    setBinaryStream​(String parameterName, InputStream x, int length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setBinaryStream​(String parameterName, InputStream x, long length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setBlob​(String parameterName, InputStream inputStream)
    指定されたパラメータをInputStreamオブジェクトに設定します。
    void
    setBlob​(String parameterName, InputStream inputStream, long length)
    指定されたパラメータをInputStreamオブジェクトに設定します。
    void
    setBlob​(String parameterName, Blob x)
    指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。
    void
    setBoolean​(String parameterName, boolean x)
    指定されたパラメータを指定されたJavaのboolean値に設定します。
    void
    setByte​(String parameterName, byte x)
    指定されたパラメータを指定されたJavaのbyte値に設定します。
    void
    setBytes​(String parameterName, byte[] x)
    指定されたパラメータを指定されたJavaのバイト配列に設定します。
    void
    setCharacterStream​(String parameterName, Reader reader)
    指定されたパラメータを指定されたReaderオブジェクトに設定します。
    void
    setCharacterStream​(String parameterName, Reader reader, int length)
    指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。
    void
    setCharacterStream​(String parameterName, Reader reader, long length)
    指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。
    void
    setClob​(String parameterName, Reader reader)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setClob​(String parameterName, Reader reader, long length)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setClob​(String parameterName, Clob x)
    指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。
    void
    setDate​(String parameterName, Date x)
    アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。
    void
    setDate​(String parameterName, Date x, Calendar cal)
    指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。
    void
    setDouble​(String parameterName, double x)
    指定されたパラメータを指定されたJavaのdouble値に設定します。
    void
    setFloat​(String parameterName, float x)
    指定されたパラメータを指定されたJavaのfloat値に設定します。
    void
    setInt​(String parameterName, int x)
    指定されたパラメータを指定されたJavaのint値に設定します。
    void
    setLong​(String parameterName, long x)
    指定されたパラメータを指定されたJavaのlong値に設定します。
    void
    setNCharacterStream​(String parameterName, Reader value)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNCharacterStream​(String parameterName, Reader value, long length)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNClob​(String parameterName, Reader reader)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNClob​(String parameterName, Reader reader, long length)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNClob​(String parameterName, NClob value)
    指定されたパラメータをjava.sql.NClobオブジェクトに設定します。
    void
    setNString​(String parameterName, String value)
    指定されたパラメータを指定されたStringオブジェクトに設定します。
    void
    setNull​(String parameterName, int sqlType)
    指定されたパラメータをSQL NULLに設定します。
    void
    setNull​(String parameterName, int sqlType, String typeName)
    指定されたパラメータをSQL NULLに設定します。
    void
    setObject​(String parameterName, Object x)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    void
    setObject​(String parameterName, Object x, int targetSqlType)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    void
    setObject​(String parameterName, Object x, int targetSqlType, int scale)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    default void
    setObject​(String parameterName, Object x, SQLType targetSqlType)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    default void
    setObject​(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    void
    setRowId​(String parameterName, RowId x)
    指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。
    void
    setShort​(String parameterName, short x)
    指定されたパラメータを指定されたJavaのshort値に設定します。
    void
    setSQLXML​(String parameterName, SQLXML xmlObject)
    指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。
    void
    setString​(String parameterName, String x)
    指定されたパラメータを指定されたJavaのString値に設定します。
    void
    setTime​(String parameterName, Time x)
    指定されたパラメータを、指定されたjava.sql.Time値に設定します。
    void
    setTime​(String parameterName, Time x, Calendar cal)
    指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。
    void
    setTimestamp​(String parameterName, Timestamp x)
    指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。
    void
    setTimestamp​(String parameterName, Timestamp x, Calendar cal)
    指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。
    void
    setURL​(String parameterName, URL val)
    指定されたパラメータを指定されたjava.net.URLオブジェクトに設定します。
    boolean
    wasNull()
    最後に読み込まれたOUTパラメータの値がSQL NULLかどうかを取得します。

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

    addBatch, clearParameters, execute, executeLargeUpdate, executeQuery, executeUpdate, getMetaData, getParameterMetaData, 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, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL

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

  • メソッドの詳細

    • registerOutParameter

      void registerOutParameter​(int parameterIndex, int sqlType) throws SQLException
      順番parameterIndexのOUTパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlTypeはjava.sql.Types.OTHERでなければいけません。 getObject(int)メソッドはその値を取り出します。

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      sqlType - java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合
      関連項目:
      Types

    • registerOutParameter

      void registerOutParameter​(int parameterIndex, int sqlType, int scale) throws SQLException
      順番parameterIndexのパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      パラメータがJDBCの型NUMERICまたはDECIMALの場合は、このバージョンのregisterOutParameterを使用しなければいけません。

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      sqlType - java.sql.Typesによって定義されるSQL型のコード。
      scale - 希望の小数点以下の桁数。 0以上の数値を指定する
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合
      関連項目:
      Types

    • wasNull

      boolean wasNull() throws SQLException
      最後に読み込まれたOUTパラメータの値がSQL NULLかどうかを取得します。 このメソッドを呼び出すのは、読込み用メソッドの呼出しのあとでなければいけません。そうでない場合は、nullかどうかを判別するために使用する値がありません。
      戻り値:
      最後に読み込まれたパラメータがSQL NULLの場合はtrue、そうでない場合はfalse
      例外:
      SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

    • getString

      String getString​(int parameterIndex) throws SQLException
      指定されたJDBC CHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。

      固定長の型のJDBC CHARの場合、返されるStringオブジェクトはデータベースでSQL CHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setString(java.lang.String, java.lang.String)

    • getBoolean

      boolean getBoolean​(int parameterIndex) throws SQLException
      指定されたJDBC BITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合はfalse
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setBoolean(java.lang.String, boolean)

    • getByte

      byte getByte​(int parameterIndex) throws SQLException
      指定されたJDBC TINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setByte(java.lang.String, byte)

    • getShort

      short getShort​(int parameterIndex) throws SQLException
      指定されたJDBC SMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setShort(java.lang.String, short)

    • getInt

      int getInt​(int parameterIndex) throws SQLException
      指定されたJDBC INTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setInt(java.lang.String, int)

    • getLong

      long getLong​(int parameterIndex) throws SQLException
      指定されたJDBC BIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setLong(java.lang.String, long)

    • getFloat

      float getFloat​(int parameterIndex) throws SQLException
      指定されたJDBC FLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setFloat(java.lang.String, float)

    • getDouble

      double getDouble​(int parameterIndex) throws SQLException
      指定されたJDBC DOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setDouble(java.lang.String, double)

    • getBigDecimal

      @Deprecated(since="1.2")BigDecimal getBigDecimal​(int parameterIndex, int scale) throws SQLException
      非推奨。
      getBigDecimal(int parameterIndex)またはgetBigDecimal(String parameterName)を使用します。
      指定されたJDBC NUMERICパラメータの値を、scaleで指定された小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      scale - 小数点以下の桁数
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      関連項目:
      setBigDecimal(java.lang.String, java.math.BigDecimal)

    • getBytes

      byte[] getBytes​(int parameterIndex) throws SQLException
      指定されたJDBC BINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setBytes(java.lang.String, byte[])

    • getDate

      Date getDate​(int parameterIndex) throws SQLException
      指定されたJDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setDate(java.lang.String, java.sql.Date)

    • getTime

      Time getTime​(int parameterIndex) throws SQLException
      指定されたJDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setTime(java.lang.String, java.sql.Time)

    • getTimestamp

      Timestamp getTimestamp​(int parameterIndex) throws SQLException
      指定されたJDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      setTimestamp(java.lang.String, java.sql.Timestamp)

    • getObject

      Object getObject​(int parameterIndex) throws SQLException
      指定されたパラメータの値をJavaプログラミング言語のObjectとして取り出します。 値がSQL NULLの場合、ドライバはJava nullを返します。

      このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。 ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      OUTパラメータ値を保持するjava.lang.Object
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      関連項目:
      Types、setObject(java.lang.String, java.lang.Object, int, int)

    • getBigDecimal

      BigDecimal getBigDecimal​(int parameterIndex) throws SQLException
      指定されたJDBC NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      パラメータ値(全精度)。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      導入されたバージョン:
      1.2
      関連項目:
      setBigDecimal(java.lang.String, java.math.BigDecimal)

    • getObject

      Object getObject​(int parameterIndex, Map<String,​Class<?>> map) throws SQLException
      OUTパラメータparameterIndexの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。

      このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。 ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      map - SQLの型名からJavaクラスへのマッピング
      戻り値:
      OUTパラメータ値を保持するjava.lang.Object
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2
      関連項目:
      setObject(java.lang.String, java.lang.Object, int, int)

    • getRef

      Ref getRef​(int parameterIndex) throws SQLException
      指定されたJDBC REF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      Javaプログラミング言語のRefオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • getBlob

      Blob getBlob​(int parameterIndex) throws SQLException
      指定されたJDBC BLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      Javaプログラミング言語のBlobオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • getClob

      Clob getClob​(int parameterIndex) throws SQLException
      指定されたJDBC CLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      Javaプログラミング言語のClobオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • getArray

      Array getArray​(int parameterIndex) throws SQLException
      指定されたJDBC ARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      Javaプログラミング言語のArrayオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • getDate

      Date getDate​(int parameterIndex, Calendar cal) throws SQLException
      指定されたJDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      cal - ドライバが日付を作成するために使用するCalendarオブジェクト
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      導入されたバージョン:
      1.2
      関連項目:
      setDate(java.lang.String, java.sql.Date)

    • getTime

      Time getTime​(int parameterIndex, Calendar cal) throws SQLException
      指定されたJDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して時間を計算できます。 Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      cal - ドライバが時間を作成するために使用するCalendarオブジェクト
      戻り値:
      パラメータ値。値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      導入されたバージョン:
      1.2
      関連項目:
      setTime(java.lang.String, java.sql.Time)

    • getTimestamp

      Timestamp getTimestamp​(int parameterIndex, Calendar cal) throws SQLException
      指定されたJDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮してタイムスタンプを計算できます。 Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      cal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      導入されたバージョン:
      1.2
      関連項目:
      setTimestamp(java.lang.String, java.sql.Timestamp)

    • registerOutParameter

      void registerOutParameter​(int parameterIndex, int sqlType, String typeName) throws SQLException
      指定された出力パラメータを登録します。 ユーザー定義出力パラメータまたはREF出力パラメータには、このバージョンのregisterOutParameterメソッドを使用します。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。

      ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。一方、REFパラメータの場合は、参照する型の完全指定型名を指定する必要があります。 型コードや型名の情報を必要としないJDBCドライバはそれを無視します。 ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREFパラメータに対し、これらの値を提供する必要があります。 このメソッドは、ユーザー定義パラメータとREFパラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。 パラメータがユーザー定義の型またはREF型を持たない場合、typeNameパラメータは無視されます。

      ノート: 出力パラメータの値を読み込むときには、そのパラメータの登録済みSQL型に対応するJava型用の取得メソッドを使用する必要があります。

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      sqlType - Typesからの値
      typeName - SQL構造化型の完全指定された名前
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合
      導入されたバージョン:
      1.2
      関連項目:
      Types

    • registerOutParameter

      void registerOutParameter​(String parameterName, int sqlType) throws SQLException
      parameterNameという名前のOUTパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlTypeはjava.sql.Types.OTHERでなければいけません。 getObject(int)メソッドはその値を取り出します。

      パラメータ:
      parameterName - パラメータの名前
      sqlType - java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合
      導入されたバージョン:
      1.4
      関連項目:
      Types

    • registerOutParameter

      void registerOutParameter​(String parameterName, int sqlType, int scale) throws SQLException
      parameterNameという名前のパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      パラメータがJDBCの型NUMERICまたはDECIMALの場合は、このバージョンのregisterOutParameterを使用しなければいけません。

      パラメータ:
      parameterName - パラメータの名前
      sqlType - java.sql.Typesによって定義されるSQL型のコード。
      scale - 希望の小数点以下の桁数。 0以上の数値を指定する
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合
      導入されたバージョン:
      1.4
      関連項目:
      Types

    • registerOutParameter

      void registerOutParameter​(String parameterName, int sqlType, String typeName) throws SQLException
      指定された出力パラメータを登録します。 ユーザー定義出力パラメータまたはREF出力パラメータには、このバージョンのregisterOutParameterメソッドを使用します。 ユーザー定義型の例としては、STRUCT、DISTINCT、JAVA_OBJECT、名前付き配列などが挙げられます。

      ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。REFパラメータの場合は、参照する型の完全指定型名を指定する必要があります。 型コードや型名の情報を必要としないJDBCドライバはそれを無視します。 ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREFパラメータに対し、これらの値を提供する必要があります。 このメソッドは、ユーザー定義パラメータおよびREFパラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。 パラメータの型がユーザー定義型、REF型のいずれでもない場合、typeNameパラメータは無視されます。

      ノート: 出力パラメータの値を読み込むときには、Javaの型XXXがパラメータの登録されているSQLの型に対応するgetXXXメソッドを使用する必要があります。

      パラメータ:
      parameterName - パラメータの名前
      sqlType - Typesからの値
      typeName - SQL構造化型の完全指定された名前
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合
      導入されたバージョン:
      1.4
      関連項目:
      Types

    • getURL

      URL getURL​(int parameterIndex) throws SQLException
      指定されたJDBC DATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      戻り値:
      指定されたパラメータとして使用されるJDBC DATALINK値を表すjava.net.URLオブジェクト。
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、または返されるURLがJavaプラットフォームで有効なURLではない場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setURL(java.lang.String, java.net.URL)

    • setURL

      void setURL​(String parameterName, URL val) throws SQLException
      指定されたパラメータを指定されたjava.net.URLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL DATALINK値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      val - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、またはURLが無効の場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getURL(int)

    • setNull

      void setNull​(String parameterName, int sqlType) throws SQLException
      指定されたパラメータをSQL NULLに設定します。

      ノート: パラメータのSQLの型を指定する必要があります。

      パラメータ:
      parameterName - パラメータの名前
      sqlType - java.sql.Typesで定義されるSQL型コード
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • setBoolean

      void setBoolean​(String parameterName, boolean x) throws SQLException
      指定されたパラメータを指定されたJavaのboolean値に設定します。 データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getBoolean(int)

    • setByte

      void setByte​(String parameterName, byte x) throws SQLException
      指定されたパラメータを指定されたJavaのbyte値に設定します。 データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getByte(int)

    • setShort

      void setShort​(String parameterName, short x) throws SQLException
      指定されたパラメータを指定されたJavaのshort値に設定します。 データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getShort(int)

    • setInt

      void setInt​(String parameterName, int x) throws SQLException
      指定されたパラメータを指定されたJavaのint値に設定します。 データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getInt(int)

    • setLong

      void setLong​(String parameterName, long x) throws SQLException
      指定されたパラメータを指定されたJavaのlong値に設定します。 データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getLong(int)

    • setFloat

      void setFloat​(String parameterName, float x) throws SQLException
      指定されたパラメータを指定されたJavaのfloat値に設定します。 データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getFloat(int)

    • setDouble

      void setDouble​(String parameterName, double x) throws SQLException
      指定されたパラメータを指定されたJavaのdouble値に設定します。 データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getDouble(int)

    • setBigDecimal

      void setBigDecimal​(String parameterName, BigDecimal x) throws SQLException
      指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。 データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getBigDecimal(int, int)

    • setString

      void setString​(String parameterName, String x) throws SQLException
      指定されたパラメータを指定されたJavaのString値に設定します。 データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getString(int)

    • setBytes

      void setBytes​(String parameterName, byte[] x) throws SQLException
      指定されたパラメータを指定されたJavaのバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQL VARBINARYまたはLONGVARBINARY (ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getBytes(int)

    • setDate

      void setDate​(String parameterName, Date x) throws SQLException
      アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 データベースに送るときに、ドライバはこれをSQL DATE値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getDate(int)

    • setTime

      void setTime​(String parameterName, Time x) throws SQLException
      指定されたパラメータを、指定されたjava.sql.Time値に設定します。 データベースに送るときに、ドライバはこれをSQL TIME値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getTime(int)

    • setTimestamp

      void setTimestamp​(String parameterName, Timestamp x) throws SQLException
      指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getTimestamp(int)

    • setAsciiStream

      void setAsciiStream​(String parameterName, InputStream x, int length) throws SQLException
      指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      パラメータ:
      parameterName - パラメータの名前
      x - ASCIIパラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • setBinaryStream

      void setBinaryStream​(String parameterName, InputStream x, int length) throws SQLException
      指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      パラメータ:
      parameterName - パラメータの名前
      x - バイナリ・パラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • setObject

      void setObject​(String parameterName, Object x, int targetSqlType, int scale) throws 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型。 scale引数で、さらにこの型を限定できる。
      scale - java.sql.Types.DECIMALやjava.sql.Types.NUMERIC型では、小数点以下の桁数。 ほかのすべての型では、この値は無視される。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      Types、getObject(int)

    • setObject

      void setObject​(String parameterName, Object x, int targetSqlType) throws SQLException
      指定されたパラメータの値を、指定されたオブジェクトで設定します。 このメソッドは、setObject(String parameterName, Object x, int targetSqlType, int scaleOrLength)に似ていますが、scaleに0を仮定している点が異なります。
      パラメータ:
      parameterName - パラメータの名前
      x - 入力パラメータ値を含むオブジェクト
      targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getObject(int)

    • setObject

      void setObject​(String parameterName, Object x) throws SQLException
      指定されたパラメータの値を、指定されたオブジェクトで設定します。

      JDBCの仕様では、JavaのObject型からSQL型への標準マッピングを規定しています。 指定された引数は、データベースに送られる前に、対応するSQL型に変換されます。

      このメソッドは、ドライバ固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用できます。 オブジェクトがインタフェースSQLDataを実装するクラスのインスタンスである場合、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。

      たとえば、オブジェクトが上記のインタフェースを複数実装するクラスであるなど、あいまいさがある場合、このメソッドは例外をスローします。

      ノート: すべてのデータベースで、バックエンドに対する型のないNullの送信が許可されるわけではありません。 移植性を最大限にするには、setObject(String parameterName, Object x)の代わりにsetNullメソッドまたはsetObject(String parameterName, Object x, int sqlType)メソッドを使用しなければいけません。

      パラメータ:
      parameterName - パラメータの名前
      x - 入力パラメータ値を含むオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、または指定されたObjectパラメータがあいまいな場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getObject(int)

    • setCharacterStream

      void setCharacterStream​(String parameterName, Reader reader, int length) throws SQLException
      指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      パラメータ:
      parameterName - パラメータの名前
      reader - 指定されたパラメータとして使用されるUNICODEデータを含むjava.io.Readerオブジェクト
      length - ストリーム内の文字数
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • setDate

      void setDate​(String parameterName, Date x, Calendar cal) throws SQLException
      指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 ドライバはCalendarオブジェクトを使用してSQL DATE値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      cal - ドライバが日付を作成するために使用するCalendarオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getDate(int)

    • setTime

      void setTime​(String parameterName, Time x, Calendar cal) throws SQLException
      指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。 ドライバはCalendarオブジェクトを使用してSQL TIME値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して時間を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      cal - ドライバが時間を作成するために使用するCalendarオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getTime(int)

    • setTimestamp

      void setTimestamp​(String parameterName, Timestamp x, Calendar cal) throws SQLException
      指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。 ドライバはCalendarオブジェクトを使用してSQL TIMESTAMP値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      cal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      getTimestamp(int)

    • setNull

      void setNull​(String parameterName, int sqlType, String typeName) throws SQLException
      指定されたパラメータをSQL NULLに設定します。 ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用するべきです。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。

      ノート: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全修飾SQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。 REFパラメータの場合、名前は参照される型の型名です。

      ユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 パラメータがユーザー定義の型またはREF型を持たない場合、指定されたtypeNameは無視されます。

      パラメータ:
      parameterName - パラメータの名前
      sqlType - java.sql.Typesからの値
      typeName - SQLユーザー定義型の完全修飾名。パラメータがユーザー定義型でもSQL REF値でもない場合は無視される
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • getString

      String getString​(String parameterName) throws SQLException
      JDBC CHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。

      固定長の型のJDBC CHARの場合、返されるStringオブジェクトはデータベースでSQL CHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。

      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setString(java.lang.String, java.lang.String)

    • getBoolean

      boolean getBoolean​(String parameterName) throws SQLException
      JDBC BITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合はfalse
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setBoolean(java.lang.String, boolean)

    • getByte

      byte getByte​(String parameterName) throws SQLException
      JDBC TINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setByte(java.lang.String, byte)

    • getShort

      short getShort​(String parameterName) throws SQLException
      JDBC SMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setShort(java.lang.String, short)

    • getInt

      int getInt​(String parameterName) throws SQLException
      JDBC INTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setInt(java.lang.String, int)

    • getLong

      long getLong​(String parameterName) throws SQLException
      JDBC BIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setLong(java.lang.String, long)

    • getFloat

      float getFloat​(String parameterName) throws SQLException
      JDBC FLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setFloat(java.lang.String, float)

    • getDouble

      double getDouble​(String parameterName) throws SQLException
      JDBC DOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合は0
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setDouble(java.lang.String, double)

    • getBytes

      byte[] getBytes​(String parameterName) throws SQLException
      JDBC BINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setBytes(java.lang.String, byte[])

    • getDate

      Date getDate​(String parameterName) throws SQLException
      JDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setDate(java.lang.String, java.sql.Date)

    • getTime

      Time getTime​(String parameterName) throws SQLException
      JDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setTime(java.lang.String, java.sql.Time)

    • getTimestamp

      Timestamp getTimestamp​(String parameterName) throws SQLException
      JDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setTimestamp(java.lang.String, java.sql.Timestamp)

    • getObject

      Object getObject​(String parameterName) throws SQLException
      パラメータの値をJavaプログラミング言語のObjectとして取り出します。 値がSQL NULLの場合、ドライバはJava nullを返します。

      このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。 ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。

      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      OUTパラメータ値を保持するjava.lang.Object。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      Types、setObject(java.lang.String, java.lang.Object, int, int)

    • getBigDecimal

      BigDecimal getBigDecimal​(String parameterName) throws SQLException
      JDBC NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値(全精度)。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setBigDecimal(java.lang.String, java.math.BigDecimal)

    • getObject

      Object getObject​(String parameterName, Map<String,​Class<?>> map) throws SQLException
      OUTパラメータparameterNameの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。

      このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。 ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。

      パラメータ:
      parameterName - パラメータの名前
      map - SQLの型名からJavaクラスへのマッピング
      戻り値:
      OUTパラメータ値を保持するjava.lang.Object
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setObject(java.lang.String, java.lang.Object, int, int)

    • getRef

      Ref getRef​(String parameterName) throws SQLException
      JDBC REF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      Javaプログラミング言語のRefオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • getBlob

      Blob getBlob​(String parameterName) throws SQLException
      JDBC BLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      Javaプログラミング言語のBlobオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • getClob

      Clob getClob​(String parameterName) throws SQLException
      JDBC CLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      Javaプログラミング言語のClobオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • getArray

      Array getArray​(String parameterName) throws SQLException
      JDBC ARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      Javaプログラミング言語のArrayオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • getDate

      Date getDate​(String parameterName, Calendar cal) throws SQLException
      JDBC DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。
      パラメータ:
      parameterName - パラメータの名前
      cal - ドライバが日付を作成するために使用するCalendarオブジェクト
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setDate(java.lang.String, java.sql.Date)

    • getTime

      Time getTime​(String parameterName, Calendar cal) throws SQLException
      JDBC TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して時間を計算できます。 Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。
      パラメータ:
      parameterName - パラメータの名前
      cal - ドライバが時間を作成するために使用するCalendarオブジェクト
      戻り値:
      パラメータ値。値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setTime(java.lang.String, java.sql.Time)

    • getTimestamp

      Timestamp getTimestamp​(String parameterName, Calendar cal) throws SQLException
      JDBC TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮してタイムスタンプを計算できます。 Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。
      パラメータ:
      parameterName - パラメータの名前
      cal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト
      戻り値:
      パラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setTimestamp(java.lang.String, java.sql.Timestamp)

    • getURL

      URL getURL​(String parameterName) throws SQLException
      JDBC DATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      Javaプログラミング言語のjava.net.URLオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、またはURLに問題がある場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4
      関連項目:
      setURL(java.lang.String, java.net.URL)

    • getRowId

      RowId getRowId​(int parameterIndex) throws SQLException
      指定されたJDBC ROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      戻り値:
      指定されたパラメータとして使用されるJDBC ROWID値を表すRowIdオブジェクト。 パラメータにSQL NULLを含む場合、null値が返される
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getRowId

      RowId getRowId​(String parameterName) throws SQLException
      指定されたJDBC ROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      指定されたパラメータとして使用されるJDBC ROWID値を表すRowIdオブジェクト。 パラメータにSQL NULLを含む場合、null値が返される
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setRowId

      void setRowId​(String parameterName, RowId x) throws SQLException
      指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ROWIDに変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNString

      void setNString​(String parameterName, String value) throws SQLException
      指定されたパラメータを指定されたStringオブジェクトに設定します。 ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHARに変換します。
      パラメータ:
      parameterName - 設定されるパラメータの名前。
      value - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNCharacterStream

      void setNCharacterStream​(String parameterName, Reader value, long length) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。
      パラメータ:
      parameterName - 設定されるパラメータの名前。
      value - パラメータ値
      length - パラメータ・データ内の文字数。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNClob

      void setNClob​(String parameterName, NClob value) throws SQLException
      指定されたパラメータをjava.sql.NClobオブジェクトに設定します。 このオブジェクトは、java.sql.NClobインタフェースを実装します。 このNClobオブジェクトは、SQL NCLOBにマッピングされます。
      パラメータ:
      parameterName - 設定されるパラメータの名前。
      value - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setClob

      void setClob​(String parameterName, Reader reader, long length) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterName - 設定されるパラメータの名前。
      reader - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内の文字数。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、指定されたlengthが0より小さい場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setBlob

      void setBlob​(String parameterName, InputStream inputStream, long length) throws SQLException
      指定されたパラメータをInputStreamオブジェクトに設定します。 Inputstreamにはlengthで指定された文字数が含まれていなければなりません。そうでない場合は、CallableStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterName - 2番目は2に設定されるパラメータの名前
      inputStream - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内のバイト数。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合指定された長さが0より小さい場合InputStreamのバイト数が指定された長さと一致しない場合データベース・アクセス・エラーが発生した場合、またはこのメソッドが閉じられたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNClob

      void setNClob​(String parameterName, Reader reader, long length) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterName - 設定されるパラメータの名前。
      reader - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内の文字数。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、指定されたlengthが0より小さい場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getNClob

      NClob getNClob​(int parameterIndex) throws SQLException
      指定されたJDBC NCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      戻り値:
      Javaプログラミング言語のNClobオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getNClob

      NClob getNClob​(String parameterName) throws SQLException
      JDBC NCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      Javaプログラミング言語のNClobオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setSQLXML

      void setSQLXML​(String parameterName, SQLXML xmlObject) throws SQLException
      指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL XML値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      xmlObject - SQL XML値をマッピングするSQLXMLオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementまたはjava.xml.transform.Resultで呼び出された場合、WriterまたはOutputStreamがSQLXMLオブジェクトに対してクローズされていない場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getSQLXML

      SQLXML getSQLXML​(int parameterIndex) throws SQLException
      指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      戻り値:
      SQL XML値をマッピングするSQLXMLオブジェクト
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getSQLXML

      SQLXML getSQLXML​(String parameterName) throws SQLException
      指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      SQL XML値をマッピングするSQLXMLオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getNString

      String getNString​(int parameterIndex) throws SQLException
      指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。

      固定長の型のJDBC NCHARの場合、返されるStringオブジェクトはデータベースでSQL NCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。

      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      戻り値:
      NCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクト
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6
      関連項目:
      setNString(java.lang.String, java.lang.String)

    • getNString

      String getNString​(String parameterName) throws SQLException
      指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。

      固定長の型のJDBC NCHARの場合、返されるStringオブジェクトはデータベースでSQL NCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。

      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      NCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6
      関連項目:
      setNString(java.lang.String, java.lang.String)

    • getNCharacterStream

      Reader getNCharacterStream​(int parameterIndex) throws SQLException
      指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。 NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      戻り値:
      パラメータ値を格納するjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getNCharacterStream

      Reader getNCharacterStream​(String parameterName) throws SQLException
      指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。 NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値を格納するjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getCharacterStream

      Reader getCharacterStream​(int parameterIndex) throws SQLException
      指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      戻り値:
      パラメータ値を格納するjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnull
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      導入されたバージョン:
      1.6

    • getCharacterStream

      Reader getCharacterStream​(String parameterName) throws SQLException
      指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。
      パラメータ:
      parameterName - パラメータの名前
      戻り値:
      パラメータ値を格納するjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnull
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setBlob

      void setBlob​(String parameterName, Blob x) throws SQLException
      指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - SQL BLOB値をマッピングするBlobオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setClob

      void setClob​(String parameterName, Clob x) throws SQLException
      指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。
      パラメータ:
      parameterName - パラメータの名前
      x - SQL CLOB値をマッピングするClobオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setAsciiStream

      void setAsciiStream​(String parameterName, InputStream x, long length) throws SQLException
      指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      パラメータ:
      parameterName - パラメータの名前
      x - ASCIIパラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setBinaryStream

      void setBinaryStream​(String parameterName, InputStream x, long length) throws SQLException
      指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      パラメータ:
      parameterName - パラメータの名前
      x - バイナリ・パラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setCharacterStream

      void setCharacterStream​(String parameterName, Reader reader, long length) throws SQLException
      指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      パラメータ:
      parameterName - パラメータの名前
      reader - 指定されたパラメータとして使用されるUNICODEデータを含むjava.io.Readerオブジェクト
      length - ストリーム内の文字数
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setAsciiStream

      void setAsciiStream​(String parameterName, InputStream x) throws SQLException
      指定されたパラメータを指定された入力ストリームに設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      ノート: lengthパラメータを使用するバージョンのsetAsciiStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

      パラメータ:
      parameterName - パラメータの名前
      x - ASCIIパラメータ値を含むJava入力ストリーム
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setBinaryStream

      void setBinaryStream​(String parameterName, InputStream x) throws SQLException
      指定されたパラメータを指定された入力ストリームに設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      ノート: lengthパラメータを使用するバージョンのsetBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

      パラメータ:
      parameterName - パラメータの名前
      x - バイナリ・パラメータ値を含むJava入力ストリーム
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setCharacterStream

      void setCharacterStream​(String parameterName, Reader reader) throws SQLException
      指定されたパラメータを指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      ノート: lengthパラメータを使用するバージョンのsetCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

      パラメータ:
      parameterName - パラメータの名前
      reader - Unicodeデータを格納するjava.io.Readerオブジェクト
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNCharacterStream

      void setNCharacterStream​(String parameterName, Reader value) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。

      ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

      ノート: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

      パラメータ:
      parameterName - パラメータの名前
      value - パラメータ値
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setClob

      void setClob​(String parameterName, Reader reader) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: lengthパラメータを使用するバージョンのsetClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

      パラメータ:
      parameterName - パラメータの名前
      reader - パラメータ値に設定されるデータを含むオブジェクト。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setBlob

      void setBlob​(String parameterName, InputStream inputStream) throws SQLException
      指定されたパラメータをInputStreamオブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: lengthパラメータを使用するバージョンのsetBlobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

      パラメータ:
      parameterName - パラメータの名前
      inputStream - パラメータ値に設定されるデータを含むオブジェクト。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNClob

      void setNClob​(String parameterName, Reader reader) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: lengthパラメータを使用するバージョンのsetNClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

      パラメータ:
      parameterName - パラメータの名前
      reader - パラメータ値に設定されるデータを含むオブジェクト。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • getObject

      <T> T getObject​(int parameterIndex, Class<T> type) throws SQLException
      OUTパラメータparameterIndexの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。 変換がサポートされていない場合、またはtypeにnullが指定された場合は、SQLExceptionがスローされます。

      実装は、少なくとも、付録Bの表B-3に定義されている変換とユーザー定義SQL型からSQLDataを実装するJava型への変換、またはStructをサポートする必要があります。 ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。

      型パラメータ:
      T - このClassオブジェクトでモデル化されるクラスの型
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      type - 指定されたパラメータの変換後のJavaデータ型を表すクラス
      戻り値:
      OUTパラメータ値を保持するtypeのインスタンス
      例外:
      SQLException - 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。 この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.7

    • getObject

      <T> T getObject​(String parameterName, Class<T> type) throws SQLException
      OUTパラメータparameterNameの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。 変換がサポートされていない場合、またはtypeにnullが指定された場合は、SQLExceptionがスローされます。

      実装は、少なくとも、付録Bの表B-3に定義されている変換とユーザー定義SQL型からSQLDataを実装するJava型への変換、またはStructをサポートする必要があります。 ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。

      型パラメータ:
      T - このClassオブジェクトでモデル化されるクラスの型
      パラメータ:
      parameterName - パラメータの名前
      type - 指定されたパラメータの変換後のJavaデータ型を表すクラス
      戻り値:
      OUTパラメータ値を保持するtypeのインスタンス
      例外:
      SQLException - 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。 この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.7

    • setObject

      default void setObject​(String parameterName, 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をスローします

      パラメータ:
      parameterName - パラメータの名前
      x - 入力パラメータ値を含むオブジェクト
      targetSqlType - データベースに送られるSQL型。 scale引数で、さらにこの型を限定できる。
      scaleOrLength - java.sql.JDBCType.DECIMALまたはjava.sql.JDBCType.NUMERIC型の場合、これは小数点の後の桁数になる。 Javaオブジェクト型InputStreamおよびReaderの場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、あるいはxで指定されたJavaオブジェクトがInputStreamまたはReaderオブジェクトであり、かつscaleパラメータの値が0より小さい場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType

    • setObject

      default void setObject​(String parameterName, Object x, SQLType targetSqlType) throws SQLException
      指定されたパラメータの値を、指定されたオブジェクトで設定します。 このメソッドは、setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)に似ていますが、scaleに0を仮定している点が異なります。

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterName - パラメータの名前
      x - 入力パラメータ値を含むオブジェクト
      targetSqlType - データベースに送られるSQL型
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType

    • registerOutParameter

      default void registerOutParameter​(int parameterIndex, SQLType sqlType) throws SQLException
      順番parameterIndexのOUTパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlTypeにはJDBCType.OTHERまたはJDBCドライバでサポートされているSQLTypeを指定してください。 getObject(int)メソッドはその値を取り出します。

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      sqlType - SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。 パラメータがJDBC型JDBCType.NUMERICまたはJDBCType.DECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する。
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType

    • registerOutParameter

      default void registerOutParameter​(int parameterIndex, SQLType sqlType, int scale) throws SQLException
      順番parameterIndexのパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      パラメータがJDBC型JDBCType.NUMERICまたはJDBCType.DECIMALの場合は、このバージョンの registerOutParameterを使用するようにしてください。

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
      sqlType - SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。
      scale - 希望の小数点以下の桁数。 0以上の数値を指定する
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType

    • registerOutParameter

      default void registerOutParameter​(int parameterIndex, SQLType sqlType, String typeName) throws SQLException
      指定された出力パラメータを登録します。 ユーザー定義出力パラメータまたはREF出力パラメータには、このバージョンの registerOutParameterメソッドを使用します。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。

      ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。一方、REFパラメータの場合は、参照する型の完全指定型名を指定する必要があります。 型コードや型名の情報を必要としないJDBCドライバはそれを無視します。 ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREFパラメータに対し、これらの値を提供する必要があります。 このメソッドは、ユーザー定義パラメータとREFパラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。 パラメータがユーザー定義の型またはREF型を持たない場合、typeNameパラメータは無視されます。

      ノート: 出力パラメータの値を読み込むときには、そのパラメータの登録済みSQL型に対応するJava型用の取得メソッドを使用する必要があります。

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      sqlType - SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。
      typeName - SQL構造化型の完全指定された名前
      例外:
      SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType

    • registerOutParameter

      default void registerOutParameter​(String parameterName, SQLType sqlType) throws SQLException
      parameterNameという名前のOUTパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlTypeにはJDBCType.OTHERまたはJDBCでサポートされているSQLTypeを指定できます。 getObject(int)メソッドはその値を取り出します。

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterName - パラメータの名前
      sqlType - SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。 パラメータがJDBC型JDBCType.NUMERICまたはJDBCType.DECIMALである場合、スケール値を受け入れるバージョンの registerOutParameterを使用する。
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合、またはJDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType

    • registerOutParameter

      default void registerOutParameter​(String parameterName, SQLType sqlType, int scale) throws SQLException
      parameterNameという名前のパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      OUTパラメータ用にsqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。

      パラメータがJDBC型JDBCType.NUMERICまたはJDBCType.DECIMALの場合は、このバージョンの registerOutParameterを使用するようにしてください。

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterName - パラメータの名前
      sqlType - SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。
      scale - 希望の小数点以下の桁数。 0以上の数値を指定する
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合、またはJDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType

    • registerOutParameter

      default void registerOutParameter​(String parameterName, SQLType sqlType, String typeName) throws SQLException
      指定された出力パラメータを登録します。 ユーザー定義出力パラメータまたはREF出力パラメータには、このバージョンの registerOutParameterメソッドを使用します。 ユーザー定義型の例としては、STRUCT、DISTINCT、JAVA_OBJECT、名前付き配列などが挙げられます。

      ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。

      ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。REFパラメータの場合は、参照する型の完全指定型名を指定する必要があります。 型コードや型名の情報を必要としないJDBCドライバはそれを無視します。 ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREFパラメータに対し、これらの値を提供する必要があります。 このメソッドは、ユーザー定義パラメータおよびREFパラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。 パラメータの型がユーザー定義型、REF型のいずれでもない場合、typeNameパラメータは無視されます。

      ノート: 出力パラメータの値を読み込むときには、Javaの型XXXがパラメータの登録されているSQLの型に対応するgetXXXメソッドを使用する必要があります。

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterName - パラメータの名前
      sqlType - SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。
      typeName - SQL構造化型の完全指定された名前
      例外:
      SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合、またはJDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:
      JDBCType, SQLType