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)
指定された出力パラメータを登録します。
|
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)
指定された出力パラメータを登録します。
|
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)
指定されたパラメータの値を、指定されたオブジェクトで設定します。
|
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, 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, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL
addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, execute, execute, execute, execute, executeBatch, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, 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)
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.lang
オブジェクトを使用する必要があります。
指定された 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
- targetSqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、または STRUCT
で、JDBC ドライバがこのデータ型をサポートしていない場合Types
、getObject(int)
void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
setObject
メソッドに似ていますが、scale に 0 を仮定している点が異なります。parameterName
- パラメータの名前x
- 入力パラメータ値を含むオブジェクトtargetSqlType
- データベースに送られる (java.sql.Types で定義される) SQL 型SQLException
- parameterName が指定されたパラメータに対応しない場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた次のもので呼び出された場合: CallableStatement
SQLFeatureNotSupportedException
- targetSqlType
のデータ型が、ARRAY
、BLOB
、CLOB
、DATALINK
、JAVA_OBJECT
、NCHAR
、NCLOB
、NVARCHAR
、LONGNVARCHAR
、REF
、ROWID
、SQLXML
、または STRUCT
で、JDBC ドライバがこのデータ型をサポートしていない場合getObject(int)
void setObject(String parameterName, Object x) throws SQLException
Object
型である必要があります。したがって、組み込み型の場合、等価な java.lang
オブジェクトを使用する必要があります。
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
SQLExceptionif
- parameterName が指定されたパラメータに対応しない場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement
で呼び出された場合SQLFeatureNotSupportedException
- JDBC ドライバがこのメソッドをサポートしない場合SQLException
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
をサポートする必要があります。ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。
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
をサポートする必要があります。ほかの変換がサポートされている場合もあり、それらはベンダーによって定義されます。
parameterName
- パラメータの名前type
- 指定されたパラメータの変換後の Java データ型を表すクラスtype
のインスタンスSQLException
- 変換がサポートされていない場合、type が null の場合、またはほかのエラーが発生した場合。この例外の getCause() メソッドにより、より詳細な例外が提供されることがある (たとえば変換エラーが発生した場合)SQLFeatureNotSupportedException
- JDBC ドライバがこのメソッドをサポートしない場合 バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.