モジュール java.sql

パッケージ java.sql

インタフェースCallableStatement

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

AutoCloseable, PreparedStatement, Statement, Wrapper

public interface CallableStatement extends PreparedStatement

SQLストアド・プロシージャを実行するのに使用されるインタフェースです。 JDBC APIは、ストアド・プロシージャSQLエスケープ構文を提供します。これにより、すべてのRDBMSに対し標準の方法でストアド・プロシージャを呼び出せます。 このエスケープ構文には、結果パラメータを含めるものと含めないものとがあります。 結果パラメータを使用する場合、結果パラメータをOUTパラメータとして登録しなければいけません。 その他のパラメータは、入力または出力、あるいはその両方に対して使用できます。 パラメータは、番号により順番に参照されます。最初のパラメータは1です。

   {?= call <procedure-name>[(<arg1>,<arg2>, ...)]}
   {call <procedure-name>[(<arg1>,<arg2>, ...)]}
 

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

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

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

導入されたバージョン:

1.1

関連項目:

• Connection.prepareCall(java.lang.String)
• ResultSet

フィールドのサマリー

インタフェース java.sql.Statementで宣言されたフィールド

CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO

メソッドのサマリー

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

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

addBatch, clearParameters, execute, executeLargeUpdate, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL

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

addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

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

isWrapperFor, unwrap

メソッドの詳細

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType) throws SQLException

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

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

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

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする

sqlType - java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合

関連項目:

• Types

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException

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

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

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

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする

sqlType - java.sql.Typesによって定義されるSQL型のコード。

scale - 希望の小数点以下の桁数。 0以上の数値を指定する

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合

関連項目:

• Types

wasNull

boolean wasNull() throws SQLException

最後に読み込まれたOUTパラメータの値がSQL NULLかどうかを取得します。 このメソッドを呼び出すのは、読込み用メソッドの呼出しのあとでなければいけません。そうでない場合は、nullかどうかを判別するために使用する値がありません。

戻り値:

最後に読み込まれたパラメータがSQL NULLの場合はtrue、そうでない場合はfalse

throws:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

getString

String getString(int parameterIndex) throws SQLException

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

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

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする

戻り値:

パラメータ値。 値がSQL NULLの場合はnull

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

関連項目:

