- すべてのスーパー・インタフェース:
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
- 関連項目:
-
フィールドのサマリー
インタフェース java.sql.Statementで宣言されたフィールド
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO -
メソッドのサマリー
修飾子と型メソッド説明getArray(int parameterIndex) 指定されたJDBCARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。JDBCARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。getBigDecimal(int parameterIndex) 指定されたJDBCNUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。getBigDecimal(int parameterIndex, int scale) 非推奨。getBigDecimal(String parameterName) JDBCNUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。getBlob(int parameterIndex) 指定されたJDBCBLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。JDBCBLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。booleangetBoolean(int parameterIndex) 指定されたJDBCBITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。booleangetBoolean(String parameterName) JDBCBITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。bytegetByte(int parameterIndex) 指定されたJDBCTINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。byteJDBCTINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。byte[]getBytes(int parameterIndex) 指定されたJDBCBINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。byte[]JDBCBINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。getCharacterStream(int parameterIndex) 指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。getCharacterStream(String parameterName) 指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。getClob(int parameterIndex) 指定されたJDBCCLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。JDBCCLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。getDate(int parameterIndex) 指定されたJDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。指定されたJDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。JDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。JDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。doublegetDouble(int parameterIndex) 指定されたJDBCDOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。doubleJDBCDOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。floatgetFloat(int parameterIndex) 指定されたJDBCFLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。floatJDBCFLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。intgetInt(int parameterIndex) 指定されたJDBCINTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。intJDBCINTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。longgetLong(int parameterIndex) 指定されたJDBCBIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。longJDBCBIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。getNCharacterStream(int parameterIndex) 指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。getNCharacterStream(String parameterName) 指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。getNClob(int parameterIndex) 指定されたJDBCNCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。JDBCNCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。getNString(int parameterIndex) 指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。getNString(String parameterName) 指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。getObject(int parameterIndex) 指定されたパラメータの値をJavaプログラミング言語のObjectとして取り出します。<T> TOUTパラメータparameterIndexの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。OUTパラメータparameterIndexの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。パラメータの値をJavaプログラミング言語のObjectとして取り出します。<T> TOUTパラメータparameterNameの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。OUTパラメータparameterNameの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。getRef(int parameterIndex) 指定されたJDBCREF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。JDBCREF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。getRowId(int parameterIndex) 指定されたJDBCROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。指定されたJDBCROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。shortgetShort(int parameterIndex) 指定されたJDBCSMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。shortJDBCSMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。getSQLXML(int parameterIndex) 指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。getString(int parameterIndex) 指定されたJDBCCHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。JDBCCHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。getTime(int parameterIndex) 指定されたJDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。指定されたJDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。JDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。JDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。getTimestamp(int parameterIndex) 指定されたJDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。getTimestamp(int parameterIndex, Calendar cal) 指定されたJDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。getTimestamp(String parameterName) JDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。getTimestamp(String parameterName, Calendar cal) JDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。getURL(int parameterIndex) 指定されたJDBCDATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。JDBCDATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。voidregisterOutParameter(int parameterIndex, int sqlType) 順番parameterIndexのOUTパラメータをJDBC型sqlTypeとして登録します。voidregisterOutParameter(int parameterIndex, int sqlType, int scale) 順番parameterIndexのパラメータをJDBC型sqlTypeとして登録します。voidregisterOutParameter(int parameterIndex, int sqlType, String typeName) 指定された出力パラメータを登録します。default voidregisterOutParameter(int parameterIndex, SQLType sqlType) 順番parameterIndexのOUTパラメータをJDBC型sqlTypeとして登録します。default voidregisterOutParameter(int parameterIndex, SQLType sqlType, int scale) 順番parameterIndexのパラメータをJDBC型sqlTypeとして登録します。default voidregisterOutParameter(int parameterIndex, SQLType sqlType, String typeName) 指定された出力パラメータを登録します。voidregisterOutParameter(String parameterName, int sqlType) parameterNameという名前のOUTパラメータをJDBC型sqlTypeとして登録します。voidregisterOutParameter(String parameterName, int sqlType, int scale) parameterNameという名前のパラメータをJDBC型sqlTypeとして登録します。voidregisterOutParameter(String parameterName, int sqlType, String typeName) 指定された出力パラメータを登録します。default voidregisterOutParameter(String parameterName, SQLType sqlType) parameterNameという名前のOUTパラメータをJDBC型sqlTypeとして登録します。default voidregisterOutParameter(String parameterName, SQLType sqlType, int scale) parameterNameという名前のパラメータをJDBC型sqlTypeとして登録します。default voidregisterOutParameter(String parameterName, SQLType sqlType, String typeName) 指定された出力パラメータを登録します。voidsetAsciiStream(String parameterName, InputStream x) 指定されたパラメータを指定された入力ストリームに設定します。voidsetAsciiStream(String parameterName, InputStream x, int length) 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。voidsetAsciiStream(String parameterName, InputStream x, long length) 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。voidsetBigDecimal(String parameterName, BigDecimal x) 指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。voidsetBinaryStream(String parameterName, InputStream x) 指定されたパラメータを指定された入力ストリームに設定します。voidsetBinaryStream(String parameterName, InputStream x, int length) 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。voidsetBinaryStream(String parameterName, InputStream x, long length) 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。voidsetBlob(String parameterName, InputStream inputStream) 指定されたパラメータをInputStreamオブジェクトに設定します。voidsetBlob(String parameterName, InputStream inputStream, long length) 指定されたパラメータをInputStreamオブジェクトに設定します。void指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。voidsetBoolean(String parameterName, boolean x) 指定されたパラメータを指定されたJavaのboolean値に設定します。void指定されたパラメータを指定されたJavaのbyte値に設定します。void指定されたパラメータを指定されたJavaのバイト配列に設定します。voidsetCharacterStream(String parameterName, Reader reader) 指定されたパラメータを指定されたReaderオブジェクトに設定します。voidsetCharacterStream(String parameterName, Reader reader, int length) 指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。voidsetCharacterStream(String parameterName, Reader reader, long length) 指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。void指定されたパラメータをReaderオブジェクトに設定します。void指定されたパラメータをReaderオブジェクトに設定します。void指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。voidアプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。void指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。void指定されたパラメータを指定されたJavaのdouble値に設定します。void指定されたパラメータを指定されたJavaのfloat値に設定します。void指定されたパラメータを指定されたJavaのint値に設定します。void指定されたパラメータを指定されたJavaのlong値に設定します。voidsetNCharacterStream(String parameterName, Reader value) 指定されたパラメータをReaderオブジェクトに設定します。voidsetNCharacterStream(String parameterName, Reader value, long length) 指定されたパラメータをReaderオブジェクトに設定します。void指定されたパラメータをReaderオブジェクトに設定します。void指定されたパラメータをReaderオブジェクトに設定します。void指定されたパラメータをjava.sql.NClobオブジェクトに設定します。voidsetNString(String parameterName, String value) 指定されたパラメータを指定されたStringオブジェクトに設定します。void指定されたパラメータをSQLNULLに設定します。void指定されたパラメータをSQLNULLに設定します。void指定されたパラメータの値を、指定されたオブジェクトで設定します。void指定されたパラメータの値を、指定されたオブジェクトで設定します。void指定されたパラメータの値を、指定されたオブジェクトで設定します。default void指定されたパラメータの値を、指定されたオブジェクトで設定します。default void指定されたパラメータの値を、指定されたオブジェクトで設定します。void指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。void指定されたパラメータを指定されたJavaのshort値に設定します。void指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。void指定されたパラメータを指定されたJavaのString値に設定します。void指定されたパラメータを、指定されたjava.sql.Time値に設定します。void指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。voidsetTimestamp(String parameterName, Timestamp x) 指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。voidsetTimestamp(String parameterName, Timestamp x, Calendar cal) 指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。void指定されたパラメータを指定されたjava.net.URLオブジェクトに設定します。booleanwasNull()最後に読み込まれたOUTパラメータの値がSQLNULLかどうかを取得します。インタフェース java.sql.PreparedStatementで宣言されたメソッド
addBatch, clearParameters, execute, executeLargeUpdate, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURLインタフェース java.sql.Statementで宣言されたメソッド
addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeoutインタフェース java.sql.Wrapperで宣言されたメソッド
isWrapperFor, unwrap
-
メソッドの詳細
-
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType) throws SQLException 順番parameterIndexのOUTパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。OUTパラメータ用に
sqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、
sqlTypeはjava.sql.Types.OTHERでなければいけません。getObject(int)メソッドはその値を取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとするsqlType-java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する- 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException-sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合- 関連項目:
-
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException 順番parameterIndexのパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。OUTパラメータ用に
sqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。パラメータがJDBCの型
NUMERICまたはDECIMALの場合は、このバージョンのregisterOutParameterを使用しなければいけません。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとするsqlType-java.sql.Typesによって定義されるSQL型のコード。scale- 希望の小数点以下の桁数。 0以上の数値を指定する- 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException-sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合- 関連項目:
-
wasNull
boolean wasNull() throws SQLException最後に読み込まれたOUTパラメータの値がSQLNULLかどうかを取得します。 このメソッドを呼び出すのは、読込み用メソッドの呼出しのあとでなければいけません。そうでない場合は、nullかどうかを判別するために使用する値がありません。- 戻り値:
- 最後に読み込まれたパラメータがSQL
NULLの場合はtrue、そうでない場合はfalse - 例外:
SQLException- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合
-
getString
指定されたJDBCCHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。固定長の型のJDBC
CHARの場合、返されるStringオブジェクトはデータベースでSQLCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getBoolean
boolean getBoolean(int parameterIndex) throws SQLException 指定されたJDBCBITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はfalse - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getByte
byte getByte(int parameterIndex) throws SQLException 指定されたJDBCTINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getShort
short getShort(int parameterIndex) throws SQLException 指定されたJDBCSMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getInt
int getInt(int parameterIndex) throws SQLException 指定されたJDBCINTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getLong
long getLong(int parameterIndex) throws SQLException 指定されたJDBCBIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getFloat
float getFloat(int parameterIndex) throws SQLException 指定されたJDBCFLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getDouble
double getDouble(int parameterIndex) throws SQLException 指定されたJDBCDOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException 非推奨。getBigDecimal(int parameterIndex)またはgetBigDecimal(String parameterName)を使用します。指定されたJDBCNUMERICパラメータの値を、scaleで指定された小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとするscale- 小数点以下の桁数- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 関連項目:
-
getBytes
byte[] getBytes(int parameterIndex) throws SQLException 指定されたJDBCBINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getDate
指定されたJDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getTime
指定されたJDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getTimestamp
指定されたJDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getObject
指定されたパラメータの値をJavaプログラミング言語のObjectとして取り出します。 値がSQLNULLの場合、ドライバはJavanullを返します。このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、
registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。 ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- OUTパラメータ値を保持する
java.lang.Object - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 関連項目:
-
getBigDecimal
指定されたJDBCNUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- パラメータ値(全精度)。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
getObject
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
- 関連項目:
-
getRef
指定されたJDBCREF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- Javaプログラミング言語の
Refオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getBlob
指定されたJDBCBLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- Javaプログラミング言語の
Blobオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getClob
指定されたJDBCCLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- Javaプログラミング言語の
Clobオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getArray
指定されたJDBCARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- Javaプログラミング言語の
Arrayオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getDate
指定されたJDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して日付を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとするcal- ドライバが日付を作成するために使用するCalendarオブジェクト- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
getTime
指定されたJDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して時間を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとするcal- ドライバが時間を作成するために使用するCalendarオブジェクト- 戻り値:
- パラメータ値。値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
getTimestamp
指定されたJDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮してタイムスタンプを計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとするcal- ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException 指定された出力パラメータを登録します。 ユーザー定義出力パラメータまたはREF出力パラメータには、このバージョンのregisterOutParameterメソッドを使用します。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。一方、
REFパラメータの場合は、参照する型の完全指定型名を指定する必要があります。 型コードや型名の情報を必要としないJDBCドライバはそれを無視します。 ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREFパラメータに対し、これらの値を提供する必要があります。 このメソッドは、ユーザー定義パラメータとREFパラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。 パラメータがユーザー定義の型またはREF型を持たない場合、typeNameパラメータは無視されます。ノート: 出力パラメータの値を読み込むときには、そのパラメータの登録済みSQL型に対応するJava型用の取得メソッドを使用する必要があります。
- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるsqlType-Typesからの値typeName- SQL構造化型の完全指定された名前- 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException-sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合- 導入されたバージョン:
- 1.2
- 関連項目:
-
registerOutParameter
void registerOutParameter(String parameterName, int sqlType) throws SQLException parameterNameという名前のOUTパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。OUTパラメータ用に
sqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、
sqlTypeはjava.sql.Types.OTHERでなければいけません。getObject(int)メソッドはその値を取り出します。- パラメータ:
parameterName- パラメータの名前sqlType-java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException-sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
registerOutParameter
void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException parameterNameという名前のパラメータをJDBC型sqlTypeとして登録します。 ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。OUTパラメータ用に
sqlTypeによって指定されたJDBCの型は、そのパラメータの値を読み込むためにgetメソッドで使用する必要のあるJavaの型を判定します。パラメータがJDBCの型
NUMERICまたはDECIMALの場合は、このバージョンのregisterOutParameterを使用しなければいけません。- パラメータ:
parameterName- パラメータの名前sqlType-java.sql.Typesによって定義されるSQL型のコード。scale- 希望の小数点以下の桁数。 0以上の数値を指定する- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException-sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
registerOutParameter
void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException 指定された出力パラメータを登録します。 ユーザー定義出力パラメータまたはREF出力パラメータには、このバージョンのregisterOutParameterメソッドを使用します。 ユーザー定義型の例としては、STRUCT、DISTINCT、JAVA_OBJECT、名前付き配列などが挙げられます。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。REFパラメータの場合は、参照する型の完全指定型名を指定する必要があります。 型コードや型名の情報を必要としないJDBCドライバはそれを無視します。 ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREFパラメータに対し、これらの値を提供する必要があります。 このメソッドは、ユーザー定義パラメータおよびREFパラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。 パラメータの型がユーザー定義型、REF型のいずれでもない場合、typeNameパラメータは無視されます。
ノート: 出力パラメータの値を読み込むときには、Javaの型XXXがパラメータの登録されているSQLの型に対応する
getXXXメソッドを使用する必要があります。- パラメータ:
parameterName- パラメータの名前sqlType-Typesからの値typeName- SQL構造化型の完全指定された名前- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException-sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getURL
指定されたJDBCDATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となる- 戻り値:
- 指定されたパラメータとして使用されるJDBC
DATALINK値を表すjava.net.URLオブジェクト。 - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、または返されるURLがJavaプラットフォームで有効なURLではない場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setURL
void setURL(String parameterName, URL val) throws SQLException 指定されたパラメータを指定されたjava.net.URLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLDATALINK値に変換します。- パラメータ:
parameterName- パラメータの名前val- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、またはURLが無効の場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setNull
void setNull(String parameterName, int sqlType) throws SQLException 指定されたパラメータをSQLNULLに設定します。ノート: パラメータのSQLの型を指定する必要があります。
- パラメータ:
parameterName- パラメータの名前sqlType-java.sql.Typesで定義されるSQL型コード- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setBoolean
void setBoolean(String parameterName, boolean x) throws SQLException 指定されたパラメータを指定されたJavaのboolean値に設定します。 データベースに送るときに、ドライバはこれをSQLBITまたはBOOLEAN値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setByte
void setByte(String parameterName, byte x) throws SQLException 指定されたパラメータを指定されたJavaのbyte値に設定します。 データベースに送るときに、ドライバはこれをSQLTINYINT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setShort
void setShort(String parameterName, short x) throws SQLException 指定されたパラメータを指定されたJavaのshort値に設定します。 データベースに送るときに、ドライバはこれをSQLSMALLINT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setInt
void setInt(String parameterName, int x) throws SQLException 指定されたパラメータを指定されたJavaのint値に設定します。 データベースに送るときに、ドライバはこれをSQLINTEGER値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setLong
void setLong(String parameterName, long x) throws SQLException 指定されたパラメータを指定されたJavaのlong値に設定します。 データベースに送るときに、ドライバはこれをSQLBIGINT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setFloat
void setFloat(String parameterName, float x) throws SQLException 指定されたパラメータを指定されたJavaのfloat値に設定します。 データベースに送るときに、ドライバはこれをSQLFLOAT値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setDouble
void setDouble(String parameterName, double x) throws SQLException 指定されたパラメータを指定されたJavaのdouble値に設定します。 データベースに送るときに、ドライバはこれをSQLDOUBLE値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal x) throws SQLException 指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。 データベースに送るときに、ドライバはこれをSQLNUMERIC値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setString
void setString(String parameterName, String x) throws SQLException 指定されたパラメータを指定されたJavaのString値に設定します。 データベースに送るときに、ドライバはこれをSQLVARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setBytes
void setBytes(String parameterName, byte[] x) throws SQLException 指定されたパラメータを指定されたJavaのバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQLVARBINARYまたはLONGVARBINARY(ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setDate
void setDate(String parameterName, Date x) throws SQLException アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 データベースに送るときに、ドライバはこれをSQLDATE値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setTime
void setTime(String parameterName, Time x) throws SQLException 指定されたパラメータを、指定されたjava.sql.Time値に設定します。 データベースに送るときに、ドライバはこれをSQLTIME値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setTimestamp
void setTimestamp(String parameterName, Timestamp x) throws SQLException 指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 データベースに送るときに、ドライバはこれをSQLTIMESTAMP値に変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setAsciiStream
void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前x- ASCIIパラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setBinaryStream
void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前x- バイナリ・パラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
setObject
void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException 指定されたパラメータの値を、指定されたオブジェクトで設定します。指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。 オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェース
SQLDataを実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。このメソッドは、データベース固有の抽象データ型を渡すために使用できることに注意してください。
- パラメータ:
parameterName- パラメータの名前x- 入力パラメータ値を含むオブジェクトtargetSqlType- データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。scale- java.sql.Types.DECIMALやjava.sql.Types.NUMERIC型では、小数点以下の桁数。 ほかのすべての型では、この値は無視される。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバが指定されたtargetSqlTypeをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
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
- 関連項目:
-
setObject
void setObject(String parameterName, Object x) throws SQLException 指定されたパラメータの値を、指定されたオブジェクトで設定します。JDBCの仕様では、Javaの
Object型からSQL型への標準マッピングを規定しています。 指定された引数は、データベースに送られる前に、対応するSQL型に変換されます。このメソッドは、ドライバ固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用できます。 オブジェクトがインタフェース
SQLDataを実装するクラスのインスタンスである場合、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。たとえば、オブジェクトが上記のインタフェースを複数実装するクラスであるなど、あいまいさがある場合、このメソッドは例外をスローします。
ノート: すべてのデータベースで、バックエンドに対する型のないNullの送信が許可されるわけではありません。 移植性を最大限にするには、
setObject(String parameterName, Object x)の代わりにsetNullメソッドまたはsetObject(String parameterName, Object x, int sqlType)メソッドを使用しなければいけません。- パラメータ:
parameterName- パラメータの名前x- 入力パラメータ値を含むオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、または指定されたObjectパラメータがあいまいな場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
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オブジェクトを使用してSQLDATE値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値cal- ドライバが日付を作成するために使用するCalendarオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setTime
void setTime(String parameterName, Time x, Calendar cal) throws SQLException 指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。 ドライバはCalendarオブジェクトを使用してSQLTIME値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して時間を計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値cal- ドライバが時間を作成するために使用するCalendarオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setTimestamp
void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException 指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。 ドライバはCalendarオブジェクトを使用してSQLTIMESTAMP値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値cal- ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setNull
void setNull(String parameterName, int sqlType, String typeName) throws SQLException 指定されたパラメータをSQLNULLに設定します。 ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用するべきです。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。ノート: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全修飾SQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。 REFパラメータの場合、名前は参照される型の型名です。
ユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 パラメータがユーザー定義の型またはREF型を持たない場合、指定されたtypeNameは無視されます。
- パラメータ:
parameterName- パラメータの名前sqlType-java.sql.Typesからの値typeName- SQLユーザー定義型の完全修飾名。パラメータがユーザー定義型でもSQLREF値でもない場合は無視される- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getString
JDBCCHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。固定長の型のJDBC
CHARの場合、返されるStringオブジェクトはデータベースでSQLCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getBoolean
boolean getBoolean(String parameterName) throws SQLException JDBCBITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はfalse - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getByte
byte getByte(String parameterName) throws SQLException JDBCTINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getShort
short getShort(String parameterName) throws SQLException JDBCSMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getInt
int getInt(String parameterName) throws SQLException JDBCINTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getLong
long getLong(String parameterName) throws SQLException JDBCBIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getFloat
float getFloat(String parameterName) throws SQLException JDBCFLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getDouble
double getDouble(String parameterName) throws SQLException JDBCDOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合は0 - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getBytes
byte[] getBytes(String parameterName) throws SQLException JDBCBINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getDate
JDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getTime
JDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getTimestamp
JDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getObject
パラメータの値をJavaプログラミング言語のObjectとして取り出します。 値がSQLNULLの場合、ドライバはJavanullを返します。このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、
registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。 ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- OUTパラメータ値を保持する
java.lang.Object。 - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getBigDecimal
JDBCNUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値(全精度)。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getObject
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
- 関連項目:
-
getRef
JDBCREF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- Javaプログラミング言語の
Refオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getBlob
JDBCBLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- Javaプログラミング言語の
Blobオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getClob
JDBCCLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- Javaプログラミング言語の
Clobオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getArray
JDBCARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- Javaプログラミング言語の
Arrayオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
-
getDate
JDBCDATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して日付を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。- パラメータ:
parameterName- パラメータの名前cal- ドライバが日付を作成するために使用するCalendarオブジェクト- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getTime
JDBCTIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して時間を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。- パラメータ:
parameterName- パラメータの名前cal- ドライバが時間を作成するために使用するCalendarオブジェクト- 戻り値:
- パラメータ値。値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getTimestamp
JDBCTIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮してタイムスタンプを計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。- パラメータ:
parameterName- パラメータの名前cal- ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト- 戻り値:
- パラメータ値。 値がSQL
NULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getURL
JDBCDATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- Javaプログラミング言語の
java.net.URLオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、またはURLに問題がある場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getRowId
指定されたJDBCROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となる- 戻り値:
- 指定されたパラメータとして使用されるJDBC
ROWID値を表すRowIdオブジェクト。 パラメータにSQLNULLを含む場合、null値が返される - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getRowId
指定されたJDBCROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- 指定されたパラメータとして使用されるJDBC
ROWID値を表すRowIdオブジェクト。 パラメータにSQLNULLを含む場合、null値が返される - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setRowId
void setRowId(String parameterName, RowId x) throws SQLException 指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLROWIDに変換します。- パラメータ:
parameterName- パラメータの名前x- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNString
void setNString(String parameterName, String value) throws SQLException 指定されたパラメータを指定されたStringオブジェクトに設定します。 ドライバはこれをSQLNCHAR、NVARCHAR、またはLONGNVARCHARに変換します。- パラメータ:
parameterName- 設定されるパラメータの名前。value- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException 指定されたパラメータをReaderオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。- パラメータ:
parameterName- 設定されるパラメータの名前。value- パラメータ値length- パラメータ・データ内の文字数。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(String parameterName, NClob value) throws SQLException 指定されたパラメータをjava.sql.NClobオブジェクトに設定します。 このオブジェクトは、java.sql.NClobインタフェースを実装します。 このNClobオブジェクトは、SQLNCLOBにマッピングされます。- パラメータ:
parameterName- 設定されるパラメータの名前。value- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(String parameterName, Reader reader, long length) throws SQLException 指定されたパラメータをReaderオブジェクトに設定します。readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName- 設定されるパラメータの名前。reader- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内の文字数。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、指定されたlengthが0より小さい場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException 指定されたパラメータをInputStreamオブジェクトに設定します。Inputstreamにはlengthで指定された文字数が含まれていなければなりません。そうでない場合は、CallableStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName- 2番目は2に設定されるパラメータの名前inputStream- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内のバイト数。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合指定された長さが0より小さい場合InputStreamのバイト数が指定された長さと一致しない場合データベース・アクセス・エラーが発生した場合、またはこのメソッドが閉じられたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(String parameterName, Reader reader, long length) throws SQLException 指定されたパラメータをReaderオブジェクトに設定します。readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。- パラメータ:
parameterName- 設定されるパラメータの名前。reader- パラメータ値に設定されるデータを含むオブジェクト。length- パラメータ・データ内の文字数。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、指定されたlengthが0より小さい場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNClob
指定されたJDBCNCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとする- 戻り値:
- Javaプログラミング言語の
NClobオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNClob
JDBCNCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- Javaプログラミング言語の
NClobオブジェクトとして表されたパラメータ値。 値がSQLNULLの場合はnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setSQLXML
void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException 指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL XML値に変換します。- パラメータ:
parameterName- パラメータの名前xmlObject-SQL XML値をマッピングするSQLXMLオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementまたはjava.xml.transform.Resultで呼び出された場合、WriterまたはOutputStreamがSQLXMLオブジェクトに対してクローズされていない場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getSQLXML
指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる- 戻り値:
SQL XML値をマッピングするSQLXMLオブジェクト- 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getSQLXML
指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
SQL XML値をマッピングするSQLXMLオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNString
指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。固定長の型のJDBC
NCHARの場合、返されるStringオブジェクトはデータベースでSQLNCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。- パラメータ:
parameterIndex- 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる- 戻り値:
NCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクト- 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
getNString
指定されたNCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。固定長の型のJDBC
NCHARの場合、返されるStringオブジェクトはデータベースでSQLNCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。- パラメータ:
parameterName- パラメータの名前- 戻り値:
NCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
- 関連項目:
-
getNCharacterStream
指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となる- 戻り値:
- パラメータ値を格納する
java.io.Readerオブジェクト。値がSQLNULLの場合、返される値はJavaプログラミング言語のnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getNCharacterStream
指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値を格納する
java.io.Readerオブジェクト。値がSQLNULLの場合、返される値はJavaプログラミング言語のnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getCharacterStream
指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となる- 戻り値:
- パラメータ値を格納する
java.io.Readerオブジェクト。値がSQLNULLの場合、返される値はJavaプログラミング言語のnull - 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合- 導入されたバージョン:
- 1.6
-
getCharacterStream
指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。- パラメータ:
parameterName- パラメータの名前- 戻り値:
- パラメータ値を格納する
java.io.Readerオブジェクト。値がSQLNULLの場合、返される値はJavaプログラミング言語のnull - 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
void setBlob(String parameterName, Blob x) throws SQLException 指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLBLOB値に変換します。- パラメータ:
parameterName- パラメータの名前x- SQLBLOB値をマッピングするBlobオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(String parameterName, Clob x) throws SQLException 指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQLCLOB値に変換します。- パラメータ:
parameterName- パラメータの名前x- SQLCLOB値をマッピングするClobオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setAsciiStream
void setAsciiStream(String parameterName, InputStream x, long length) throws SQLException 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前x- ASCIIパラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBinaryStream
void setBinaryStream(String parameterName, InputStream x, long length) throws SQLException 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前x- バイナリ・パラメータ値を含むJava入力ストリームlength- ストリームのバイト数- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setCharacterStream
void setCharacterStream(String parameterName, Reader reader, long length) throws SQLException 指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
- パラメータ:
parameterName- パラメータの名前reader- 指定されたパラメータとして使用されるUNICODEデータを含むjava.io.Readerオブジェクトlength- ストリーム内の文字数- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setAsciiStream
void setAsciiStream(String parameterName, InputStream x) throws SQLException 指定されたパラメータを指定された入力ストリームに設定します。LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setAsciiStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前x- ASCIIパラメータ値を含むJava入力ストリーム- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBinaryStream
void setBinaryStream(String parameterName, InputStream x) throws SQLException 指定されたパラメータを指定された入力ストリームに設定します。LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前x- バイナリ・パラメータ値を含むJava入力ストリーム- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setCharacterStream
void setCharacterStream(String parameterName, Reader reader) throws SQLException 指定されたパラメータを指定されたReaderオブジェクトに設定します。LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前reader- Unicodeデータを格納するjava.io.Readerオブジェクト- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value) throws SQLException 指定されたパラメータをReaderオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンの
setNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前value- パラメータ値- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setClob
void setClob(String parameterName, Reader reader) throws SQLException 指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前reader- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setBlob
void setBlob(String parameterName, InputStream inputStream) throws SQLException 指定されたパラメータをInputStreamオブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信しなければならないことをドライバに通知します。setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setBlobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前inputStream- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
setNClob
void setNClob(String parameterName, Reader reader) throws SQLException 指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信しなければならないことをドライバに通知します。setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。ノート: lengthパラメータを使用するバージョンの
setNClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。- パラメータ:
parameterName- パラメータの名前reader- パラメータ値に設定されるデータを含むオブジェクト。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.6
-
getObject
<T> T getObject(int parameterIndex, Class<T> type) throws SQLException OUTパラメータparameterIndexの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。 変換がサポートされていない場合、またはtypeにnullが指定された場合は、SQLExceptionがスローされます。実装は、少なくとも、付録Bの表B-3に定義されている変換とユーザー定義SQL型から
SQLDataを実装するJava型への変換、またはStructをサポートする必要があります。 ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。- 型パラメータ:
T- このClassオブジェクトでモデル化されるクラスの型- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、などとするtype- 指定されたパラメータの変換後のJavaデータ型を表すクラス- 戻り値:
- OUTパラメータ値を保持する
typeのインスタンス - 例外:
SQLException- 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。 この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.7
-
getObject
<T> T getObject(String parameterName, Class<T> type) throws SQLException OUTパラメータparameterNameの値を表すオブジェクトを返し、変換がサポートされている場合には、そのパラメータのSQL型を要求されたJavaデータ型に変換します。 変換がサポートされていない場合、またはtypeにnullが指定された場合は、SQLExceptionがスローされます。実装は、少なくとも、付録Bの表B-3に定義されている変換とユーザー定義SQL型から
SQLDataを実装するJava型への変換、またはStructをサポートする必要があります。 ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。- 型パラメータ:
T- このClassオブジェクトでモデル化されるクラスの型- パラメータ:
parameterName- パラメータの名前type- 指定されたパラメータの変換後のJavaデータ型を表すクラス- 戻り値:
- OUTパラメータ値を保持する
typeのインスタンス - 例外:
SQLException- 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。 この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.7
-
setObject
default void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException 指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数がInputStreamである場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderである場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。 これらの条件がtrueではない場合、準備された文の実行時にドライバはSQLExceptionを生成します。指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。 オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェース
SQLDataを実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。
デフォルト実装は
SQLFeatureNotSupportedExceptionをスローします- パラメータ:
parameterName- パラメータの名前x- 入力パラメータ値を含むオブジェクトtargetSqlType- データベースに送られるSQL型。 scale引数で、さらにこの型を限定できる。scaleOrLength-java.sql.JDBCType.DECIMALまたはjava.sql.JDBCType.NUMERIC型の場合、これは小数点の後の桁数になる。 Javaオブジェクト型InputStreamおよびReaderの場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。- 例外:
SQLException- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、あるいはxで指定されたJavaオブジェクトがInputStreamまたはReaderオブジェクトであり、かつscaleパラメータの値が0より小さい場合SQLFeatureNotSupportedException- JDBCドライバが指定されたtargetSqlTypeをサポートしない場合- 導入されたバージョン:
- 1.8
- 関連項目:
-
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
- 関連項目:
-
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
- 関連項目:
-
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
- 関連項目:
-
registerOutParameter
default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLException 指定された出力パラメータを登録します。 ユーザー定義出力パラメータまたはREF出力パラメータには、このバージョンのregisterOutParameterメソッドを使用します。 ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。一方、
REFパラメータの場合は、参照する型の完全指定型名を指定する必要があります。 型コードや型名の情報を必要としないJDBCドライバはそれを無視します。 ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREFパラメータに対し、これらの値を提供する必要があります。 このメソッドは、ユーザー定義パラメータとREFパラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。 パラメータがユーザー定義の型またはREF型を持たない場合、typeNameパラメータは無視されます。ノート: 出力パラメータの値を読み込むときには、そのパラメータの登録済みSQL型に対応するJava型用の取得メソッドを使用する必要があります。
デフォルト実装は
SQLFeatureNotSupportedExceptionをスローします- パラメータ:
parameterIndex- 最初のパラメータは1、2番目のパラメータは2、... となるsqlType-SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。typeName- SQL構造化型の完全指定された名前- 例外:
SQLException- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException- JDBCドライバが指定されたSqlTypeをサポートしない場合- 導入されたバージョン:
- 1.8
- 関連項目:
-
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
- 関連項目:
-
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
- 関連項目:
-
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
- 関連項目:
-
getBigDecimal(int parameterIndex)またはgetBigDecimal(String parameterName)を使用します。