|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object atg.service.resourcepool.MonitoredCallableStatement
public class MonitoredCallableStatement
This class is a wrapper for java.sql.CallableStatement. All calls are passed through to an embedded instance of java.sql.CallableStatement.
Field Summary | |
---|---|
static java.lang.String |
CLASS_VERSION
Class version string |
Fields inherited from interface java.sql.Statement |
---|
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO |
Constructor Summary | |
---|---|
MonitoredCallableStatement(java.sql.CallableStatement pWrapped,
ApplicationLogging pLog,
ConnectionStats pStats,
java.lang.String pId)
Constructs a new wrapper CallableStatement wrapper |
Method Summary | ||
---|---|---|
void |
addBatch()
Wraps the call to addBatch |
|
void |
addBatch(java.lang.String p0)
Wraps the call to addBatch |
|
void |
cancel()
Wraps the call to cancel |
|
void |
clearBatch()
Wraps the call to clearBatch |
|
void |
clearParameters()
Wraps the call to clearParameters |
|
void |
clearWarnings()
Wraps the call to clearWarnings |
|
void |
close()
Wraps the call to close |
|
boolean |
execute()
Wraps the call to execute |
|
boolean |
execute(java.lang.String p0)
Wraps the call to execute |
|
boolean |
execute(java.lang.String sql,
int autoGeneratedKeys)
Executes the given SQL statement, which may return multiple results, and signals the driver that any auto-generated keys should be made available for retrieval. |
|
boolean |
execute(java.lang.String sql,
int[] columnIndexes)
Executes the given SQL statement, which may return multiple results, and signals the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
|
boolean |
execute(java.lang.String sql,
java.lang.String[] columnNames)
Executes the given SQL statement, which may return multiple results, and signals the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
|
int[] |
executeBatch()
Wraps the call to executeBatch |
|
java.sql.ResultSet |
executeQuery()
Wraps the call to executeQuery |
|
java.sql.ResultSet |
executeQuery(java.lang.String p0)
Wraps the call to executeQuery |
|
int |
executeUpdate()
Wraps the call to executeUpdate |
|
int |
executeUpdate(java.lang.String p0)
Wraps the call to executeUpdate |
|
int |
executeUpdate(java.lang.String sql,
int autoGeneratedKeys)
Executes the given SQL statement and signals the driver with the given flag about whether the auto-generated keys produced by this Statement object
should be made available for retrieval. |
|
int |
executeUpdate(java.lang.String sql,
int[] columnIndexes)
Executes the given SQL statement and signals the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
|
int |
executeUpdate(java.lang.String sql,
java.lang.String[] columnNames)
Executes the given SQL statement and signals the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
|
java.sql.Array |
getArray(int p0)
Wraps the call to getArray |
|
java.sql.Array |
getArray(java.lang.String parameterName)
Retrieves the value of a JDBC ARRAY parameter as an
Array object in the Java programming language. |
|
java.math.BigDecimal |
getBigDecimal(int p0)
Wraps the call to getBigDecimal |
|
java.math.BigDecimal |
getBigDecimal(int p0,
int p1)
Deprecated. |
|
java.math.BigDecimal |
getBigDecimal(java.lang.String parameterName)
Retrieves the value of a JDBC NUMERIC parameter as a
java.math.BigDecimal object with as many digits to the
right of the decimal point as the value contains. |
|
java.sql.Blob |
getBlob(int p0)
Wraps the call to getBlob |
|
java.sql.Blob |
getBlob(java.lang.String parameterName)
Retrieves the value of a JDBC BLOB parameter as a
Blob object in the Java programming language. |
|
boolean |
getBoolean(int p0)
Wraps the call to getBoolean |
|
boolean |
getBoolean(java.lang.String parameterName)
Retrieves the value of a JDBC BIT parameter as a
boolean in the Java programming language. |
|
byte |
getByte(int p0)
Wraps the call to getByte |
|
byte |
getByte(java.lang.String parameterName)
Retrieves the value of a JDBC TINYINT parameter as a byte
in the Java programming language. |
|
byte[] |
getBytes(int p0)
Wraps the call to getBytes |
|
byte[] |
getBytes(java.lang.String parameterName)
Retrieves the value of a JDBC BINARY or VARBINARY
parameter as an array of byte values in the Java
programming language. |
|
java.io.Reader |
getCharacterStream(int parameterIndex)
Retrieves the value of the designated parameter as a Reader object in the Java programming language. |
|
java.io.Reader |
getCharacterStream(java.lang.String parameterName)
Retrieves the value of the designated parameter as a Reader object in the Java programming language. |
|
java.sql.Clob |
getClob(int p0)
Wraps the call to getClob |
|
java.sql.Clob |
getClob(java.lang.String parameterName)
Retrieves the value of a JDBC CLOB parameter as a
Clob object in the Java programming language. |
|
java.sql.Connection |
getConnection()
Wraps the call to getConnection |
|
java.sql.Date |
getDate(int p0)
Wraps the call to getDate |
|
java.sql.Date |
getDate(int p0,
java.util.Calendar p1)
Wraps the call to getDate |
|
java.sql.Date |
getDate(java.lang.String parameterName)
Retrieves the value of a JDBC DATE parameter as a
Date object. |
|
java.sql.Date |
getDate(java.lang.String parameterName,
java.util.Calendar cal)
Retrieves the value of a JDBC DATE parameter as a
Date object, using
the given Calendar object
to construct the date. |
|
double |
getDouble(int p0)
Wraps the call to getDouble |
|
double |
getDouble(java.lang.String parameterName)
Retrieves the value of a JDBC DOUBLE parameter as a double
in the Java programming language. |
|
int |
getFetchDirection()
Wraps the call to getFetchDirection |
|
int |
getFetchSize()
Wraps the call to getFetchSize |
|
float |
getFloat(int p0)
Wraps the call to getFloat |
|
float |
getFloat(java.lang.String parameterName)
Retrieves the value of a JDBC FLOAT parameter as a float
in the Java programming language. |
|
java.sql.ResultSet |
getGeneratedKeys()
Retrieves any auto-generated keys created as a result of executing this Statement object. |
|
int |
getInt(int p0)
Wraps the call to getInt |
|
int |
getInt(java.lang.String parameterName)
Retrieves the value of a JDBC INTEGER parameter as an int
in the Java programming language. |
|
long |
getLong(int p0)
Wraps the call to getLong |
|
long |
getLong(java.lang.String parameterName)
Retrieves the value of a JDBC BIGINT parameter as a long
in the Java programming language. |
|
int |
getMaxFieldSize()
Wraps the call to getMaxFieldSize |
|
int |
getMaxRows()
Wraps the call to getMaxRows |
|
java.sql.ResultSetMetaData |
getMetaData()
Wraps the call to getMetaData |
|
boolean |
getMoreResults()
Wraps the call to getMoreResults |
|
boolean |
getMoreResults(int current)
Moves to this Statement object's next result, deals with
any current ResultSet object(s) according to the instructions
specified by the given flag, and returns
true if the next result is a ResultSet object. |
|
java.io.Reader |
getNCharacterStream(int parameterIndex)
Retrieves the value of the designated parameter as a Reader object in the Java programming language. |
|
java.io.Reader |
getNCharacterStream(java.lang.String parameterName)
Retrieves the value of the designated parameter as a Reader object in the Java programming language. |
|
java.sql.NClob |
getNClob(int parameterIndex)
Retrieves the value of the designated JDBC NCLOB parameter as a
java.sql.NClob object in the Java programming language. |
|
java.sql.NClob |
getNClob(java.lang.String parameterName)
Retrieves the value of a JDBC NCLOB parameter as a
java.sql.NClob object in the Java programming language. |
|
java.lang.String |
getNString(int parameterIndex)
Retrieves the value of the designated NCHAR ,
NVARCHAR
or LONGNVARCHAR parameter as
a String in the Java programming language. |
|
java.lang.String |
getNString(java.lang.String parameterName)
Retrieves the value of the designated NCHAR ,
NVARCHAR
or LONGNVARCHAR parameter as
a String in the Java programming language. |
|
java.lang.Object |
getObject(int p0)
Wraps the call to getObject |
|
java.lang.Object |
getObject(int p0,
java.util.Map p1)
Wraps the call to getObject |
|
java.lang.Object |
getObject(java.lang.String parameterName)
Retrieves the value of a parameter as an Object in the Java
programming language. |
|
java.lang.Object |
getObject(java.lang.String parameterName,
java.util.Map map)
Returns an object representing the value of OUT parameter i and uses map for the custom
mapping of the parameter value. |
|
java.sql.ParameterMetaData |
getParameterMetaData()
Retrieves the number, types and properties of this PreparedStatement object's parameters. |
|
int |
getQueryTimeout()
Wraps the call to getQueryTimeout |
|
java.sql.Ref |
getRef(int p0)
Wraps the call to getRef |
|
java.sql.Ref |
getRef(java.lang.String parameterName)
Retrieves the value of a JDBC REF(<structured-type>)
parameter as a Ref object in the Java programming language. |
|
java.sql.ResultSet |
getResultSet()
Wraps the call to getResultSet |
|
int |
getResultSetConcurrency()
Wraps the call to getResultSetConcurrency |
|
int |
getResultSetHoldability()
Retrieves the result set holdability for ResultSet objects
generated by this Statement object. |
|
int |
getResultSetType()
Wraps the call to getResultSetType |
|
java.sql.RowId |
getRowId(int parameterIndex)
Retrieves the value of the designated JDBC ROWID parameter as a
java.sql.RowId object. |
|
java.sql.RowId |
getRowId(java.lang.String parameterName)
Retrieves the value of the designated JDBC ROWID parameter as a
java.sql.RowId object. |
|
short |
getShort(int p0)
Wraps the call to getShort |
|
short |
getShort(java.lang.String parameterName)
Retrieves the value of a JDBC SMALLINT parameter as a short
in the Java programming language. |
|
java.sql.SQLXML |
getSQLXML(int parameterIndex)
Retrieves the value of the designated SQL XML parameter as a
java.sql.SQLXML object in the Java programming language. |
|
java.sql.SQLXML |
getSQLXML(java.lang.String parameterName)
Retrieves the value of the designated SQL XML parameter as a
java.sql.SQLXML object in the Java programming language. |
|
java.lang.String |
getString(int p0)
Wraps the call to getString |
|
java.lang.String |
getString(java.lang.String parameterName)
Retrieves the value of a JDBC CHAR , VARCHAR ,
or LONGVARCHAR parameter as a String in
the Java programming language. |
|
java.sql.Time |
getTime(int p0)
Wraps the call to getTime |
|
java.sql.Time |
getTime(int p0,
java.util.Calendar p1)
Wraps the call to getTime |
|
java.sql.Time |
getTime(java.lang.String parameterName)
Retrieves the value of a JDBC TIME parameter as a
Time object. |
|
java.sql.Time |
getTime(java.lang.String parameterName,
java.util.Calendar cal)
Retrieves the value of a JDBC TIME parameter as a
Time object, using
the given Calendar object
to construct the time. |
|
java.sql.Timestamp |
getTimestamp(int p0)
Wraps the call to getTimestamp |
|
java.sql.Timestamp |
getTimestamp(int p0,
java.util.Calendar p1)
Wraps the call to getTimestamp |
|
java.sql.Timestamp |
getTimestamp(java.lang.String parameterName)
Retrieves the value of a JDBC TIMESTAMP parameter as a
Timestamp object. |
|
java.sql.Timestamp |
getTimestamp(java.lang.String parameterName,
java.util.Calendar cal)
Retrieves the value of a JDBC TIMESTAMP parameter as a
Timestamp object, using
the given Calendar object to construct
the Timestamp object. |
|
int |
getUpdateCount()
Wraps the call to getUpdateCount |
|
java.net.URL |
getURL(int parameterIndex)
Retrieves the value of the designated JDBC DATALINK parameter as a
java.net.URL object. |
|
java.net.URL |
getURL(java.lang.String parameterName)
Retrieves the value of a JDBC DATALINK parameter as a
java.net.URL object. |
|
java.sql.SQLWarning |
getWarnings()
Wraps the call to getWarnings |
|
java.sql.CallableStatement |
getWrapped()
Returns the original statement that this MonitoredCallableStatement is monitoring. |
|
boolean |
isClosed()
Retrieves whether this Statement object has been closed. |
|
boolean |
isPoolable()
Returns a value indicating whether the Statement
is poolable or not. |
|
boolean |
isWrapperFor(java.lang.Class<?> pInterface)
Returns true if this class implements the pInterface argument |
|
void |
registerOutParameter(int p0,
int p1)
Wraps the call to registerOutParameter |
|
void |
registerOutParameter(int p0,
int p1,
int p2)
Wraps the call to registerOutParameter |
|
void |
registerOutParameter(int p0,
int p1,
java.lang.String p2)
Wraps the call to registerOutParameter |
|
void |
registerOutParameter(java.lang.String parameterName,
int sqlType)
Registers the OUT parameter named parameterName to the JDBC type
sqlType . |
|
void |
registerOutParameter(java.lang.String parameterName,
int sqlType,
int scale)
Registers the parameter named parameterName to be of JDBC type
sqlType . |
|
void |
registerOutParameter(java.lang.String parameterName,
int sqlType,
java.lang.String typeName)
Registers the designated output parameter. |
|
void |
setArray(int p0,
java.sql.Array p1)
Wraps the call to setArray |
|
void |
setAsciiStream(int parameterIndex,
java.io.InputStream x)
Sets the designated parameter to the given input stream. |
|
void |
setAsciiStream(int p0,
java.io.InputStream p1,
int p2)
Wraps the call to setAsciiStream |
|
void |
setAsciiStream(int parameterIndex,
java.io.InputStream x,
long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes. |
|
void |
setAsciiStream(java.lang.String parameterName,
java.io.InputStream x)
Sets the designated parameter to the given input stream. |
|
void |
setAsciiStream(java.lang.String parameterName,
java.io.InputStream x,
int length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes. |
|
void |
setAsciiStream(java.lang.String parameterName,
java.io.InputStream x,
long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes. |
|
void |
setBigDecimal(int p0,
java.math.BigDecimal p1)
Wraps the call to setBigDecimal |
|
void |
setBigDecimal(java.lang.String parameterName,
java.math.BigDecimal x)
Sets the designated parameter to the given java.math.BigDecimal value. |
|
void |
setBinaryStream(int parameterIndex,
java.io.InputStream x)
Sets the designated parameter to the given input stream. |
|
void |
setBinaryStream(int p0,
java.io.InputStream p1,
int p2)
Wraps the call to setBinaryStream |
|
void |
setBinaryStream(int parameterIndex,
java.io.InputStream x,
long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes. |
|
void |
setBinaryStream(java.lang.String parameterName,
java.io.InputStream x)
Sets the designated parameter to the given input stream. |
|
void |
setBinaryStream(java.lang.String parameterName,
java.io.InputStream x,
int length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes. |
|
void |
setBinaryStream(java.lang.String parameterName,
java.io.InputStream x,
long length)
Sets the designated parameter to the given input stream, which will have the specified number of bytes. |
|
void |
setBlob(int p0,
java.sql.Blob p1)
Wraps the call to setBlob |
|
void |
setBlob(int parameterIndex,
java.io.InputStream inputStream)
Sets the designated parameter to a InputStream object. |
|
void |
setBlob(int parameterIndex,
java.io.InputStream inputStream,
long length)
Sets the designated parameter to a InputStream object. |
|
void |
setBlob(java.lang.String parameterName,
java.sql.Blob x)
Sets the designated parameter to the given java.sql.Blob object. |
|
void |
setBlob(java.lang.String parameterName,
java.io.InputStream inputStream)
Sets the designated parameter to a InputStream object. |
|
void |
setBlob(java.lang.String parameterName,
java.io.InputStream inputStream,
long length)
Sets the designated parameter to a InputStream object. |
|
void |
setBoolean(int p0,
boolean p1)
Wraps the call to setBoolean |
|
void |
setBoolean(java.lang.String parameterName,
boolean x)
Sets the designated parameter to the given Java boolean value. |
|
void |
setByte(int p0,
byte p1)
Wraps the call to setByte |
|
void |
setByte(java.lang.String parameterName,
byte x)
Sets the designated parameter to the given Java byte value. |
|
void |
setBytes(int p0,
byte[] p1)
Wraps the call to setBytes |
|
void |
setBytes(java.lang.String parameterName,
byte[] x)
Sets the designated parameter to the given Java array of bytes. |
|
void |
setCharacterStream(int parameterIndex,
java.io.Reader reader)
Sets the designated parameter to the given Reader
object. |
|
void |
setCharacterStream(int p0,
java.io.Reader p1,
int p2)
Wraps the call to setCharacterStream |
|
void |
setCharacterStream(int parameterIndex,
java.io.Reader reader,
long length)
Sets the designated parameter to the given Reader
object, which is the given number of characters long. |
|
void |
setCharacterStream(java.lang.String parameterName,
java.io.Reader reader)
Sets the designated parameter to the given Reader
object. |
|
void |
setCharacterStream(java.lang.String parameterName,
java.io.Reader reader,
int length)
Sets the designated parameter to the given Reader
object, which is the given number of characters long. |
|
void |
setCharacterStream(java.lang.String parameterName,
java.io.Reader reader,
long length)
Sets the designated parameter to the given Reader
object, which is the given number of characters long. |
|
void |
setClob(int p0,
java.sql.Clob p1)
Wraps the call to setClob |
|
void |
setClob(int parameterIndex,
java.io.Reader reader)
Sets the designated parameter to a Reader object. |
|
void |
setClob(int parameterIndex,
java.io.Reader reader,
long length)
Sets the designated parameter to a Reader object. |
|
void |
setClob(java.lang.String parameterName,
java.sql.Clob x)
Sets the designated parameter to the given java.sql.Clob object. |
|
void |
setClob(java.lang.String parameterName,
java.io.Reader reader)
Sets the designated parameter to a Reader object. |
|
void |
setClob(java.lang.String parameterName,
java.io.Reader reader,
long length)
Sets the designated parameter to a Reader object. |
|
void |
setCursorName(java.lang.String p0)
Wraps the call to setCursorName |
|
void |
setDate(int p0,
java.sql.Date p1)
Wraps the call to setDate |
|
void |
setDate(int p0,
java.sql.Date p1,
java.util.Calendar p2)
Wraps the call to setDate |
|
void |
setDate(java.lang.String parameterName,
java.sql.Date x)
Sets the designated parameter to the given Date value. |
|
void |
setDate(java.lang.String parameterName,
java.sql.Date x,
java.util.Calendar cal)
Sets the designated parameter to the given Date value,
using the given Calendar object. |
|
void |
setDouble(int p0,
double p1)
Wraps the call to setDouble |
|
void |
setDouble(java.lang.String parameterName,
double x)
Sets the designated parameter to the given Java double value. |
|
void |
setEscapeProcessing(boolean p0)
Wraps the call to setEscapeProcessing |
|
void |
setFetchDirection(int p0)
Wraps the call to setFetchDirection |
|
void |
setFetchSize(int p0)
Wraps the call to setFetchSize |
|
void |
setFloat(int p0,
float p1)
Wraps the call to setFloat |
|
void |
setFloat(java.lang.String parameterName,
float x)
Sets the designated parameter to the given Java float value. |
|
void |
setInt(int p0,
int p1)
Wraps the call to setInt |
|
void |
setInt(java.lang.String parameterName,
int x)
Sets the designated parameter to the given Java int value. |
|
void |
setLong(int p0,
long p1)
Wraps the call to setLong |
|
void |
setLong(java.lang.String parameterName,
long x)
Sets the designated parameter to the given Java long value. |
|
void |
setMaxFieldSize(int p0)
Wraps the call to setMaxFieldSize |
|
void |
setMaxRows(int p0)
Wraps the call to setMaxRows |
|
void |
setNCharacterStream(int parameterIndex,
java.io.Reader value)
Sets the designated parameter to a Reader object. |
|
void |
setNCharacterStream(int parameterIndex,
java.io.Reader value,
long length)
Sets the designated parameter to a Reader object. |
|
void |
setNCharacterStream(java.lang.String parameterName,
java.io.Reader value)
Sets the designated parameter to a Reader object. |
|
void |
setNCharacterStream(java.lang.String parameterName,
java.io.Reader value,
long length)
Sets the designated parameter to a Reader object. |
|
void |
setNClob(int parameterIndex,
java.sql.NClob value)
Sets the designated parameter to a java.sql.NClob object. |
|
void |
setNClob(int parameterIndex,
java.io.Reader reader)
Sets the designated parameter to a Reader object. |
|
void |
setNClob(int parameterIndex,
java.io.Reader reader,
long length)
Sets the designated parameter to a Reader object. |
|
void |
setNClob(java.lang.String parameterName,
java.sql.NClob value)
Sets the designated parameter to a java.sql.NClob object. |
|
void |
setNClob(java.lang.String parameterName,
java.io.Reader reader)
Sets the designated parameter to a Reader object. |
|
void |
setNClob(java.lang.String parameterName,
java.io.Reader reader,
long length)
Sets the designated parameter to a Reader object. |
|
void |
setNString(int parameterIndex,
java.lang.String value)
Sets the designated paramter to the given String object. |
|
void |
setNString(java.lang.String parameterName,
java.lang.String value)
Sets the designated parameter to the given String object. |
|
void |
setNull(int p0,
int p1)
Wraps the call to setNull |
|
void |
setNull(int p0,
int p1,
java.lang.String p2)
Wraps the call to setNull |
|
void |
setNull(java.lang.String parameterName,
int sqlType)
Sets the designated parameter to SQL NULL . |
|
void |
setNull(java.lang.String parameterName,
int sqlType,
java.lang.String typeName)
Sets the designated parameter to SQL NULL . |
|
void |
setObject(int p0,
java.lang.Object p1)
Wraps the call to setObject |
|
void |
setObject(int p0,
java.lang.Object p1,
int p2)
Wraps the call to setObject |
|
void |
setObject(int p0,
java.lang.Object p1,
int p2,
int p3)
Wraps the call to setObject |
|
void |
setObject(java.lang.String parameterName,
java.lang.Object x)
Sets the value of the designated parameter with the given object. |
|
void |
setObject(java.lang.String parameterName,
java.lang.Object x,
int targetSqlType)
Sets the value of the designated parameter with the given object. |
|
void |
setObject(java.lang.String parameterName,
java.lang.Object x,
int targetSqlType,
int scale)
Sets the value of the designated parameter with the given object. |
|
void |
setPoolable(boolean poolable)
Requests that a Statement be pooled or not pooled. |
|
void |
setQueryTimeout(int p0)
Wraps the call to setQueryTimeout |
|
void |
setRef(int p0,
java.sql.Ref p1)
Wraps the call to setRef |
|
void |
setRowId(int parameterIndex,
java.sql.RowId x)
Sets the designated parameter to the given java.sql.RowId object. |
|
void |
setRowId(java.lang.String parameterName,
java.sql.RowId x)
Sets the designated parameter to the given java.sql.RowId object. |
|
void |
setShort(int p0,
short p1)
Wraps the call to setShort |
|
void |
setShort(java.lang.String parameterName,
short x)
Sets the designated parameter to the given Java short value. |
|
void |
setSQLXML(int parameterIndex,
java.sql.SQLXML xmlObject)
Sets the designated parameter to the given java.sql.SQLXML object. |
|
void |
setSQLXML(java.lang.String parameterName,
java.sql.SQLXML xmlObject)
Sets the designated parameter to the given java.sql.SQLXML object. |
|
void |
setString(int p0,
java.lang.String p1)
Wraps the call to setString |
|
void |
setString(java.lang.String parameterName,
java.lang.String x)
Sets the designated parameter to the given Java String value. |
|
void |
setTime(int p0,
java.sql.Time p1)
Wraps the call to setTime |
|
void |
setTime(int p0,
java.sql.Time p1,
java.util.Calendar p2)
Wraps the call to setTime |
|
void |
setTime(java.lang.String parameterName,
java.sql.Time x)
Sets the designated parameter to the given Time value. |
|
void |
setTime(java.lang.String parameterName,
java.sql.Time x,
java.util.Calendar cal)
Sets the designated parameter to the given Time value,
using the given Calendar object. |
|
void |
setTimestamp(int p0,
java.sql.Timestamp p1)
Wraps the call to setTimestamp |
|
void |
setTimestamp(int p0,
java.sql.Timestamp p1,
java.util.Calendar p2)
Wraps the call to setTimestamp |
|
void |
setTimestamp(java.lang.String parameterName,
java.sql.Timestamp x)
Sets the designated parameter to the given Timestamp value. |
|
void |
setTimestamp(java.lang.String parameterName,
java.sql.Timestamp x,
java.util.Calendar cal)
Sets the designated parameter to the given Timestamp value,
using the given Calendar object. |
|
void |
setUnicodeStream(int p0,
java.io.InputStream p1,
int p2)
Wraps the call to setUnicodeStream |
|
void |
setURL(int parameterIndex,
java.net.URL x)
Sets the designated parameter to the given java.net.URL value. |
|
void |
setURL(java.lang.String parameterName,
java.net.URL val)
Sets the designated parameter to the given java.net.URL object. |
|
void |
setWrapped(java.sql.CallableStatement pWrapped)
|
|
|
unwrap(java.lang.Class<T> pInterface)
Returns an object that implements the given interface |
|
boolean |
wasNull()
Wraps the call to wasNull |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static java.lang.String CLASS_VERSION
Constructor Detail |
---|
public MonitoredCallableStatement(java.sql.CallableStatement pWrapped, ApplicationLogging pLog, ConnectionStats pStats, java.lang.String pId)
pWrapped
- the instance being wrappedMethod Detail |
---|
public java.sql.Connection getConnection() throws java.sql.SQLException
getConnection
in interface java.sql.Statement
java.sql.SQLException
public void addBatch() throws java.sql.SQLException
addBatch
in interface java.sql.PreparedStatement
java.sql.SQLException
public void addBatch(java.lang.String p0) throws java.sql.SQLException
addBatch
in interface java.sql.Statement
java.sql.SQLException
public void clearBatch() throws java.sql.SQLException
clearBatch
in interface java.sql.Statement
java.sql.SQLException
public int[] executeBatch() throws java.sql.SQLException
executeBatch
in interface java.sql.Statement
java.sql.SQLException
public java.sql.ResultSet executeQuery(java.lang.String p0) throws java.sql.SQLException
executeQuery
in interface java.sql.Statement
java.sql.SQLException
public int executeUpdate(java.lang.String p0) throws java.sql.SQLException
executeUpdate
in interface java.sql.Statement
java.sql.SQLException
public void close() throws java.sql.SQLException
close
in interface java.sql.Statement
java.sql.SQLException
public int getMaxFieldSize() throws java.sql.SQLException
getMaxFieldSize
in interface java.sql.Statement
java.sql.SQLException
public void setMaxFieldSize(int p0) throws java.sql.SQLException
setMaxFieldSize
in interface java.sql.Statement
java.sql.SQLException
public int getMaxRows() throws java.sql.SQLException
getMaxRows
in interface java.sql.Statement
java.sql.SQLException
public void setMaxRows(int p0) throws java.sql.SQLException
setMaxRows
in interface java.sql.Statement
java.sql.SQLException
public void setEscapeProcessing(boolean p0) throws java.sql.SQLException
setEscapeProcessing
in interface java.sql.Statement
java.sql.SQLException
public int getQueryTimeout() throws java.sql.SQLException
getQueryTimeout
in interface java.sql.Statement
java.sql.SQLException
public void setQueryTimeout(int p0) throws java.sql.SQLException
setQueryTimeout
in interface java.sql.Statement
java.sql.SQLException
public int getFetchDirection() throws java.sql.SQLException
getFetchDirection
in interface java.sql.Statement
java.sql.SQLException
public void setFetchDirection(int p0) throws java.sql.SQLException
setFetchDirection
in interface java.sql.Statement
java.sql.SQLException
public int getFetchSize() throws java.sql.SQLException
getFetchSize
in interface java.sql.Statement
java.sql.SQLException
public void setFetchSize(int p0) throws java.sql.SQLException
setFetchSize
in interface java.sql.Statement
java.sql.SQLException
public int getResultSetConcurrency() throws java.sql.SQLException
getResultSetConcurrency
in interface java.sql.Statement
java.sql.SQLException
public int getResultSetType() throws java.sql.SQLException
getResultSetType
in interface java.sql.Statement
java.sql.SQLException
public void cancel() throws java.sql.SQLException
cancel
in interface java.sql.Statement
java.sql.SQLException
public java.sql.SQLWarning getWarnings() throws java.sql.SQLException
getWarnings
in interface java.sql.Statement
java.sql.SQLException
public void clearWarnings() throws java.sql.SQLException
clearWarnings
in interface java.sql.Statement
java.sql.SQLException
public void setCursorName(java.lang.String p0) throws java.sql.SQLException
setCursorName
in interface java.sql.Statement
java.sql.SQLException
public boolean execute(java.lang.String p0) throws java.sql.SQLException
execute
in interface java.sql.Statement
java.sql.SQLException
public java.sql.ResultSet getResultSet() throws java.sql.SQLException
getResultSet
in interface java.sql.Statement
java.sql.SQLException
public java.sql.ResultSetMetaData getMetaData() throws java.sql.SQLException
getMetaData
in interface java.sql.PreparedStatement
java.sql.SQLException
public int getUpdateCount() throws java.sql.SQLException
getUpdateCount
in interface java.sql.Statement
java.sql.SQLException
public boolean getMoreResults() throws java.sql.SQLException
getMoreResults
in interface java.sql.Statement
java.sql.SQLException
public java.sql.ResultSet executeQuery() throws java.sql.SQLException
executeQuery
in interface java.sql.PreparedStatement
java.sql.SQLException
public int executeUpdate() throws java.sql.SQLException
executeUpdate
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setNull(int p0, int p1) throws java.sql.SQLException
setNull
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setNull(int p0, int p1, java.lang.String p2) throws java.sql.SQLException
setNull
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setArray(int p0, java.sql.Array p1) throws java.sql.SQLException
setArray
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setBlob(int p0, java.sql.Blob p1) throws java.sql.SQLException
setBlob
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setClob(int p0, java.sql.Clob p1) throws java.sql.SQLException
setClob
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setCharacterStream(int p0, java.io.Reader p1, int p2) throws java.sql.SQLException
setCharacterStream
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setBoolean(int p0, boolean p1) throws java.sql.SQLException
setBoolean
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setByte(int p0, byte p1) throws java.sql.SQLException
setByte
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setRef(int p0, java.sql.Ref p1) throws java.sql.SQLException
setRef
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setShort(int p0, short p1) throws java.sql.SQLException
setShort
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setInt(int p0, int p1) throws java.sql.SQLException
setInt
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setLong(int p0, long p1) throws java.sql.SQLException
setLong
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setFloat(int p0, float p1) throws java.sql.SQLException
setFloat
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setDouble(int p0, double p1) throws java.sql.SQLException
setDouble
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setBigDecimal(int p0, java.math.BigDecimal p1) throws java.sql.SQLException
setBigDecimal
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setString(int p0, java.lang.String p1) throws java.sql.SQLException
setString
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setBytes(int p0, byte[] p1) throws java.sql.SQLException
setBytes
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setDate(int p0, java.sql.Date p1) throws java.sql.SQLException
setDate
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setDate(int p0, java.sql.Date p1, java.util.Calendar p2) throws java.sql.SQLException
setDate
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setTime(int p0, java.sql.Time p1) throws java.sql.SQLException
setTime
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setTime(int p0, java.sql.Time p1, java.util.Calendar p2) throws java.sql.SQLException
setTime
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setTimestamp(int p0, java.sql.Timestamp p1) throws java.sql.SQLException
setTimestamp
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setTimestamp(int p0, java.sql.Timestamp p1, java.util.Calendar p2) throws java.sql.SQLException
setTimestamp
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setAsciiStream(int p0, java.io.InputStream p1, int p2) throws java.sql.SQLException
setAsciiStream
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setUnicodeStream(int p0, java.io.InputStream p1, int p2) throws java.sql.SQLException
setUnicodeStream
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setBinaryStream(int p0, java.io.InputStream p1, int p2) throws java.sql.SQLException
setBinaryStream
in interface java.sql.PreparedStatement
java.sql.SQLException
public void clearParameters() throws java.sql.SQLException
clearParameters
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setObject(int p0, java.lang.Object p1, int p2, int p3) throws java.sql.SQLException
setObject
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setObject(int p0, java.lang.Object p1, int p2) throws java.sql.SQLException
setObject
in interface java.sql.PreparedStatement
java.sql.SQLException
public void setObject(int p0, java.lang.Object p1) throws java.sql.SQLException
setObject
in interface java.sql.PreparedStatement
java.sql.SQLException
public boolean execute() throws java.sql.SQLException
execute
in interface java.sql.PreparedStatement
java.sql.SQLException
public void registerOutParameter(int p0, int p1) throws java.sql.SQLException
registerOutParameter
in interface java.sql.CallableStatement
java.sql.SQLException
public void registerOutParameter(int p0, int p1, java.lang.String p2) throws java.sql.SQLException
registerOutParameter
in interface java.sql.CallableStatement
java.sql.SQLException
public void registerOutParameter(int p0, int p1, int p2) throws java.sql.SQLException
registerOutParameter
in interface java.sql.CallableStatement
java.sql.SQLException
public boolean wasNull() throws java.sql.SQLException
wasNull
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Array getArray(int p0) throws java.sql.SQLException
getArray
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Blob getBlob(int p0) throws java.sql.SQLException
getBlob
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Clob getClob(int p0) throws java.sql.SQLException
getClob
in interface java.sql.CallableStatement
java.sql.SQLException
public java.lang.String getString(int p0) throws java.sql.SQLException
getString
in interface java.sql.CallableStatement
java.sql.SQLException
public boolean getBoolean(int p0) throws java.sql.SQLException
getBoolean
in interface java.sql.CallableStatement
java.sql.SQLException
public byte getByte(int p0) throws java.sql.SQLException
getByte
in interface java.sql.CallableStatement
java.sql.SQLException
public short getShort(int p0) throws java.sql.SQLException
getShort
in interface java.sql.CallableStatement
java.sql.SQLException
public int getInt(int p0) throws java.sql.SQLException
getInt
in interface java.sql.CallableStatement
java.sql.SQLException
public long getLong(int p0) throws java.sql.SQLException
getLong
in interface java.sql.CallableStatement
java.sql.SQLException
public float getFloat(int p0) throws java.sql.SQLException
getFloat
in interface java.sql.CallableStatement
java.sql.SQLException
public double getDouble(int p0) throws java.sql.SQLException
getDouble
in interface java.sql.CallableStatement
java.sql.SQLException
public java.math.BigDecimal getBigDecimal(int p0) throws java.sql.SQLException
getBigDecimal
in interface java.sql.CallableStatement
java.sql.SQLException
public java.math.BigDecimal getBigDecimal(int p0, int p1) throws java.sql.SQLException
getBigDecimal
in interface java.sql.CallableStatement
java.sql.SQLException
public byte[] getBytes(int p0) throws java.sql.SQLException
getBytes
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Date getDate(int p0) throws java.sql.SQLException
getDate
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Date getDate(int p0, java.util.Calendar p1) throws java.sql.SQLException
getDate
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Time getTime(int p0) throws java.sql.SQLException
getTime
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Time getTime(int p0, java.util.Calendar p1) throws java.sql.SQLException
getTime
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Timestamp getTimestamp(int p0) throws java.sql.SQLException
getTimestamp
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Timestamp getTimestamp(int p0, java.util.Calendar p1) throws java.sql.SQLException
getTimestamp
in interface java.sql.CallableStatement
java.sql.SQLException
public java.lang.Object getObject(int p0) throws java.sql.SQLException
getObject
in interface java.sql.CallableStatement
java.sql.SQLException
public java.lang.Object getObject(int p0, java.util.Map p1) throws java.sql.SQLException
getObject
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.Ref getRef(int p0) throws java.sql.SQLException
getRef
in interface java.sql.CallableStatement
java.sql.SQLException
public java.sql.CallableStatement getWrapped()
public void setWrapped(java.sql.CallableStatement pWrapped)
public boolean getMoreResults(int current) throws java.sql.SQLException
Statement
object's next result, deals with
any current ResultSet
object(s) according to the instructions
specified by the given flag, and returns
true
if the next result is a ResultSet
object.
There are no more results when the following is true:
(!getMoreResults() && (getUpdateCount() == -1)
getMoreResults
in interface java.sql.Statement
current
- one of the following Statement
constants indicating what should happen to current
ResultSet
objects obtained using the method
getResultSetCLOSE_CURRENT_RESULT
,
KEEP_CURRENT_RESULT
, or
CLOSE_ALL_RESULTS
true
if the next result is a ResultSet
object; false
if it is an update count or there are no
more results
java.sql.SQLException
- if a database access error occursexecute(java.lang.String)
public java.sql.ResultSet getGeneratedKeys() throws java.sql.SQLException
Statement
object. If this Statement
object did
not generate any keys, an empty ResultSet
object is returned.
getGeneratedKeys
in interface java.sql.Statement
ResultSet
object containing the auto-generated key(s)
generated by the execution of this Statement
object
java.sql.SQLException
- if a database access error occurspublic int executeUpdate(java.lang.String sql, int autoGeneratedKeys) throws java.sql.SQLException
Statement
object
should be made available for retrieval.
executeUpdate
in interface java.sql.Statement
sql
- must be an SQL INSERT
, UPDATE
or
DELETE
statement or an SQL statement that
returns nothingautoGeneratedKeys
- a flag indicating whether auto-generated keys
should be made available for retrieval;
one of the following constants:
Statement.RETURN_GENERATED_KEYS
Statement.NO_GENERATED_KEYS
INSERT
, UPDATE
or DELETE
statements, or 0
for SQL
statements that return nothing
java.sql.SQLException
- if a database access error occurs, the given
SQL statement returns a ResultSet
object, or
the given constant is not one of those allowedpublic int executeUpdate(java.lang.String sql, int[] columnIndexes) throws java.sql.SQLException
INSERT
statement.
executeUpdate
in interface java.sql.Statement
sql
- an SQL INSERT
, UPDATE
or
DELETE
statement or an SQL statement that returns nothing,
such as an SQL DDL statementcolumnIndexes
- an array of column indexes indicating the columns
that should be returned from the inserted row
INSERT
, UPDATE
,
or DELETE
statements, or 0 for SQL statements
that return nothing
java.sql.SQLException
- if a database access error occurs or the SQL
statement returns a ResultSet
objectpublic int executeUpdate(java.lang.String sql, java.lang.String[] columnNames) throws java.sql.SQLException
INSERT
statement.
executeUpdate
in interface java.sql.Statement
sql
- an SQL INSERT
, UPDATE
or
DELETE
statement or an SQL statement that returns nothingcolumnNames
- an array of the names of the columns that should be
returned from the inserted row
INSERT
, UPDATE
,
or DELETE
statements, or 0 for SQL statements
that return nothing
java.sql.SQLException
- if a database access error occurspublic boolean execute(java.lang.String sql, int autoGeneratedKeys) throws java.sql.SQLException
INSERT
statement.
In some (uncommon) situations, a single SQL statement may return multiple result sets and/or update counts. Normally you can ignore this unless you are (1) executing a stored procedure that you know may return multiple results or (2) you are dynamically executing an unknown SQL string.
The execute
method executes an SQL statement and indicates the
form of the first result. You must then use the methods
getResultSet
or getUpdateCount
to retrieve the result, and getMoreResults
to
move to any subsequent result(s).
execute
in interface java.sql.Statement
sql
- any SQL statementautoGeneratedKeys
- a constant indicating whether auto-generated
keys should be made available for retrieval using the method
getGeneratedKeys
; one of the following constants:
Statement.RETURN_GENERATED_KEYS
or
Statement.NO_GENERATED_KEYS
true
if the first result is a ResultSet
object; false
if it is an update count or there are
no results
java.sql.SQLException
- if a database access error occursgetResultSet()
,
getUpdateCount()
,
getMoreResults()
,
getGeneratedKeys()
public boolean execute(java.lang.String sql, int[] columnIndexes) throws java.sql.SQLException
INSERT
statement.
Under some (uncommon) situations, a single SQL statement may return multiple result sets and/or update counts. Normally you can ignore this unless you are (1) executing a stored procedure that you know may return multiple results or (2) you are dynamically executing an unknown SQL string.
The execute
method executes an SQL statement and indicates the
form of the first result. You must then use the methods
getResultSet
or getUpdateCount
to retrieve the result, and getMoreResults
to
move to any subsequent result(s).
execute
in interface java.sql.Statement
sql
- any SQL statementcolumnIndexes
- an array of the indexes of the columns in the
inserted row that should be made available for retrieval by a
call to the method getGeneratedKeys
true
if the first result is a ResultSet
object; false
if it is an update count or there
are no results
java.sql.SQLException
- if a database access error occursgetResultSet()
,
getUpdateCount()
,
getMoreResults()
public boolean execute(java.lang.String sql, java.lang.String[] columnNames) throws java.sql.SQLException
INSERT
statement.
In some (uncommon) situations, a single SQL statement may return multiple result sets and/or update counts. Normally you can ignore this unless you are (1) executing a stored procedure that you know may return multiple results or (2) you are dynamically executing an unknown SQL string.
The execute
method executes an SQL statement and indicates the
form of the first result. You must then use the methods
getResultSet
or getUpdateCount
to retrieve the result, and getMoreResults
to
move to any subsequent result(s).
execute
in interface java.sql.Statement
sql
- any SQL statementcolumnNames
- an array of the names of the columns in the inserted
row that should be made available for retrieval by a call to the
method getGeneratedKeys
true
if the next result is a ResultSet
object; false
if it is an update count or there
are no more results
java.sql.SQLException
- if a database access error occursgetResultSet()
,
getUpdateCount()
,
getMoreResults()
,
getGeneratedKeys()
public int getResultSetHoldability() throws java.sql.SQLException
ResultSet
objects
generated by this Statement
object.
getResultSetHoldability
in interface java.sql.Statement
ResultSet.HOLD_CURSORS_OVER_COMMIT
or
ResultSet.CLOSE_CURSORS_AT_COMMIT
java.sql.SQLException
- if a database access error occurspublic void setURL(int parameterIndex, java.net.URL x) throws java.sql.SQLException
java.net.URL
value.
The driver converts this to an SQL DATALINK
value
when it sends it to the database.
setURL
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the java.net.URL
object to be set
java.sql.SQLException
- if a database access error occurspublic java.sql.ParameterMetaData getParameterMetaData() throws java.sql.SQLException
PreparedStatement
object's parameters.
getParameterMetaData
in interface java.sql.PreparedStatement
ParameterMetaData
object that contains information
about the number, types and properties of this
PreparedStatement
object's parameters
java.sql.SQLException
- if a database access error occursParameterMetaData
public void registerOutParameter(java.lang.String parameterName, int sqlType) throws java.sql.SQLException
parameterName
to the JDBC type
sqlType
. All OUT parameters must be registered
before a stored procedure is executed.
The JDBC type specified by sqlType
for an OUT
parameter determines the Java type that must be used
in the get
method to read the value of that parameter.
If the JDBC type expected to be returned to this output parameter
is specific to this particular database, sqlType
should be Types.OTHER
. The method
getObject(int)
retrieves the value.
registerOutParameter
in interface java.sql.CallableStatement
parameterName
- the name of the parametersqlType
- the JDBC type code defined by Types
.
If the parameter is of JDBC type NUMERIC
or DECIMAL
, the version of
registerOutParameter
that accepts a scale value
should be used.
java.sql.SQLException
- if a database access error occursTypes
public void registerOutParameter(java.lang.String parameterName, int sqlType, int scale) throws java.sql.SQLException
parameterName
to be of JDBC type
sqlType
. This method must be called
before a stored procedure is executed.
The JDBC type specified by sqlType
for an OUT
parameter determines the Java type that must be used
in the get
method to read the value of that parameter.
This version of registerOutParameter
should be
used when the parameter is of JDBC type NUMERIC
or DECIMAL
.
registerOutParameter
in interface java.sql.CallableStatement
parameterName
- the name of the parametersqlType
- SQL type code defined by Types
.scale
- the desired number of digits to the right of the
decimal point. It must be greater than or equal to zero.
java.sql.SQLException
- if a database access error occursTypes
public void registerOutParameter(java.lang.String parameterName, int sqlType, java.lang.String typeName) throws java.sql.SQLException
registerOutParameter
should be used for a user-named or REF output parameter. Examples
of user-named types include: STRUCT, DISTINCT, JAVA_OBJECT, and
named array types.
Before executing a stored procedure call, you must explicitly
call registerOutParameter
to register the type from
Types
for each
OUT parameter. For a user-named parameter the fully-qualified SQL
type name of the parameter should also be given, while a REF
parameter requires that the fully-qualified type name of the
referenced type be given. A JDBC driver that does not need the
type code and type name information may ignore it. To be portable,
however, applications should always provide these values for
user-named and REF parameters.
Although it is intended for user-named and REF parameters,
this method may be used to register a parameter of any JDBC type.
If the parameter does not have a user-named or REF type, the
typeName parameter is ignored.
Note: When reading the value of an out parameter, you
must use the getXXX
method whose Java type XXX corresponds to the
parameter's registered SQL type.
registerOutParameter
in interface java.sql.CallableStatement
parameterName
- the name of the parametersqlType
- a value from Types
typeName
- the fully-qualified name of an SQL structured type
java.sql.SQLException
- if a database access error occursTypes
public java.net.URL getURL(int parameterIndex) throws java.sql.SQLException
DATALINK
parameter as a
java.net.URL
object.
getURL
in interface java.sql.CallableStatement
parameterIndex
- the first parameter is 1, the second is 2,...
java.net.URL
object that represents the
JDBC DATALINK
value used as the designated
parameter
java.sql.SQLException
- if a database access error occurs,
or if the URL being returned is
not a valid URL on the Java platformsetURL(int, java.net.URL)
public void setURL(java.lang.String parameterName, java.net.URL val) throws java.sql.SQLException
java.net.URL
object.
The driver converts this to an SQL DATALINK
value when
it sends it to the database.
setURL
in interface java.sql.CallableStatement
parameterName
- the name of the parameterval
- the parameter value
java.sql.SQLException
- if a database access error occurs,
or if a URL is malformedgetURL(int)
public void setNull(java.lang.String parameterName, int sqlType) throws java.sql.SQLException
NULL
.
Note: You must specify the parameter's SQL type.
setNull
in interface java.sql.CallableStatement
parameterName
- the name of the parametersqlType
- the SQL type code defined in Types
java.sql.SQLException
- if a database access error occurspublic void setBoolean(java.lang.String parameterName, boolean x) throws java.sql.SQLException
boolean
value.
The driver converts this
to an SQL BIT
value when it sends it to the database.
setBoolean
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetBoolean(int)
public void setByte(java.lang.String parameterName, byte x) throws java.sql.SQLException
byte
value.
The driver converts this
to an SQL TINYINT
value when it sends it to the database.
setByte
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetByte(int)
public void setShort(java.lang.String parameterName, short x) throws java.sql.SQLException
short
value.
The driver converts this
to an SQL SMALLINT
value when it sends it to the database.
setShort
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetShort(int)
public void setInt(java.lang.String parameterName, int x) throws java.sql.SQLException
int
value.
The driver converts this
to an SQL INTEGER
value when it sends it to the database.
setInt
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetInt(int)
public void setLong(java.lang.String parameterName, long x) throws java.sql.SQLException
long
value.
The driver converts this
to an SQL BIGINT
value when it sends it to the database.
setLong
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetLong(int)
public void setFloat(java.lang.String parameterName, float x) throws java.sql.SQLException
float
value.
The driver converts this
to an SQL FLOAT
value when it sends it to the database.
setFloat
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetFloat(int)
public void setDouble(java.lang.String parameterName, double x) throws java.sql.SQLException
double
value.
The driver converts this
to an SQL DOUBLE
value when it sends it to the database.
setDouble
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetDouble(int)
public void setBigDecimal(java.lang.String parameterName, java.math.BigDecimal x) throws java.sql.SQLException
java.math.BigDecimal
value.
The driver converts this to an SQL NUMERIC
value when
it sends it to the database.
setBigDecimal
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetBigDecimal(int)
public void setString(java.lang.String parameterName, java.lang.String x) throws java.sql.SQLException
String
value.
The driver converts this
to an SQL VARCHAR
or LONGVARCHAR
value
(depending on the argument's
size relative to the driver's limits on VARCHAR
values)
when it sends it to the database.
setString
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetString(int)
public void setBytes(java.lang.String parameterName, byte[] x) throws java.sql.SQLException
VARBINARY
or
LONGVARBINARY
(depending on the argument's size relative
to the driver's limits on VARBINARY
values) when it sends
it to the database.
setBytes
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetBytes(int)
public void setDate(java.lang.String parameterName, java.sql.Date x) throws java.sql.SQLException
Date
value.
The driver converts this
to an SQL DATE
value when it sends it to the database.
setDate
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetDate(int)
public void setTime(java.lang.String parameterName, java.sql.Time x) throws java.sql.SQLException
Time
value.
The driver converts this
to an SQL TIME
value when it sends it to the database.
setTime
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetTime(int)
public void setTimestamp(java.lang.String parameterName, java.sql.Timestamp x) throws java.sql.SQLException
Timestamp
value.
The driver
converts this to an SQL TIMESTAMP
value when it sends it to the
database.
setTimestamp
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if a database access error occursgetTimestamp(int)
public void setAsciiStream(java.lang.String parameterName, java.io.InputStream x, int length) throws java.sql.SQLException
LONGVARCHAR
parameter, it may be more practical to send it via a
InputStream
. Data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from ASCII to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setAsciiStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the Java input stream that contains the ASCII parameter valuelength
- the number of bytes in the stream
java.sql.SQLException
- if a database access error occurspublic void setBinaryStream(java.lang.String parameterName, java.io.InputStream x, int length) throws java.sql.SQLException
LONGVARBINARY
parameter, it may be more practical to send it via a
InputStream
object. The data will be read from the stream
as needed until end-of-file is reached.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setBinaryStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the java input stream which contains the binary parameter valuelength
- the number of bytes in the stream
java.sql.SQLException
- if a database access error occurspublic void setObject(java.lang.String parameterName, java.lang.Object x, int targetSqlType, int scale) throws java.sql.SQLException
java.lang
equivalent objects should be used.
The given Java object will be converted to the given targetSqlType
before being sent to the database.
If the object has a custom mapping (is of a class implementing the
interface SQLData
),
the JDBC driver should call the method SQLData.writeSQL
to write it
to the SQL data stream.
If, on the other hand, the object is of a class implementing
Ref
, Blob
, Clob
, Struct
,
or Array
, the driver should pass it to the database as a
value of the corresponding SQL type.
Note that this method may be used to pass datatabase- specific abstract data types.
setObject
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the object containing the input parameter valuetargetSqlType
- the SQL type (as defined in Types) to be
sent to the database. The scale argument may further qualify this type.scale
- for Types.DECIMAL or Types.NUMERIC types,
this is the number of digits after the decimal point. For all other
types, this value will be ignored.
java.sql.SQLException
- if a database access error occursTypes
,
getObject(int)
public void setObject(java.lang.String parameterName, java.lang.Object x, int targetSqlType) throws java.sql.SQLException
setObject
above, except that it assumes a scale of zero.
setObject
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the object containing the input parameter valuetargetSqlType
- the SQL type (as defined in Types) to be
sent to the database
java.sql.SQLException
- if a database access error occursgetObject(int)
public void setObject(java.lang.String parameterName, java.lang.Object x) throws java.sql.SQLException
Object
; therefore, the
java.lang
equivalent objects should be used for built-in types.
The JDBC specification specifies a standard mapping from
Java Object
types to SQL types. The given argument
will be converted to the corresponding SQL type before being
sent to the database.
Note that this method may be used to pass datatabase-
specific abstract data types, by using a driver-specific Java
type.
If the object is of a class implementing the interface SQLData
,
the JDBC driver should call the method SQLData.writeSQL
to write it to the SQL data stream.
If, on the other hand, the object is of a class implementing
Ref
, Blob
, Clob
, Struct
,
or Array
, the driver should pass it to the database as a
value of the corresponding SQL type.
This method throws an exception if there is an ambiguity, for example, if the object is of a class implementing more than one of the interfaces named above.
setObject
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the object containing the input parameter value
java.sql.SQLException
- if a database access error occurs or if the given
Object
parameter is ambiguousgetObject(int)
public void setCharacterStream(java.lang.String parameterName, java.io.Reader reader, int length) throws java.sql.SQLException
Reader
object, which is the given number of characters long.
When a very large UNICODE value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
Reader
object. The data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from UNICODE to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setCharacterStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterreader
- the Reader
object that
contains the UNICODE data used as the designated parameterlength
- the number of characters in the stream
java.sql.SQLException
- if a database access error occurspublic void setDate(java.lang.String parameterName, java.sql.Date x, java.util.Calendar cal) throws java.sql.SQLException
Date
value,
using the given Calendar
object. The driver uses
the Calendar
object to construct an SQL DATE
value,
which the driver then sends to the database. With a
a Calendar
object, the driver can calculate the date
taking into account a custom timezone. If no
Calendar
object is specified, the driver uses the default
timezone, which is that of the virtual machine running the application.
setDate
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter valuecal
- the Calendar
object the driver will use
to construct the date
java.sql.SQLException
- if a database access error occursgetDate(int)
public void setTime(java.lang.String parameterName, java.sql.Time x, java.util.Calendar cal) throws java.sql.SQLException
Time
value,
using the given Calendar
object. The driver uses
the Calendar
object to construct an SQL TIME
value,
which the driver then sends to the database. With a
a Calendar
object, the driver can calculate the time
taking into account a custom timezone. If no
Calendar
object is specified, the driver uses the default
timezone, which is that of the virtual machine running the application.
setTime
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter valuecal
- the Calendar
object the driver will use
to construct the time
java.sql.SQLException
- if a database access error occursgetTime(int)
public void setTimestamp(java.lang.String parameterName, java.sql.Timestamp x, java.util.Calendar cal) throws java.sql.SQLException
Timestamp
value,
using the given Calendar
object. The driver uses
the Calendar
object to construct an SQL TIMESTAMP
value,
which the driver then sends to the database. With a
a Calendar
object, the driver can calculate the timestamp
taking into account a custom timezone. If no
Calendar
object is specified, the driver uses the default
timezone, which is that of the virtual machine running the application.
setTimestamp
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter valuecal
- the Calendar
object the driver will use
to construct the timestamp
java.sql.SQLException
- if a database access error occursgetTimestamp(int)
public void setNull(java.lang.String parameterName, int sqlType, java.lang.String typeName) throws java.sql.SQLException
NULL
.
This version of the method setNull
should
be used for user-defined types and REF type parameters. Examples
of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and
named array types.
Note: To be portable, applications must give the SQL type code and the fully-qualified SQL type name when specifying a NULL user-defined or REF parameter. In the case of a user-defined type the name is the type name of the parameter itself. For a REF parameter, the name is the type name of the referenced type. If a JDBC driver does not need the type code or type name information, it may ignore it. Although it is intended for user-defined and Ref parameters, this method may be used to set a null parameter of any JDBC type. If the parameter does not have a user-defined or REF type, the given typeName is ignored.
setNull
in interface java.sql.CallableStatement
parameterName
- the name of the parametersqlType
- a value from Types
typeName
- the fully-qualified name of an SQL user-defined type;
ignored if the parameter is not a user-defined type or
SQL REF
value
java.sql.SQLException
- if a database access error occurspublic java.lang.String getString(java.lang.String parameterName) throws java.sql.SQLException
CHAR
, VARCHAR
,
or LONGVARCHAR
parameter as a String
in
the Java programming language.
For the fixed-length type JDBC CHAR
,
the String
object
returned has exactly the same value the JDBC
CHAR
value had in the
database, including any padding added by the database.
getString
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result
is null
.
java.sql.SQLException
- if a database access error occurssetString(int, java.lang.String)
public boolean getBoolean(java.lang.String parameterName) throws java.sql.SQLException
BIT
parameter as a
boolean
in the Java programming language.
getBoolean
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result
is false
.
java.sql.SQLException
- if a database access error occurssetBoolean(int, boolean)
public byte getByte(java.lang.String parameterName) throws java.sql.SQLException
TINYINT
parameter as a byte
in the Java programming language.
getByte
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result
is 0
.
java.sql.SQLException
- if a database access error occurssetByte(int, byte)
public short getShort(java.lang.String parameterName) throws java.sql.SQLException
SMALLINT
parameter as a short
in the Java programming language.
getShort
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result
is 0
.
java.sql.SQLException
- if a database access error occurssetShort(int, short)
public int getInt(java.lang.String parameterName) throws java.sql.SQLException
INTEGER
parameter as an int
in the Java programming language.
getInt
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
,
the result is 0
.
java.sql.SQLException
- if a database access error occurssetInt(int, int)
public long getLong(java.lang.String parameterName) throws java.sql.SQLException
BIGINT
parameter as a long
in the Java programming language.
getLong
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
,
the result is 0
.
java.sql.SQLException
- if a database access error occurssetLong(int, long)
public float getFloat(java.lang.String parameterName) throws java.sql.SQLException
FLOAT
parameter as a float
in the Java programming language.
getFloat
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
,
the result is 0
.
java.sql.SQLException
- if a database access error occurssetFloat(int, float)
public double getDouble(java.lang.String parameterName) throws java.sql.SQLException
DOUBLE
parameter as a double
in the Java programming language.
getDouble
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
,
the result is 0
.
java.sql.SQLException
- if a database access error occurssetDouble(int, double)
public byte[] getBytes(java.lang.String parameterName) throws java.sql.SQLException
BINARY
or VARBINARY
parameter as an array of byte
values in the Java
programming language.
getBytes
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result is
null
.
java.sql.SQLException
- if a database access error occurssetBytes(int, byte[])
public java.sql.Date getDate(java.lang.String parameterName) throws java.sql.SQLException
DATE
parameter as a
Date
object.
getDate
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result
is null
.
java.sql.SQLException
- if a database access error occurssetDate(int, java.sql.Date)
public java.sql.Time getTime(java.lang.String parameterName) throws java.sql.SQLException
TIME
parameter as a
Time
object.
getTime
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result
is null
.
java.sql.SQLException
- if a database access error occurssetTime(int, java.sql.Time)
public java.sql.Timestamp getTimestamp(java.lang.String parameterName) throws java.sql.SQLException
TIMESTAMP
parameter as a
Timestamp
object.
getTimestamp
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result
is null
.
java.sql.SQLException
- if a database access error occurssetTimestamp(int, java.sql.Timestamp)
public java.lang.Object getObject(java.lang.String parameterName) throws java.sql.SQLException
Object
in the Java
programming language. If the value is an SQL NULL
, the
driver returns a Java null
.
This method returns a Java object whose type corresponds to the JDBC
type that was registered for this parameter using the method
registerOutParameter
. By registering the target JDBC
type as Types.OTHER
, this method can be used
to read database-specific abstract data types.
getObject
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
java.lang.Object
holding the OUT parameter value.
java.sql.SQLException
- if a database access error occursTypes
,
setObject(int, java.lang.Object, int, int)
public java.math.BigDecimal getBigDecimal(java.lang.String parameterName) throws java.sql.SQLException
NUMERIC
parameter as a
java.math.BigDecimal
object with as many digits to the
right of the decimal point as the value contains.
getBigDecimal
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NULL
, the result is null
.
java.sql.SQLException
- if a database access error occurssetBigDecimal(int, java.math.BigDecimal)
public java.lang.Object getObject(java.lang.String parameterName, java.util.Map map) throws java.sql.SQLException
i
and uses map
for the custom
mapping of the parameter value.
This method returns a Java object whose type corresponds to the
JDBC type that was registered for this parameter using the method
registerOutParameter
. By registering the target
JDBC type as Types.OTHER
, this method can
be used to read database-specific abstract data types.
getObject
in interface java.sql.CallableStatement
parameterName
- the name of the parametermap
- the mapping from SQL type names to Java classes
java.lang.Object
holding the OUT parameter value
java.sql.SQLException
- if a database access error occurssetObject(int, java.lang.Object, int, int)
public java.sql.Ref getRef(java.lang.String parameterName) throws java.sql.SQLException
REF(<structured-type>)
parameter as a Ref
object in the Java programming language.
getRef
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
Ref
object in the
Java programming language. If the value was SQL NULL
,
the value null
is returned.
java.sql.SQLException
- if a database access error occurspublic java.sql.Blob getBlob(java.lang.String parameterName) throws java.sql.SQLException
BLOB
parameter as a
Blob
object in the Java programming language.
getBlob
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
Blob
object in the
Java programming language. If the value was SQL NULL
,
the value null
is returned.
java.sql.SQLException
- if a database access error occurspublic java.sql.Clob getClob(java.lang.String parameterName) throws java.sql.SQLException
CLOB
parameter as a
Clob
object in the Java programming language.
getClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
Clob
object in the
Java programming language. If the value was SQL NULL
,
the value null
is returned.
java.sql.SQLException
- if a database access error occurspublic java.sql.Array getArray(java.lang.String parameterName) throws java.sql.SQLException
ARRAY
parameter as an
Array
object in the Java programming language.
getArray
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
Array
object in
Java programming language. If the value was SQL NULL
,
the value null
is returned.
java.sql.SQLException
- if a database access error occurspublic java.sql.Date getDate(java.lang.String parameterName, java.util.Calendar cal) throws java.sql.SQLException
DATE
parameter as a
Date
object, using
the given Calendar
object
to construct the date.
With a Calendar
object, the driver
can calculate the date taking into account a custom timezone and locale.
If no Calendar
object is specified, the driver uses the
default timezone and locale.
getDate
in interface java.sql.CallableStatement
parameterName
- the name of the parametercal
- the Calendar
object the driver will use
to construct the date
NULL
,
the result is null
.
java.sql.SQLException
- if a database access error occurssetDate(int, java.sql.Date)
public java.sql.Time getTime(java.lang.String parameterName, java.util.Calendar cal) throws java.sql.SQLException
TIME
parameter as a
Time
object, using
the given Calendar
object
to construct the time.
With a Calendar
object, the driver
can calculate the time taking into account a custom timezone and locale.
If no Calendar
object is specified, the driver uses the
default timezone and locale.
getTime
in interface java.sql.CallableStatement
parameterName
- the name of the parametercal
- the Calendar
object the driver will use
to construct the time
NULL
, the result is
null
.
java.sql.SQLException
- if a database access error occurssetTime(int, java.sql.Time)
public java.sql.Timestamp getTimestamp(java.lang.String parameterName, java.util.Calendar cal) throws java.sql.SQLException
TIMESTAMP
parameter as a
Timestamp
object, using
the given Calendar
object to construct
the Timestamp
object.
With a Calendar
object, the driver
can calculate the timestamp taking into account a custom timezone and locale.
If no Calendar
object is specified, the driver uses the
default timezone and locale.
getTimestamp
in interface java.sql.CallableStatement
parameterName
- the name of the parametercal
- the Calendar
object the driver will use
to construct the timestamp
NULL
, the result is
null
.
java.sql.SQLException
- if a database access error occurssetTimestamp(int, java.sql.Timestamp)
public java.net.URL getURL(java.lang.String parameterName) throws java.sql.SQLException
DATALINK
parameter as a
java.net.URL
object.
getURL
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
java.net.URL
object in the
Java programming language. If the value was SQL NULL
, the
value null
is returned.
java.sql.SQLException
- if a database access error occurs,
or if there is a problem with the URLsetURL(int, java.net.URL)
public java.sql.RowId getRowId(int parameterIndex) throws java.sql.SQLException
ROWID
parameter as a
java.sql.RowId
object.
getRowId
in interface java.sql.CallableStatement
parameterIndex
- the first parameter is 1, the second is 2,...
RowId
object that represents the JDBC ROWID
value is used as the designated parameter. If the parameter contains
a SQL NULL
, then a null
value is returned.
java.sql.SQLException
- if the parameterIndex is not valid;
if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.sql.RowId getRowId(java.lang.String parameterName) throws java.sql.SQLException
ROWID
parameter as a
java.sql.RowId
object.
getRowId
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
RowId
object that represents the JDBC ROWID
value is used as the designated parameter. If the parameter contains
a SQL NULL
, then a null
value is returned.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setRowId(java.lang.String parameterName, java.sql.RowId x) throws java.sql.SQLException
java.sql.RowId
object. The
driver converts this to a SQL ROWID
when it sends it to the
database.
setRowId
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the parameter value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setNString(java.lang.String parameterName, java.lang.String value) throws java.sql.SQLException
String
object.
The driver converts this to a SQL NCHAR
or
NVARCHAR
or LONGNVARCHAR
setNString
in interface java.sql.CallableStatement
parameterName
- the name of the parameter to be setvalue
- the parameter value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setNCharacterStream(java.lang.String parameterName, java.io.Reader value, long length) throws java.sql.SQLException
Reader
object. The
Reader
reads the data till end-of-file is reached. The
driver does the necessary conversion from Java character format to
the national character set in the database.
setNCharacterStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameter to be setvalue
- the parameter valuelength
- the number of characters in the parameter data.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setNClob(java.lang.String parameterName, java.sql.NClob value) throws java.sql.SQLException
java.sql.NClob
object. The object
implements the java.sql.NClob
interface. This NClob
object maps to a SQL NCLOB
.
setNClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameter to be setvalue
- the parameter value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setClob(java.lang.String parameterName, java.io.Reader reader, long length) throws java.sql.SQLException
Reader
object. The reader
must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the CallableStatement
is executed.
This method differs from the setCharacterStream (int, Reader, int)
method
because it informs the driver that the parameter value should be sent to
the server as a CLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be send to the server as a LONGVARCHAR
or a CLOB
setClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameter to be setreader
- An object that contains the data to set the parameter value to.length
- the number of characters in the parameter data.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the length specified is less than zero;
a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setBlob(java.lang.String parameterName, java.io.InputStream inputStream, long length) throws java.sql.SQLException
InputStream
object. The inputstream
must contain the number
of characters specified by length, otherwise a SQLException
will be
generated when the CallableStatement
is executed.
This method differs from the setBinaryStream (int, InputStream, int)
method because it informs the driver that the parameter value should be
sent to the server as a BLOB
. When the setBinaryStream
method is used,
the driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARBINARY
or a BLOB
setBlob
in interface java.sql.CallableStatement
parameterName
- the name of the parameter to be set
the second is 2, ...inputStream
- An object that contains the data to set the parameter
value to.length
- the number of bytes in the parameter data.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the length specified
is less than zero; if the number of bytes in the inputstream does not match
the specfied length; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setNClob(java.lang.String parameterName, java.io.Reader reader, long length) throws java.sql.SQLException
Reader
object. The reader
must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the CallableStatement
is executed.
This method differs from the setCharacterStream (int, Reader, int)
method
because it informs the driver that the parameter value should be sent to
the server as a NCLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be send to the server as a LONGNVARCHAR
or a NCLOB
setNClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameter to be setreader
- An object that contains the data to set the parameter value to.length
- the number of characters in the parameter data.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the length specified is less than zero;
if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.sql.NClob getNClob(int parameterIndex) throws java.sql.SQLException
NCLOB
parameter as a
java.sql.NClob
object in the Java programming language.
getNClob
in interface java.sql.CallableStatement
parameterIndex
- the first parameter is 1, the second is 2, and
so on
NClob
object in the
Java programming language. If the value was SQL NULL
, the
value null
is returned.
java.sql.SQLException
- if the parameterIndex is not valid;
if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.sql.NClob getNClob(java.lang.String parameterName) throws java.sql.SQLException
NCLOB
parameter as a
java.sql.NClob
object in the Java programming language.
getNClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
NClob
object in the
Java programming language. If the value was SQL NULL
,
the value null
is returned.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setSQLXML(java.lang.String parameterName, java.sql.SQLXML xmlObject) throws java.sql.SQLException
java.sql.SQLXML
object. The driver converts this to an
SQL XML
value when it sends it to the database.
setSQLXML
in interface java.sql.CallableStatement
parameterName
- the name of the parameterxmlObject
- a SQLXML
object that maps an SQL XML
value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs;
this method is called on a closed CallableStatement
or
the java.xml.transform.Result
,
Writer
or OutputStream
has not been closed for the SQLXML
object
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.sql.SQLXML getSQLXML(int parameterIndex) throws java.sql.SQLException
SQL XML
parameter as a
java.sql.SQLXML
object in the Java programming language.
getSQLXML
in interface java.sql.CallableStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...
SQLXML
object that maps an SQL XML
value
java.sql.SQLException
- if the parameterIndex is not valid;
if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.sql.SQLXML getSQLXML(java.lang.String parameterName) throws java.sql.SQLException
SQL XML
parameter as a
java.sql.SQLXML
object in the Java programming language.
getSQLXML
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
SQLXML
object that maps an SQL XML
value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.lang.String getNString(int parameterIndex) throws java.sql.SQLException
NCHAR
,
NVARCHAR
or LONGNVARCHAR
parameter as
a String
in the Java programming language.
For the fixed-length type JDBC NCHAR
,
the String
object
returned has exactly the same value the SQL
NCHAR
value had in the
database, including any padding added by the database.
getNString
in interface java.sql.CallableStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...
String
object that maps an
NCHAR
, NVARCHAR
or LONGNVARCHAR
value
java.sql.SQLException
- if the parameterIndex is not valid;
if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodsetNString(java.lang.String, java.lang.String)
public java.lang.String getNString(java.lang.String parameterName) throws java.sql.SQLException
NCHAR
,
NVARCHAR
or LONGNVARCHAR
parameter as
a String
in the Java programming language.
For the fixed-length type JDBC NCHAR
,
the String
object
returned has exactly the same value the SQL
NCHAR
value had in the
database, including any padding added by the database.
getNString
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
String
object that maps an
NCHAR
, NVARCHAR
or LONGNVARCHAR
value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter;
if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodsetNString(java.lang.String, java.lang.String)
public java.io.Reader getNCharacterStream(int parameterIndex) throws java.sql.SQLException
Reader
object in the Java programming language.
It is intended for use when
accessing NCHAR
,NVARCHAR
and LONGNVARCHAR
parameters.
getNCharacterStream
in interface java.sql.CallableStatement
parameterIndex
- the first parameter is 1, the second is 2, ...
Reader
object that contains the parameter
value; if the value is SQL NULL
, the value returned is
null
in the Java programming language.
java.sql.SQLException
- if the parameterIndex is not valid;
if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.io.Reader getNCharacterStream(java.lang.String parameterName) throws java.sql.SQLException
Reader
object in the Java programming language.
It is intended for use when
accessing NCHAR
,NVARCHAR
and LONGNVARCHAR
parameters.
getNCharacterStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
Reader
object that contains the parameter
value; if the value is SQL NULL
, the value returned is
null
in the Java programming language
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic java.io.Reader getCharacterStream(int parameterIndex) throws java.sql.SQLException
Reader
object in the Java programming language.
getCharacterStream
in interface java.sql.CallableStatement
parameterIndex
- the first parameter is 1, the second is 2, ...
Reader
object that contains the parameter
value; if the value is SQL NULL
, the value returned is
null
in the Java programming language.
java.sql.SQLException
- if the parameterIndex is not valid; if a database access error occurs or
this method is called on a closed CallableStatement
public java.io.Reader getCharacterStream(java.lang.String parameterName) throws java.sql.SQLException
Reader
object in the Java programming language.
getCharacterStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameter
Reader
object that contains the parameter
value; if the value is SQL NULL
, the value returned is
null
in the Java programming language
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setBlob(java.lang.String parameterName, java.sql.Blob x) throws java.sql.SQLException
java.sql.Blob
object.
The driver converts this to an SQL BLOB
value when it
sends it to the database.
setBlob
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- a Blob
object that maps an SQL BLOB
value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setClob(java.lang.String parameterName, java.sql.Clob x) throws java.sql.SQLException
java.sql.Clob
object.
The driver converts this to an SQL CLOB
value when it
sends it to the database.
setClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- a Clob
object that maps an SQL CLOB
value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setAsciiStream(java.lang.String parameterName, java.io.InputStream x, long length) throws java.sql.SQLException
LONGVARCHAR
parameter, it may be more practical to send it via a
InputStream
. Data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from ASCII to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setAsciiStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the Java input stream that contains the ASCII parameter valuelength
- the number of bytes in the stream
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setBinaryStream(java.lang.String parameterName, java.io.InputStream x, long length) throws java.sql.SQLException
LONGVARBINARY
parameter, it may be more practical to send it via a
InputStream
object. The data will be read from the stream
as needed until end-of-file is reached.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setBinaryStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the java input stream which contains the binary parameter valuelength
- the number of bytes in the stream
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setCharacterStream(java.lang.String parameterName, java.io.Reader reader, long length) throws java.sql.SQLException
Reader
object, which is the given number of characters long.
When a very large UNICODE value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
Reader
object. The data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from UNICODE to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setCharacterStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterreader
- the Reader
object that
contains the UNICODE data used as the designated parameterlength
- the number of characters in the stream
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support
this methodpublic void setAsciiStream(java.lang.String parameterName, java.io.InputStream x) throws java.sql.SQLException
LONGVARCHAR
parameter, it may be more practical to send it via a
InputStream
. Data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from ASCII to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setAsciiStream
which takes a length parameter.
setAsciiStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the Java input stream that contains the ASCII parameter value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setBinaryStream(java.lang.String parameterName, java.io.InputStream x) throws java.sql.SQLException
LONGVARBINARY
parameter, it may be more practical to send it via a
InputStream
object. The data will be read from the
stream as needed until end-of-file is reached.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setBinaryStream
which takes a length parameter.
setBinaryStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterx
- the java input stream which contains the binary parameter value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setCharacterStream(java.lang.String parameterName, java.io.Reader reader) throws java.sql.SQLException
Reader
object.
When a very large UNICODE value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
Reader
object. The data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from UNICODE to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setCharacterStream
which takes a length parameter.
setCharacterStream
in interface java.sql.CallableStatement
parameterName
- the name of the parameterreader
- the Reader
object that contains the
Unicode data
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNCharacterStream(java.lang.String parameterName, java.io.Reader value) throws java.sql.SQLException
Reader
object. The
Reader
reads the data till end-of-file is reached. The
driver does the necessary conversion from Java character format to
the national character set in the database.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setNCharacterStream
which takes a length parameter.
setNCharacterStream
in interface java.sql.CallableStatement
parameterName
- the name of the parametervalue
- the parameter value
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs; or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setClob(java.lang.String parameterName, java.io.Reader reader) throws java.sql.SQLException
Reader
object.
This method differs from the setCharacterStream (int, Reader)
method
because it informs the driver that the parameter value should be sent to
the server as a CLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be send to the server as a LONGVARCHAR
or a CLOB
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setClob
which takes a length parameter.
setClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameterreader
- An object that contains the data to set the parameter value to.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or this method is called on
a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setBlob(java.lang.String parameterName, java.io.InputStream inputStream) throws java.sql.SQLException
InputStream
object.
This method differs from the setBinaryStream (int, InputStream)
method because it informs the driver that the parameter value should be
sent to the server as a BLOB
. When the setBinaryStream
method is used,
the driver may have to do extra work to determine whether the parameter
data should be send to the server as a LONGVARBINARY
or a BLOB
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setBlob
which takes a length parameter.
setBlob
in interface java.sql.CallableStatement
parameterName
- the name of the parameterinputStream
- An object that contains the data to set the parameter
value to.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNClob(java.lang.String parameterName, java.io.Reader reader) throws java.sql.SQLException
Reader
object.
This method differs from the setCharacterStream (int, Reader)
method
because it informs the driver that the parameter value should be sent to
the server as a NCLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be send to the server as a LONGNVARCHAR
or a NCLOB
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setNClob
which takes a length parameter.
setNClob
in interface java.sql.CallableStatement
parameterName
- the name of the parameterreader
- An object that contains the data to set the parameter value to.
java.sql.SQLException
- if parameterName does not correspond to a named
parameter; if the driver does not support national character sets;
if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setRowId(int parameterIndex, java.sql.RowId x) throws java.sql.SQLException
java.sql.RowId
object. The
driver converts this to a SQL ROWID
value when it sends it
to the database
setRowId
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the parameter value
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNString(int parameterIndex, java.lang.String value) throws java.sql.SQLException
String
object.
The driver converts this to a SQL NCHAR
or
NVARCHAR
or LONGNVARCHAR
value
(depending on the argument's
size relative to the driver's limits on NVARCHAR
values)
when it sends it to the database.
setNString
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter value
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs; or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNCharacterStream(int parameterIndex, java.io.Reader value, long length) throws java.sql.SQLException
Reader
object. The
Reader
reads the data till end-of-file is reached. The
driver does the necessary conversion from Java character format to
the national character set in the database.
setNCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter valuelength
- the number of characters in the parameter data.
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs; or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNClob(int parameterIndex, java.sql.NClob value) throws java.sql.SQLException
java.sql.NClob
object. The driver converts this to a
SQL NCLOB
value when it sends it to the database.
setNClob
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter value
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs; or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setClob(int parameterIndex, java.io.Reader reader, long length) throws java.sql.SQLException
Reader
object. The reader must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the PreparedStatement
is executed.
This method differs from the setCharacterStream (int, Reader, int)
method
because it informs the driver that the parameter value should be sent to
the server as a CLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARCHAR
or a CLOB
setClob
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...reader
- An object that contains the data to set the parameter value to.length
- the number of characters in the parameter data.
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs; this method is called on
a closed PreparedStatement
or if the length specified is less than zero.
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setBlob(int parameterIndex, java.io.InputStream inputStream, long length) throws java.sql.SQLException
InputStream
object. The inputstream must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the PreparedStatement
is executed.
This method differs from the setBinaryStream (int, InputStream, int)
method because it informs the driver that the parameter value should be
sent to the server as a BLOB
. When the setBinaryStream
method is used,
the driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARBINARY
or a BLOB
setBlob
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1,
the second is 2, ...inputStream
- An object that contains the data to set the parameter
value to.length
- the number of bytes in the parameter data.
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs;
this method is called on a closed PreparedStatement
;
if the length specified
is less than zero or if the number of bytes in the inputstream does not match
the specfied length.
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNClob(int parameterIndex, java.io.Reader reader, long length) throws java.sql.SQLException
Reader
object. The reader must contain the number
of characters specified by length otherwise a SQLException
will be
generated when the PreparedStatement
is executed.
This method differs from the setCharacterStream (int, Reader, int)
method
because it informs the driver that the parameter value should be sent to
the server as a NCLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGNVARCHAR
or a NCLOB
setNClob
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...reader
- An object that contains the data to set the parameter value to.length
- the number of characters in the parameter data.
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if the length specified is less than zero;
if the driver does not support national character sets;
if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setSQLXML(int parameterIndex, java.sql.SQLXML xmlObject) throws java.sql.SQLException
java.sql.SQLXML
object.
The driver converts this to an
SQL XML
value when it sends it to the database.
setSQLXML
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...xmlObject
- a SQLXML
object that maps an SQL XML
value
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs;
this method is called on a closed PreparedStatement
or the java.xml.transform.Result
,
Writer
or OutputStream
has not been closed for
the SQLXML
object
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setAsciiStream(int parameterIndex, java.io.InputStream x, long length) throws java.sql.SQLException
LONGVARCHAR
parameter, it may be more practical to send it via a
java.io.InputStream
. Data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from ASCII to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setAsciiStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the Java input stream that contains the ASCII parameter valuelength
- the number of bytes in the stream
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs or
this method is called on a closed PreparedStatement
public void setBinaryStream(int parameterIndex, java.io.InputStream x, long length) throws java.sql.SQLException
LONGVARBINARY
parameter, it may be more practical to send it via a
java.io.InputStream
object. The data will be read from the
stream as needed until end-of-file is reached.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setBinaryStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the java input stream which contains the binary parameter valuelength
- the number of bytes in the stream
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs or
this method is called on a closed PreparedStatement
public void setCharacterStream(int parameterIndex, java.io.Reader reader, long length) throws java.sql.SQLException
Reader
object, which is the given number of characters long.
When a very large UNICODE value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
java.io.Reader
object. The data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from UNICODE to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
setCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...reader
- the java.io.Reader
object that contains the
Unicode datalength
- the number of characters in the stream
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs or
this method is called on a closed PreparedStatement
public void setAsciiStream(int parameterIndex, java.io.InputStream x) throws java.sql.SQLException
LONGVARCHAR
parameter, it may be more practical to send it via a
java.io.InputStream
. Data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from ASCII to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setAsciiStream
which takes a length parameter.
setAsciiStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the Java input stream that contains the ASCII parameter value
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setBinaryStream(int parameterIndex, java.io.InputStream x) throws java.sql.SQLException
LONGVARBINARY
parameter, it may be more practical to send it via a
java.io.InputStream
object. The data will be read from the
stream as needed until end-of-file is reached.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setBinaryStream
which takes a length parameter.
setBinaryStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...x
- the java input stream which contains the binary parameter value
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setCharacterStream(int parameterIndex, java.io.Reader reader) throws java.sql.SQLException
Reader
object.
When a very large UNICODE value is input to a LONGVARCHAR
parameter, it may be more practical to send it via a
java.io.Reader
object. The data will be read from the stream
as needed until end-of-file is reached. The JDBC driver will
do any necessary conversion from UNICODE to the database char format.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setCharacterStream
which takes a length parameter.
setCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- the first parameter is 1, the second is 2, ...reader
- the java.io.Reader
object that contains the
Unicode data
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNCharacterStream(int parameterIndex, java.io.Reader value) throws java.sql.SQLException
Reader
object. The
Reader
reads the data till end-of-file is reached. The
driver does the necessary conversion from Java character format to
the national character set in the database.
Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setNCharacterStream
which takes a length parameter.
setNCharacterStream
in interface java.sql.PreparedStatement
parameterIndex
- of the first parameter is 1, the second is 2, ...value
- the parameter value
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if the driver does not support national
character sets; if the driver can detect that a data conversion
error could occur; if a database access error occurs; or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setClob(int parameterIndex, java.io.Reader reader) throws java.sql.SQLException
Reader
object.
This method differs from the setCharacterStream (int, Reader)
method
because it informs the driver that the parameter value should be sent to
the server as a CLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARCHAR
or a CLOB
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setClob
which takes a length parameter.
setClob
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...reader
- An object that contains the data to set the parameter value to.
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs; this method is called on
a closed PreparedStatement
or if parameterIndex does not correspond to a parameter
marker in the SQL statement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setBlob(int parameterIndex, java.io.InputStream inputStream) throws java.sql.SQLException
InputStream
object.
This method differs from the setBinaryStream (int, InputStream)
method because it informs the driver that the parameter value should be
sent to the server as a BLOB
. When the setBinaryStream
method is used,
the driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGVARBINARY
or a BLOB
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setBlob
which takes a length parameter.
setBlob
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1,
the second is 2, ...inputStream
- An object that contains the data to set the parameter
value to.
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement; if a database access error occurs;
this method is called on a closed PreparedStatement
or
if parameterIndex does not correspond
to a parameter marker in the SQL statement,
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic void setNClob(int parameterIndex, java.io.Reader reader) throws java.sql.SQLException
Reader
object.
This method differs from the setCharacterStream (int, Reader)
method
because it informs the driver that the parameter value should be sent to
the server as a NCLOB
. When the setCharacterStream
method is used, the
driver may have to do extra work to determine whether the parameter
data should be sent to the server as a LONGNVARCHAR
or a NCLOB
Note: Consult your JDBC driver documentation to determine if
it might be more efficient to use a version of
setNClob
which takes a length parameter.
setNClob
in interface java.sql.PreparedStatement
parameterIndex
- index of the first parameter is 1, the second is 2, ...reader
- An object that contains the data to set the parameter value to.
java.sql.SQLException
- if parameterIndex does not correspond to a parameter
marker in the SQL statement;
if the driver does not support national character sets;
if the driver can detect that a data conversion
error could occur; if a database access error occurs or
this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException
- if the JDBC driver does not support this methodpublic boolean isWrapperFor(java.lang.Class<?> pInterface) throws java.sql.SQLException
isWrapperFor
in interface java.sql.Wrapper
pInterface
- the interface to test
java.sql.SQLException
- if there's an error determining whether this is
a wrapper for the interfacepublic <T> T unwrap(java.lang.Class<T> pInterface) throws java.sql.SQLException
unwrap
in interface java.sql.Wrapper
pInterface
- the interface of the object to return
java.sql.SQLException
- if no object is found that implements
the given interfacepublic boolean isClosed() throws java.sql.SQLException
Statement
object has been closed. A Statement
is closed if the
method close has been called on it, or if it is automatically closed.
isClosed
in interface java.sql.Statement
Statement
object is closed; false if it is still open
java.sql.SQLException
- if a database access error occurspublic void setPoolable(boolean poolable) throws java.sql.SQLException
Statement
be pooled or not pooled. The value
specified is a hint to the statement pool implementation indicating
whether the applicaiton wants the statement to be pooled. It is up to
the statement pool manager as to whether the hint is used.
The poolable value of a statement is applicable to both internal statement caches implemented by the driver and external statement caches implemented by application servers and other applications.
By default, a Statement
is not poolable when created, and
a PreparedStatement
and CallableStatement
are poolable when created.
setPoolable
in interface java.sql.Statement
poolable
- requests that the statement be pooled if true and
that the statement not be pooled if false
java.sql.SQLException
- if this method is called on a closed
Statement
public boolean isPoolable() throws java.sql.SQLException
Statement
is poolable or not.
isPoolable
in interface java.sql.Statement
true
if the Statement
is poolable; false
otherwise
java.sql.SQLException
- if this method is called on a closed
Statement
setPoolable(boolean)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |