モジュール 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
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド デフォルト・メソッド 非推奨のメソッド 
      修飾子と型 メソッド 説明
      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)
      指定されたNCHARNVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
      String getNString​(String parameterName)
      指定されたNCHARNVARCHAR、または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 CHARVARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
      String getString​(String parameterName)
      JDBC CHARVARCHAR、または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かどうかを取得します。
    • メソッドの詳細

      • registerOutParameter

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

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

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

        パラメータ:
        parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする
        sqlType - java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する
        例外:
        SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
        SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、または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のデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、または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 CHARVARCHAR、または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で呼び出された場合
        関連項目:
        TypessetObject(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メソッドを使用します。 ユーザー定義型の例には、STRUCTDISTINCTJAVA_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のデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、または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型がこの特定のデータベースに固有である場合、sqlTypejava.sql.Types.OTHERでなければいけません。 getObject(int)メソッドはその値を取り出します。

        パラメータ:
        parameterName - パラメータの名前
        sqlType - java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する
        例外:
        SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合
        SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、または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のデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、または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のデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、または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 - 次で定義されるSQL型コード: java.sql.Types
        例外:
        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データ・ストリームへ書き込む必要があります。 また、オブジェクトがRefBlobClobNClobStructjava.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
        関連項目:
        TypesgetObject(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データ・ストリームへ書き込む必要があります。 また、オブジェクトがRefBlobClobNClobStructjava.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 CHARVARCHAR、または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
        関連項目:
        TypessetObject(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 NCHARNVARCHAR、または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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。
        パラメータ:
        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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
        パラメータ:
        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メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。
        パラメータ:
        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またはOutputStreamSQLXMLオブジェクトに対してクローズされていない場合
        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
        指定されたNCHARNVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。

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

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

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

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

        パラメータ:
        parameterName - パラメータの名前
        戻り値:
        NCHARNVARCHAR、または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オブジェクトとして取得します。 NCHARNVARCHAR、および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オブジェクトとして取得します。 NCHARNVARCHAR、および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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

        注: 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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYBLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

        注: 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メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

        注: 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データ・ストリームへ書き込む必要があります。 また、オブジェクトがRefBlobClobNClobStructjava.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メソッドを使用します。 ユーザー定義型の例には、STRUCTDISTINCTJAVA_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