public interface CallableStatement extends PreparedStatement
{?= call <procedure-name>[(<arg1>,<arg2>, ...)]}
{call <procedure-name>[(<arg1>,<arg2>, ...)]}
INパラメータ値は、PreparedStatementから継承したsetメソッドを使用して設定されます。すべてのOUTパラメータの型はストアド・プロシージャの実行前に登録する必要があります。実行後に、それらの値は、ここで提供されるgetメソッド経由で取り出されます。
CallableStatementは1つのResultSetオブジェクトまたは複数のResultSetオブジェクトを返すことができます。複数のResultSetオブジェクトは、Statementから継承した操作を使用して処理されます。
移植性を高めるため、出力パラメータを取得する前に、呼出しのResultSetオブジェクトと更新カウントを処理するようにします。
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, Blob x)
指定されたパラメータを指定された
java.sql.Blobオブジェクトに設定します。 |
void |
setBlob(String parameterName, InputStream inputStream)
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBlob(String parameterName, InputStream inputStream, long length)
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
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, Clob x)
指定されたパラメータを指定された
java.sql.Clobオブジェクトに設定します。 |
void |
setClob(String parameterName, Reader reader)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setClob(String parameterName, Reader reader, long length)
指定されたパラメータを
Readerオブジェクトに設定します。 |
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, NClob value)
指定されたパラメータを
java.sql.NClobオブジェクトに設定します。 |
void |
setNClob(String parameterName, Reader reader)
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNClob(String parameterName, Reader reader, long length)
指定されたパラメータを
Readerオブジェクトに設定します。 |
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かどうかを取得します。 |
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, setURLaddBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, 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, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeoutisWrapperFor, unwrapvoid 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ドライバがこのデータ型をサポートしていない場合Typesvoid 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ドライバがこのデータ型をサポートしていない場合Typesboolean wasNull()
throws SQLException
NULLかどうかを取得します。このメソッドを呼び出すのは、読込み用メソッドの呼出しのあとでなければいけません。そうでない場合は、nullかどうかを判別するために使用する値がありません。NULLの場合はtrue、そうでない場合はfalseSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた次のものについて呼び出された場合: CallableStatementString getString(int parameterIndex) throws SQLException
CHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
固定長の型のJDBC CHARの場合、返されるStringオブジェクトはデータベースでSQL CHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。
parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setString(java.lang.String, java.lang.String)boolean getBoolean(int parameterIndex)
throws SQLException
BITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合はfalseSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setBoolean(java.lang.String, boolean)byte getByte(int parameterIndex)
throws SQLException
TINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合は0SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setByte(java.lang.String, byte)short getShort(int parameterIndex)
throws SQLException
SMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合は0SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setShort(java.lang.String, short)int getInt(int parameterIndex)
throws SQLException
INTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合は0SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setInt(java.lang.String, int)long getLong(int parameterIndex)
throws SQLException
BIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合は0SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setLong(java.lang.String, long)float getFloat(int parameterIndex)
throws SQLException
FLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合は0SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setFloat(java.lang.String, float)double getDouble(int parameterIndex)
throws SQLException
DOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合は0SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setDouble(java.lang.String, double)@Deprecated BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException
getBigDecimal(int parameterIndex)またはgetBigDecimal(String parameterName)を使用してくださいNUMERICパラメータの値を、scaleで指定された小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするscale - 小数点以下の桁数NULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setBigDecimal(java.lang.String, java.math.BigDecimal)byte[] getBytes(int parameterIndex)
throws SQLException
BINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setBytes(java.lang.String, byte[])Date getDate(int parameterIndex) throws SQLException
DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setDate(java.lang.String, java.sql.Date)Time getTime(int parameterIndex) throws SQLException
TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setTime(java.lang.String, java.sql.Time)Timestamp getTimestamp(int parameterIndex) throws SQLException
TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setTimestamp(java.lang.String, java.sql.Timestamp)Object getObject(int parameterIndex) throws SQLException
Objectとして取り出します。値がSQL NULLの場合、ドライバはJava nullを返します。
このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。
parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするjava.lang.ObjectSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合Types、setObject(java.lang.String, java.lang.Object, int, int)BigDecimal getBigDecimal(int parameterIndex) throws SQLException
NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setBigDecimal(java.lang.String, java.math.BigDecimal)Object getObject(int parameterIndex, Map<String,Class<?>> map) throws SQLException
parameterIndexの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。
このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。
parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするmap - SQLの型名からJavaクラスへのマッピングjava.lang.ObjectSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setObject(java.lang.String, java.lang.Object, int, int)Ref getRef(int parameterIndex) throws SQLException
REF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするRefオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Blob getBlob(int parameterIndex) throws SQLException
BLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするBlobオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Clob getClob(int parameterIndex) throws SQLException
CLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするClobオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Array getArray(int parameterIndex) throws SQLException
ARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするArrayオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Date getDate(int parameterIndex, Calendar cal) throws SQLException
DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して日付を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするcal - ドライバが日付を作成するために使用するCalendarオブジェクトNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setDate(java.lang.String, java.sql.Date)Time getTime(int parameterIndex, Calendar cal) throws SQLException
TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して時間を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするcal - ドライバが時間を作成するために使用するCalendarオブジェクトNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setTime(java.lang.String, java.sql.Time)Timestamp getTimestamp(int parameterIndex, Calendar cal) throws SQLException
TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮してタイムスタンプを計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするcal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクトNULLの場合はnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合setTimestamp(java.lang.String, java.sql.Timestamp)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ドライバがこのデータ型をサポートしていない場合Typesvoid 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ドライバがこのメソッドをサポートしていない場合Typesvoid 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ドライバがこのメソッドをサポートしていない場合Typesvoid registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException
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ドライバがこのメソッドをサポートしていない場合TypesURL getURL(int parameterIndex) throws SQLException
DATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるDATALINK値を表すjava.net.URLオブジェクト。SQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、または返されるURLがJavaプラットフォームで有効なURLではない場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setURL(java.lang.String, java.net.URL)void setURL(String parameterName, URL val) throws SQLException
java.net.URLオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL DATALINK値に変換します。parameterName - パラメータの名前val - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、またはURLが無効の場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getURL(int)void setNull(String parameterName, int sqlType) throws SQLException
NULLに設定します。
注: パラメータのSQLの型を指定する必要があります。
parameterName - パラメータの名前sqlType - 次で定義されるSQL型コード: java.sql.TypesSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setBoolean(String parameterName, boolean x) throws SQLException
boolean値に設定します。データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getBoolean(int)void setByte(String parameterName, byte x) throws SQLException
byte値に設定します。データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getByte(int)void setShort(String parameterName, short x) throws SQLException
short値に設定します。データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getShort(int)void setInt(String parameterName, int x) throws SQLException
int値に設定します。データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getInt(int)void setLong(String parameterName, long x) throws SQLException
long値に設定します。データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getLong(int)void setFloat(String parameterName, float x) throws SQLException
float値に設定します。データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getFloat(int)void setDouble(String parameterName, double x) throws SQLException
double値に設定します。データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getDouble(int)void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
java.math.BigDecimal値に設定します。データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getBigDecimal(int, int)void setString(String parameterName, String x) throws SQLException
String値に設定します。データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getString(int)void setBytes(String parameterName, byte[] x) throws SQLException
VARBINARYまたはLONGVARBINARY (ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getBytes(int)void setDate(String parameterName, Date x) throws SQLException
java.sql.Date値に設定します。データベースに送るときに、ドライバはこれをSQL DATE値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getDate(int)void setTime(String parameterName, Time x) throws SQLException
java.sql.Time値に設定します。データベースに送るときに、ドライバはこれをSQL TIME値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getTime(int)void setTimestamp(String parameterName, Timestamp x) throws SQLException
java.sql.Timestamp値に設定します。データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getTimestamp(int)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ドライバがこのメソッドをサポートしない場合void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
parameterName - パラメータの名前x - バイナリ・パラメータ値を含むJava入力ストリームlength - ストリームのバイト数SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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をサポートしない場合Types、getObject(int)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をサポートしない場合getObject(int)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ドライバがこのメソッドをサポートしない場合getObject(int)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ドライバがこのメソッドをサポートしない場合void setDate(String parameterName, Date x, Calendar cal) throws SQLException
Calendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。ドライバはCalendarオブジェクトを使用してSQL DATE値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。parameterName - パラメータの名前x - パラメータ値cal - ドライバが日付を作成するために使用するCalendarオブジェクトSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getDate(int)void setTime(String parameterName, Time x, Calendar cal) throws SQLException
Calendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。ドライバはCalendarオブジェクトを使用してSQL TIME値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して時間を計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。parameterName - パラメータの名前x - パラメータ値cal - ドライバが時間を作成するために使用するCalendarオブジェクトSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getTime(int)void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
Calendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。ドライバはCalendarオブジェクトを使用してSQL TIMESTAMP値を作成し、続いてそれをデータベースに送ります。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。parameterName - パラメータの名前x - パラメータ値cal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクトSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合getTimestamp(int)void setNull(String parameterName, int sqlType, String typeName) throws SQLException
NULLに設定します。ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用するべきです。ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。
注: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全指定のSQL型名を指定しなければいけません。ユーザー定義型の場合、名前はパラメータ自体の型名です。REFパラメータの場合、名前は参照される型の型名です。
ユーザー定義パラメータおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。パラメータがユーザー定義の型またはREF型を持たない場合、指定されたtypeNameは無視されます。
parameterName - パラメータの名前sqlType - 次からの値: java.sql.TypestypeName - SQLユーザー定義型の完全指定された名前。パラメータがユーザー定義型でもSQL REF値でもない場合は無視されるSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合String getString(String parameterName) throws SQLException
CHAR、VARCHAR、またはLONGVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
固定長の型のJDBC CHARの場合、返されるStringオブジェクトはデータベースでSQL CHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。
parameterName - パラメータの名前NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setString(java.lang.String, java.lang.String)boolean getBoolean(String parameterName) throws SQLException
BITまたはBOOLEANパラメータの値を、Javaプログラミング言語のbooleanとして取り出します。parameterName - パラメータの名前NULLの場合はfalseSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setBoolean(java.lang.String, boolean)byte getByte(String parameterName) throws SQLException
TINYINTパラメータの値を、Javaプログラミング言語のbyteとして取り出します。parameterName - パラメータの名前NULLの場合は0SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setByte(java.lang.String, byte)short getShort(String parameterName) throws SQLException
SMALLINTパラメータの値を、Javaプログラミング言語のshortとして取り出します。parameterName - パラメータの名前NULLの場合は0SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setShort(java.lang.String, short)int getInt(String parameterName) throws SQLException
INTEGERパラメータの値を、Javaプログラミング言語のintとして取り出します。parameterName - パラメータの名前NULLの場合は0SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setInt(java.lang.String, int)long getLong(String parameterName) throws SQLException
BIGINTパラメータの値を、Javaプログラミング言語のlongとして取り出します。parameterName - パラメータの名前NULLの場合は0SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setLong(java.lang.String, long)float getFloat(String parameterName) throws SQLException
FLOATパラメータの値を、Javaプログラミング言語のfloatとして取り出します。parameterName - パラメータの名前NULLの場合は0SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setFloat(java.lang.String, float)double getDouble(String parameterName) throws SQLException
DOUBLEパラメータの値を、Javaプログラミング言語のdoubleとして取り出します。parameterName - パラメータの名前NULLの場合は0SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setDouble(java.lang.String, double)byte[] getBytes(String parameterName) throws SQLException
BINARYまたはVARBINARYパラメータの値を、Javaプログラミング言語のbyte値の配列として取り出します。parameterName - パラメータの名前NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setBytes(java.lang.String, byte[])Date getDate(String parameterName) throws SQLException
DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。parameterName - パラメータの名前NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setDate(java.lang.String, java.sql.Date)Time getTime(String parameterName) throws SQLException
TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。parameterName - パラメータの名前NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setTime(java.lang.String, java.sql.Time)Timestamp getTimestamp(String parameterName) throws SQLException
TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。parameterName - パラメータの名前NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setTimestamp(java.lang.String, java.sql.Timestamp)Object getObject(String parameterName) throws SQLException
Objectとして取り出します。値がSQL NULLの場合、ドライバはJava nullを返します。
このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。
parameterName - パラメータの名前java.lang.Object。SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Types、setObject(java.lang.String, java.lang.Object, int, int)BigDecimal getBigDecimal(String parameterName) throws SQLException
NUMERICパラメータの値を、その値と同じ小数点以下の桁数を持つjava.math.BigDecimalオブジェクトとして取り出します。parameterName - パラメータの名前NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setBigDecimal(java.lang.String, java.math.BigDecimal)Object getObject(String parameterName, Map<String,Class<?>> map) throws SQLException
parameterNameの値を表すオブジェクトを返し、mapを使用してそのパラメータ値のカスタム・マッピングを行います。
このメソッドは、Javaオブジェクトを返します。そのオブジェクトの型は、registerOutParameterメソッドを使用してこのパラメータに登録されたJDBCの型に対応します。ターゲットのJDBCの型をjava.sql.Types.OTHERとして登録することで、このメソッドを使用してデータベース固有の抽象データ型を読み込むことができます。
parameterName - パラメータの名前map - SQLの型名からJavaクラスへのマッピングjava.lang.ObjectSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setObject(java.lang.String, java.lang.Object, int, int)Ref getRef(String parameterName) throws SQLException
REF(<structured-type>)パラメータの値を、Javaプログラミング言語のRefオブジェクトとして取り出します。parameterName - パラメータの名前Refオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Blob getBlob(String parameterName) throws SQLException
BLOBパラメータの値を、Javaプログラミング言語のBlobオブジェクトとして取り出します。parameterName - パラメータの名前Blobオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Clob getClob(String parameterName) throws SQLException
CLOBパラメータの値を、Javaプログラミング言語のjava.sql.Clobオブジェクトとして取り出します。parameterName - パラメータの名前Clobオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Array getArray(String parameterName) throws SQLException
ARRAYパラメータの値を、Javaプログラミング言語のArrayオブジェクトとして取り出します。parameterName - パラメータの名前Arrayオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Date getDate(String parameterName, Calendar cal) throws SQLException
DATEパラメータの値をjava.sql.Dateオブジェクトとして取り出します。日付の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して日付を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。parameterName - パラメータの名前cal - ドライバが日付を作成するために使用するCalendarオブジェクトNULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setDate(java.lang.String, java.sql.Date)Time getTime(String parameterName, Calendar cal) throws SQLException
TIMEパラメータの値をjava.sql.Timeオブジェクトとして取り出します。時間の作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して時間を計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。parameterName - パラメータの名前cal - ドライバが時間を作成するために使用するCalendarオブジェクトNULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setTime(java.lang.String, java.sql.Time)Timestamp getTimestamp(String parameterName, Calendar cal) throws SQLException
TIMESTAMPパラメータの値をjava.sql.Timestampオブジェクトとして取り出します。Timestampオブジェクトの作成には、指定されたCalendarオブジェクトを使用します。Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮してタイムスタンプを計算できます。Calendarオブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。parameterName - パラメータの名前cal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクトNULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setTimestamp(java.lang.String, java.sql.Timestamp)URL getURL(String parameterName) throws SQLException
DATALINKパラメータの値をjava.net.URLオブジェクトとして取り出します。parameterName - パラメータの名前java.net.URLオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、またはURLに問題がある場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setURL(java.lang.String, java.net.URL)RowId getRowId(int parameterIndex) throws SQLException
ROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるROWID値を表すRowIdオブジェクト。パラメータにSQL NULLを含む場合、null値が返されるSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合RowId getRowId(String parameterName) throws SQLException
ROWIDパラメータの値をjava.sql.RowIdオブジェクトとして取り出します。parameterName - パラメータの名前ROWID値を表すRowIdオブジェクト。パラメータにSQL NULLを含む場合、null値が返されるSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setRowId(String parameterName, RowId x) throws SQLException
java.sql.RowIdオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL ROWID値に変換します。parameterName - パラメータの名前x - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setNString(String parameterName, String value) throws SQLException
Stringオブジェクトに設定します。ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHARに変換します。parameterName - 設定されるパラメータの名前。value - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Readerオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。parameterName - 設定されるパラメータの名前。value - パラメータ値length - パラメータ・データ内の文字数SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setNClob(String parameterName, NClob value) throws SQLException
java.sql.NClobオブジェクトに設定します。このオブジェクトは、java.sql.NClobインタフェースを実装します。このNClobオブジェクトは、SQL NCLOBにマッピングされます。parameterName - 設定されるパラメータの名前。value - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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が指定されたパラメータに対応しない場合、指定されたlengthが0より小さい場合、inputStream内のバイト数が指定されたlengthに一致しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合NClob getNClob(int parameterIndex) throws SQLException
NCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、などとするNClobオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合NClob getNClob(String parameterName) throws SQLException
NCLOBパラメータの値を、Javaプログラミング言語のjava.sql.NClobオブジェクトとして取り出します。parameterName - パラメータの名前NClobオブジェクトとして表されたパラメータ値。値がSQL NULLの場合はnullSQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合SQLXML getSQLXML(int parameterIndex) throws SQLException
SQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるSQL XML値をマッピングするSQLXMLオブジェクトSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合SQLXML getSQLXML(String parameterName) throws SQLException
SQL XMLパラメータの値を、Javaプログラミング言語のjava.sql.SQLXMLオブジェクトとして取り出します。parameterName - パラメータの名前SQL XML値をマッピングするSQLXMLオブジェクトSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合String getNString(int parameterIndex) throws SQLException
NCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
固定長の型のJDBC NCHARの場合、返されるStringオブジェクトはデータベースでSQL NCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。
parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるNCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクトSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setNString(java.lang.String, java.lang.String)String getNString(String parameterName) throws SQLException
NCHAR、NVARCHAR、またはLONGNVARCHARパラメータの値を、Javaプログラミング言語のStringとして取り出します。
固定長の型のJDBC NCHARの場合、返されるStringオブジェクトはデータベースでSQL NCHAR値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。
parameterName - パラメータの名前NCHAR、NVARCHAR、またはLONGNVARCHAR値をマッピングするStringオブジェクトSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合setNString(java.lang.String, java.lang.String)Reader getNCharacterStream(int parameterIndex) throws SQLException
java.io.Readerオブジェクトとして取得します。NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Reader getNCharacterStream(String parameterName) throws SQLException
java.io.Readerオブジェクトとして取得します。NCHAR、NVARCHAR、およびLONGNVARCHARパラメータにアクセスするときに使用します。parameterName - パラメータの名前java.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合Reader getCharacterStream(int parameterIndex) throws SQLException
java.io.Readerオブジェクトとして取得します。parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるjava.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnullSQLException - parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合Reader getCharacterStream(String parameterName) throws SQLException
java.io.Readerオブジェクトとして取得します。parameterName - パラメータの名前java.io.Readerオブジェクト。値がSQL NULLの場合、返される値はJavaプログラミング言語のnullSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setBlob(String parameterName, Blob x) throws SQLException
java.sql.Blobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。parameterName - パラメータの名前x - SQL BLOB値をマッピングするBlobオブジェクトSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setClob(String parameterName, Clob x) throws SQLException
java.sql.Clobオブジェクトに設定します。データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。parameterName - パラメータの名前x - SQL CLOB値をマッピングするClobオブジェクトSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setBinaryStream(String parameterName, InputStream x, long length) throws SQLException
LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
parameterName - パラメータの名前x - バイナリ・パラメータ値を含むJava入力ストリームlength - ストリームのバイト数SQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setBinaryStream(String parameterName, InputStream x) throws SQLException
LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンのsetBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。
parameterName - パラメータの名前x - バイナリ・パラメータ値を含むJava入力ストリームSQLException - parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setNCharacterStream(String parameterName, Reader value) throws SQLException
Readerオブジェクトに設定します。Readerは、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。
注: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
注: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。
parameterName - パラメータの名前value - パラメータ値SQLException - parameterNameが指定されたパラメータに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合<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データ型を表すクラスtypeのインスタンスSQLException - 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合<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データ型を表すクラスtypeのインスタンスSQLException - 変換がサポートされていない場合、typeがnullの場合、またはほかのエラーが発生した場合。この例外のgetCause()メソッドにより、より詳細な例外が提供されることがある(たとえば変換エラーが発生した場合)SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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をサポートしない場合JDBCType, SQLTypedefault 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をサポートしない場合JDBCType, SQLTypedefault 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をサポートしない場合JDBCType, SQLTypedefault 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をサポートしない場合JDBCType, SQLTypedefault 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をサポートしない場合JDBCType, SQLTypedefault 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ドライバがこのメソッドをサポートしない場合JDBCType, SQLTypedefault 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ドライバがこのメソッドをサポートしない場合JDBCType, SQLTypedefault void registerOutParameter(String parameterName, SQLType sqlType, String typeName) throws SQLException
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ドライバがこのメソッドをサポートしない場合JDBCType, SQLType バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.