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, setURL
addBatch, 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, setQueryTimeout
isWrapperFor, unwrap
void registerOutParameter(int parameterIndex, int sqlType) throws SQLException
parameterIndex
のOUTパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlType
はjava.sql.Types.OTHER
でなければいけません。getObject(int)
メソッドはその値を取り出します。
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするsqlType
- java.sql.Types
によって定義されるJDBC型のコード。パラメータがJDBC型NUMERIC
またはDECIMAL
である場合、スケール値を受け入れるバージョンのregisterOutParameter
を使用するSQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- sqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、またはSTRUCT
で、JDBCドライバがこのデータ型をサポートしていない場合Types
void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException
parameterIndex
のパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
パラメータがJDBCの型NUMERIC
またはDECIMAL
の場合は、このバージョンのregisterOutParameter
を使用しなければいけません。
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするsqlType
- java.sql.Types
によって定義されるSQL型のコード。scale
- 希望の小数点以下の桁数。0以上の数値を指定するSQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- sqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、またはSTRUCT
で、JDBCドライバがこのデータ型をサポートしていない場合Types
boolean wasNull() throws SQLException
NULL
かどうかを取得します。このメソッドを呼び出すのは、読込み用メソッドの呼出しのあとでなければいけません。そうでない場合は、null
かどうかを判別するために使用する値がありません。NULL
の場合はtrue
、そうでない場合はfalse
SQLException
- データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされた次のものについて呼び出された場合: CallableStatement
String getString(int parameterIndex) throws SQLException
CHAR
、VARCHAR
、またはLONGVARCHAR
パラメータの値を、Javaプログラミング言語のString
として取り出します。
固定長の型のJDBC CHAR
の場合、返されるString
オブジェクトはデータベースでSQL CHAR
値が持っていた値と正確に同じ値(データベースが付加するパディングを含む)を持ちます。
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合はnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setString(java.lang.String, java.lang.String)
boolean getBoolean(int parameterIndex) throws SQLException
BIT
またはBOOLEAN
パラメータの値を、Javaプログラミング言語のboolean
として取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合はfalse
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setBoolean(java.lang.String, boolean)
byte getByte(int parameterIndex) throws SQLException
TINYINT
パラメータの値を、Javaプログラミング言語のbyte
として取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合は0
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setByte(java.lang.String, byte)
short getShort(int parameterIndex) throws SQLException
SMALLINT
パラメータの値を、Javaプログラミング言語のshort
として取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合は0
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setShort(java.lang.String, short)
int getInt(int parameterIndex) throws SQLException
INTEGER
パラメータの値を、Javaプログラミング言語のint
として取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合は0
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setInt(java.lang.String, int)
long getLong(int parameterIndex) throws SQLException
BIGINT
パラメータの値を、Javaプログラミング言語のlong
として取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合は0
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setLong(java.lang.String, long)
float getFloat(int parameterIndex) throws SQLException
FLOAT
パラメータの値を、Javaプログラミング言語のfloat
として取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合は0
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setFloat(java.lang.String, float)
double getDouble(int parameterIndex) throws SQLException
DOUBLE
パラメータの値を、Javaプログラミング言語のdouble
として取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合は0
SQLException
- 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
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setBytes(java.lang.String, byte[])
Date getDate(int parameterIndex) throws SQLException
DATE
パラメータの値をjava.sql.Date
オブジェクトとして取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合はnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setDate(java.lang.String, java.sql.Date)
Time getTime(int parameterIndex) throws SQLException
TIME
パラメータの値をjava.sql.Time
オブジェクトとして取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合はnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合setTime(java.lang.String, java.sql.Time)
Timestamp getTimestamp(int parameterIndex) throws SQLException
TIMESTAMP
パラメータの値をjava.sql.Timestamp
オブジェクトとして取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするNULL
の場合はnull
SQLException
- 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.Object
SQLException
- 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
の場合はnull
SQLException
- 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.Object
SQLException
- 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
の場合はnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Blob getBlob(int parameterIndex) throws SQLException
BLOB
パラメータの値を、Javaプログラミング言語のBlob
オブジェクトとして取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするBlob
オブジェクトとして表されたパラメータ値。値がSQL NULL
の場合はnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Clob getClob(int parameterIndex) throws SQLException
CLOB
パラメータの値を、Javaプログラミング言語のjava.sql.Clob
オブジェクトとして取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするClob
オブジェクトとして表されたパラメータ値。値がSQL NULL
の場合はnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Array getArray(int parameterIndex) throws SQLException
ARRAY
パラメータの値を、Javaプログラミング言語のArray
オブジェクトとして取り出します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするArray
オブジェクトとして表されたパラメータ値。値がSQL NULL
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- 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ドライバがこのデータ型をサポートしていない場合Types
void registerOutParameter(String parameterName, int sqlType) throws SQLException
parameterName
という名前のOUTパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlType
はjava.sql.Types.OTHER
でなければいけません。getObject(int)
メソッドはその値を取り出します。
parameterName
- パラメータの名前sqlType
- java.sql.Types
によって定義されるJDBC型のコード。パラメータがJDBC型NUMERIC
またはDECIMAL
である場合、スケール値を受け入れるバージョンのregisterOutParameter
を使用するSQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- sqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、またはSTRUCT
で、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合Types
void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException
parameterName
という名前のパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
パラメータがJDBCの型NUMERIC
またはDECIMAL
の場合は、このバージョンのregisterOutParameter
を使用しなければいけません。
parameterName
- パラメータの名前sqlType
- java.sql.Types
によって定義されるSQL型のコード。scale
- 希望の小数点以下の桁数。0以上の数値を指定するSQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- sqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、またはSTRUCT
で、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合Types
void 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ドライバがこのメソッドをサポートしていない場合Types
URL 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.Types
SQLException
- 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.Types
typeName
- 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
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setString(java.lang.String, java.lang.String)
boolean getBoolean(String parameterName) throws SQLException
BIT
またはBOOLEAN
パラメータの値を、Javaプログラミング言語のboolean
として取り出します。parameterName
- パラメータの名前NULL
の場合はfalse
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setBoolean(java.lang.String, boolean)
byte getByte(String parameterName) throws SQLException
TINYINT
パラメータの値を、Javaプログラミング言語のbyte
として取り出します。parameterName
- パラメータの名前NULL
の場合は0
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setByte(java.lang.String, byte)
short getShort(String parameterName) throws SQLException
SMALLINT
パラメータの値を、Javaプログラミング言語のshort
として取り出します。parameterName
- パラメータの名前NULL
の場合は0
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setShort(java.lang.String, short)
int getInt(String parameterName) throws SQLException
INTEGER
パラメータの値を、Javaプログラミング言語のint
として取り出します。parameterName
- パラメータの名前NULL
の場合は0
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setInt(java.lang.String, int)
long getLong(String parameterName) throws SQLException
BIGINT
パラメータの値を、Javaプログラミング言語のlong
として取り出します。parameterName
- パラメータの名前NULL
の場合は0
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setLong(java.lang.String, long)
float getFloat(String parameterName) throws SQLException
FLOAT
パラメータの値を、Javaプログラミング言語のfloat
として取り出します。parameterName
- パラメータの名前NULL
の場合は0
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setFloat(java.lang.String, float)
double getDouble(String parameterName) throws SQLException
DOUBLE
パラメータの値を、Javaプログラミング言語のdouble
として取り出します。parameterName
- パラメータの名前NULL
の場合は0
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setDouble(java.lang.String, double)
byte[] getBytes(String parameterName) throws SQLException
BINARY
またはVARBINARY
パラメータの値を、Javaプログラミング言語のbyte
値の配列として取り出します。parameterName
- パラメータの名前NULL
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setBytes(java.lang.String, byte[])
Date getDate(String parameterName) throws SQLException
DATE
パラメータの値をjava.sql.Date
オブジェクトとして取り出します。parameterName
- パラメータの名前NULL
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setDate(java.lang.String, java.sql.Date)
Time getTime(String parameterName) throws SQLException
TIME
パラメータの値をjava.sql.Time
オブジェクトとして取り出します。parameterName
- パラメータの名前NULL
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合setTime(java.lang.String, java.sql.Time)
Timestamp getTimestamp(String parameterName) throws SQLException
TIMESTAMP
パラメータの値をjava.sql.Timestamp
オブジェクトとして取り出します。parameterName
- パラメータの名前NULL
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- 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.Object
SQLException
- 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
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Blob getBlob(String parameterName) throws SQLException
BLOB
パラメータの値を、Javaプログラミング言語のBlob
オブジェクトとして取り出します。parameterName
- パラメータの名前Blob
オブジェクトとして表されたパラメータ値。値がSQL NULL
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Clob getClob(String parameterName) throws SQLException
CLOB
パラメータの値を、Javaプログラミング言語のjava.sql.Clob
オブジェクトとして取り出します。parameterName
- パラメータの名前Clob
オブジェクトとして表されたパラメータ値。値がSQL NULL
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Array getArray(String parameterName) throws SQLException
ARRAY
パラメータの値を、Javaプログラミング言語のArray
オブジェクトとして取り出します。parameterName
- パラメータの名前Array
オブジェクトとして表されたパラメータ値。値がSQL NULL
の場合はnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Date getDate(String parameterName, Calendar cal) throws SQLException
DATE
パラメータの値をjava.sql.Date
オブジェクトとして取り出します。日付の作成には、指定されたCalendar
オブジェクトを使用します。Calendar
オブジェクトを使用すると、ドライバはカスタム・タイムゾーンおよびロケールを考慮して日付を計算できます。Calendar
オブジェクトを指定しない場合、ドライバはデフォルトのタイムゾーンおよびロケールを使用します。parameterName
- パラメータの名前cal
- ドライバが日付を作成するために使用するCalendar
オブジェクトNULL
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- 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
の場合はnull
SQLException
- parameterIndexが有効でない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合NClob getNClob(String parameterName) throws SQLException
NCLOB
パラメータの値を、Javaプログラミング言語のjava.sql.NClob
オブジェクトとして取り出します。parameterName
- パラメータの名前NClob
オブジェクトとして表されたパラメータ値。値がSQL NULL
の場合はnull
SQLException
- 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プログラミング言語のnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Reader getNCharacterStream(String parameterName) throws SQLException
java.io.Reader
オブジェクトとして取得します。NCHAR
、NVARCHAR
、およびLONGNVARCHAR
パラメータにアクセスするときに使用します。parameterName
- パラメータの名前java.io.Reader
オブジェクト。値がSQL NULL
の場合、返される値はJavaプログラミング言語のnull
SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合Reader getCharacterStream(int parameterIndex) throws SQLException
java.io.Reader
オブジェクトとして取得します。parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、... となるjava.io.Reader
オブジェクト。値がSQL NULL
の場合、返される値はJavaプログラミング言語のnull
SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合Reader getCharacterStream(String parameterName) throws SQLException
java.io.Reader
オブジェクトとして取得します。parameterName
- パラメータの名前java.io.Reader
オブジェクト。値がSQL NULL
の場合、返される値はJavaプログラミング言語のnull
SQLException
- 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
, SQLType
default void setObject(String parameterName, Object x, SQLType targetSqlType) throws SQLException
setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)
に似ていますが、scaleに0を仮定している点が異なります。
デフォルト実装はSQLFeatureNotSupportedException
をスローします
parameterName
- パラメータの名前x
- 入力パラメータ値を含むオブジェクトtargetSqlType
- データベースに送られるSQL型SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバが指定されたtargetSqlTypeをサポートしない場合JDBCType
, SQLType
default void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLException
parameterIndex
のOUTパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlType
にはJDBCType.OTHER
またはJDBCドライバでサポートされているSQLType
を指定してください。getObject(int)
メソッドはその値を取り出します。
デフォルト実装はSQLFeatureNotSupportedException
をスローします
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするsqlType
- SQLType
によって定義される、OUTパラメータを登録するために使用するJDBC型のコード。パラメータがJDBC型JDBCType.NUMERIC
またはJDBCType.DECIMAL
である場合、スケール値を受け入れるバージョンのregisterOutParameter
を使用する。SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバが指定されたSqlTypeをサポートしない場合JDBCType
, SQLType
default void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) throws SQLException
parameterIndex
のパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
パラメータがJDBC型JDBCType.NUMERIC
またはJDBCType.DECIMAL
の場合は、このバージョンのregisterOutParameter
を使用するようにしてください。
デフォルト実装はSQLFeatureNotSupportedException
をスローします
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、などとするsqlType
- SQLType
によって定義される、OUTパラメータを登録するために使用するJDBC型のコード。scale
- 希望の小数点以下の桁数。0以上の数値を指定するSQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバが指定されたSqlTypeをサポートしない場合JDBCType
, SQLType
default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName) throws SQLException
REF
出力パラメータには、このバージョンのregisterOutParameter
メソッドを使用します。ユーザー定義型の例には、STRUCT
、DISTINCT
、JAVA_OBJECT
、および名前付き配列があります。
ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
ユーザー定義パラメータの場合は、そのパラメータの完全指定SQL型名も指定する必要があります。一方、REF
パラメータの場合は、参照する型の完全指定型名を指定する必要があります。型コードや型名の情報を必要としないJDBCドライバはそれを無視します。ただし、移植性を高めるには、アプリケーションはユーザー定義パラメータおよびREF
パラメータに対し、これらの値を提供する必要があります。このメソッドは、ユーザー定義パラメータとREF
パラメータを対象としていますが、任意のJDBC型のパラメータを登録するために使用することもできます。パラメータがユーザー定義の型またはREF
型を持たない場合、typeNameパラメータは無視されます。
注: 出力パラメータの値を読み込むときには、そのパラメータの登録済みSQL型に対応するJava型用の取得メソッドを使用する必要があります。
デフォルト実装はSQLFeatureNotSupportedException
をスローします
parameterIndex
- 最初のパラメータは1、2番目のパラメータは2、... となるsqlType
- SQLType
によって定義される、OUTパラメータを登録するために使用するJDBC型のコード。typeName
- SQL構造化型の完全指定された名前SQLException
- parameterIndexが無効な場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバが指定されたSqlTypeをサポートしない場合JDBCType
, SQLType
default void registerOutParameter(String parameterName, SQLType sqlType) throws SQLException
parameterName
という名前のOUTパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
この出力パラメータに返されることが期待されるJDBC型がこの特定のデータベースに固有である場合、sqlType
にはJDBCType.OTHER
またはJDBCでサポートされているSQLType
を指定できます。getObject(int)
メソッドはその値を取り出します。
デフォルト実装はSQLFeatureNotSupportedException
をスローします
parameterName
- パラメータの名前sqlType
- SQLType
によって定義される、OUTパラメータを登録するために使用するJDBC型のコード。パラメータがJDBC型JDBCType.NUMERIC
またはJDBCType.DECIMAL
である場合、スケール値を受け入れるバージョンのregisterOutParameter
を使用する。SQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバが指定されたSqlTypeをサポートしない場合、またはJDBCドライバがこのメソッドをサポートしない場合JDBCType
, SQLType
default void registerOutParameter(String parameterName, SQLType sqlType, int scale) throws SQLException
parameterName
という名前のパラメータをJDBC型sqlType
として登録します。ストアド・プロシージャが実行される前に、すべてのOUTパラメータを登録する必要があります。
OUTパラメータ用にsqlType
によって指定されたJDBCの型は、そのパラメータの値を読み込むためにget
メソッドで使用する必要のあるJavaの型を判定します。
パラメータがJDBC型JDBCType.NUMERIC
またはJDBCType.DECIMAL
の場合は、このバージョンのregisterOutParameter
を使用するようにしてください。
デフォルト実装はSQLFeatureNotSupportedException
をスローします
parameterName
- パラメータの名前sqlType
- SQLType
によって定義される、OUTパラメータを登録するために使用するJDBC型のコード。scale
- 希望の小数点以下の桁数。0以上の数値を指定するSQLException
- parameterNameが指定されたパラメータに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBCドライバが指定されたSqlTypeをサポートしない場合、またはJDBCドライバがこのメソッドをサポートしない場合JDBCType
, SQLType
default 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.