• Types
• setObject(java.lang.String, java.lang.Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(int parameterIndex) throws SQLException

指定されたJDBC NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとする

戻り値:

パラメータ値(全精度)。 値がSQL NULLの場合はnull

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

導入されたバージョン:

1.2

関連項目:

• setTimestamp(java.lang.String, java.sql.Timestamp)

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException

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

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

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

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

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

sqlType - Typesからの値

typeName - SQL構造化型の完全指定された名前

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合

導入されたバージョン:

1.2

関連項目:

• Types

registerOutParameter

void registerOutParameter(String parameterName, int sqlType) throws SQLException

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

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

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

パラメータ:

parameterName - パラメータの名前

sqlType - java.sql.Typesによって定義されるJDBC型のコード。 パラメータがJDBC型NUMERICまたはDECIMALである場合、スケール値を受け入れるバージョンのregisterOutParameterを使用する

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合

導入されたバージョン:

1.4

関連項目:

• Types

registerOutParameter

void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException

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

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

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

パラメータ:

parameterName - パラメータの名前

sqlType - java.sql.Typesによって定義されるSQL型のコード。

scale - 希望の小数点以下の桁数。 0以上の数値を指定する

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合

導入されたバージョン:

1.4

関連項目:

• Types

registerOutParameter

void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException

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

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

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

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

パラメータ:

parameterName - パラメータの名前

sqlType - Typesからの値

typeName - SQL構造化型の完全指定された名前

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合

導入されたバージョン:

1.4

関連項目:

• Types

getURL

URL getURL(int parameterIndex) throws SQLException

指定されたJDBC DATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

戻り値:

指定されたパラメータとして使用されるJDBC DATALINK値を表すjava.net.URLオブジェクト。

throws:

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 - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、またはURLが無効の場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getURL(int)

setNull

void setNull(String parameterName, int sqlType) throws SQLException

指定されたパラメータをSQL NULLに設定します。

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

パラメータ:

parameterName - パラメータの名前

sqlType - java.sql.Typesで定義されるSQL型コード

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

指定されたパラメータを指定されたJavaのboolean値に設定します。 データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getBoolean(int)

setByte

void setByte(String parameterName, byte x) throws SQLException

指定されたパラメータを指定されたJavaのbyte値に設定します。 データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getByte(int)

setShort

void setShort(String parameterName, short x) throws SQLException

指定されたパラメータを指定されたJavaのshort値に設定します。 データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getShort(int)

setInt

void setInt(String parameterName, int x) throws SQLException

指定されたパラメータを指定されたJavaのint値に設定します。 データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getInt(int)

setLong

void setLong(String parameterName, long x) throws SQLException

指定されたパラメータを指定されたJavaのlong値に設定します。 データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getLong(int)

setFloat

void setFloat(String parameterName, float x) throws SQLException

指定されたパラメータを指定されたJavaのfloat値に設定します。 データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getFloat(int)

setDouble

void setDouble(String parameterName, double x) throws SQLException

指定されたパラメータを指定されたJavaのdouble値に設定します。 データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

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 - パラメータ値

throws:

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 - パラメータ値

throws:

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 - パラメータ値

throws:

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 - パラメータ値

throws:

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 - パラメータ値

throws:

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 - パラメータ値

throws:

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 - ストリームのバイト数

throws:

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 - ストリームのバイト数

throws:

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型では、小数点以下の桁数。 ほかのすべての型では、この値は無視される。

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• Types
• getObject(int)

setObject

void setObject(String parameterName, Object x, int targetSqlType) throws SQLException

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

パラメータ:

parameterName - パラメータの名前

x - 入力パラメータ値を含むオブジェクト

targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• getObject(int)

setObject

void setObject(String parameterName, Object x) throws SQLException

指定されたパラメータの値を、指定されたオブジェクトで設定します。

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

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

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

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

パラメータ:

parameterName - パラメータの名前

x - 入力パラメータ値を含むオブジェクト

throws:

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 - ストリーム内の文字数

throws:

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オブジェクト

throws:

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オブジェクト

throws:

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オブジェクト

throws:

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値でもない場合は無視される

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

getString

String getString(String parameterName) throws SQLException

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

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

パラメータ:

parameterName - パラメータの名前

戻り値:

パラメータ値。 値がSQL NULLの場合はnull

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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。

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

関連項目:

• Types
• setObject(java.lang.String, java.lang.Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(String parameterName) throws SQLException

JDBC NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。

パラメータ:

parameterName - パラメータの名前

戻り値:

パラメータ値(全精度)。 値がSQL NULLの場合はnull

throws:

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

throws:

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

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

getBlob

Blob getBlob(String parameterName) throws SQLException

JDBC BLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。

パラメータ:

parameterName - パラメータの名前

戻り値:

Javaプログラミング言語のBlobオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull

throws:

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

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4

getArray

Array getArray(String parameterName) throws SQLException

JDBC ARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。

パラメータ:

parameterName - パラメータの名前

戻り値:

Javaプログラミング言語のArrayオブジェクトとして表されたパラメータ値。 値がSQL NULLの場合はnull

throws:

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

throws:

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

throws:

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

throws:

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

throws:

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値が返される

throws:

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値が返される

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ROWIDに変換します。

パラメータ:

parameterName - パラメータの名前

x - パラメータ値

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNString

void setNString(String parameterName, String value) throws SQLException

指定されたパラメータを指定されたStringオブジェクトに設定します。 ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHARに変換します。

パラメータ:

parameterName - 設定されるパラメータの名前。

value - パラメータ値

throws:

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

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException

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

パラメータ:

parameterName - 設定されるパラメータの名前。

value - パラメータ値

length - パラメータ・データ内の文字数。

throws:

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 - パラメータ値

throws:

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 - パラメータ・データ内の文字数。

throws:

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 - パラメータ・データ内のバイト数。

throws:

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 - パラメータ・データ内の文字数。

throws:

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

throws:

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

throws:

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オブジェクト

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementまたはjava.xml.transform.Resultで呼び出された場合、WriterまたはOutputStreamがSQLXMLオブジェクトに対してクローズされていない場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

getSQLXML

SQLXML getSQLXML(int parameterIndex) throws SQLException

指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

戻り値:

SQL XML値をマッピングするSQLXMLオブジェクト

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

getSQLXML

SQLXML getSQLXML(String parameterName) throws SQLException

指定されたSQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。

パラメータ:

parameterName - パラメータの名前

戻り値:

SQL XML値をマッピングするSQLXMLオブジェクト

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

getNString

String getNString(int parameterIndex) throws SQLException

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

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

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

戻り値:

NCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクト

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

関連項目:

• setNString(java.lang.String, java.lang.String)

getNString

String getNString(String parameterName) throws SQLException

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

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

パラメータ:

parameterName - パラメータの名前

戻り値:

NCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクト

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

関連項目:

• setNString(java.lang.String, java.lang.String)

getNCharacterStream

Reader getNCharacterStream(int parameterIndex) throws SQLException

指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。 NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

戻り値:

パラメータ値を格納するjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnull

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

getNCharacterStream

Reader getNCharacterStream(String parameterName) throws SQLException

指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。 NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。

パラメータ:

parameterName - パラメータの名前

戻り値:

パラメータ値を格納するjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnull

throws:

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

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

導入されたバージョン:

1.6

getCharacterStream

Reader getCharacterStream(String parameterName) throws SQLException

指定されたパラメータの値をJavaプログラミング言語のjava.io.Readerオブジェクトとして取り出します。

パラメータ:

parameterName - パラメータの名前

戻り値:

パラメータ値を格納するjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnull

throws:

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オブジェクト

throws:

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オブジェクト

throws:

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 - ストリームのバイト数

throws:

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 - ストリームのバイト数

throws:

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 - ストリーム内の文字数

throws:

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入力ストリーム

throws:

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入力ストリーム

throws:

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オブジェクト

throws:

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 - パラメータ値

throws:

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 - パラメータ値に設定されるデータを含むオブジェクト。

throws:

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 - パラメータ値に設定されるデータを含むオブジェクト。

throws:

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 - パラメータ値に設定されるデータを含むオブジェクト。

throws:

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のインスタンス

throws:

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のインスタンス

throws:

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の場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。

throws:

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型

throws:

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を使用する。

throws:

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以上の数値を指定する

throws:

SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合

導入されたバージョン:

1.8

関連項目:

• JDBCType
• SQLType

registerOutParameter

default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLException

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

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

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

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

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

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

sqlType - SQLTypeによって定義される、OUTパラメータを登録するために使用するJDBC型のコード。

typeName - SQL構造化型の完全指定された名前

throws:

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を使用する。

throws:

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以上の数値を指定する

throws:

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構造化型の完全指定された名前

throws:

SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバが指定されたSqlTypeをサポートしない場合、またはJDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.8

関連項目:

• JDBCType
• SQLType