atg.service.resourcepool
Class MonitoredCallableStatement

java.lang.Object
  extended by atg.service.resourcepool.MonitoredCallableStatement
All Implemented Interfaces:
java.sql.CallableStatement, java.sql.PreparedStatement, java.sql.Statement, java.sql.Wrapper

public class MonitoredCallableStatement
extends java.lang.Object
implements java.sql.CallableStatement

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)
           
<T> T
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

CLASS_VERSION

public static java.lang.String CLASS_VERSION
Class version string

Constructor Detail

MonitoredCallableStatement

public MonitoredCallableStatement(java.sql.CallableStatement pWrapped,
                                  ApplicationLogging pLog,
                                  ConnectionStats pStats,
                                  java.lang.String pId)
Constructs a new wrapper CallableStatement wrapper

Parameters:
pWrapped - the instance being wrapped
Method Detail

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
Wraps the call to getConnection

Specified by:
getConnection in interface java.sql.Statement
Throws:
java.sql.SQLException

addBatch

public void addBatch()
              throws java.sql.SQLException
Wraps the call to addBatch

Specified by:
addBatch in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

addBatch

public void addBatch(java.lang.String p0)
              throws java.sql.SQLException
Wraps the call to addBatch

Specified by:
addBatch in interface java.sql.Statement
Throws:
java.sql.SQLException

clearBatch

public void clearBatch()
                throws java.sql.SQLException
Wraps the call to clearBatch

Specified by:
clearBatch in interface java.sql.Statement
Throws:
java.sql.SQLException

executeBatch

public int[] executeBatch()
                   throws java.sql.SQLException
Wraps the call to executeBatch

Specified by:
executeBatch in interface java.sql.Statement
Throws:
java.sql.SQLException

executeQuery

public java.sql.ResultSet executeQuery(java.lang.String p0)
                                throws java.sql.SQLException
Wraps the call to executeQuery

Specified by:
executeQuery in interface java.sql.Statement
Throws:
java.sql.SQLException

executeUpdate

public int executeUpdate(java.lang.String p0)
                  throws java.sql.SQLException
Wraps the call to executeUpdate

Specified by:
executeUpdate in interface java.sql.Statement
Throws:
java.sql.SQLException

close

public void close()
           throws java.sql.SQLException
Wraps the call to close

Specified by:
close in interface java.sql.Statement
Throws:
java.sql.SQLException

getMaxFieldSize

public int getMaxFieldSize()
                    throws java.sql.SQLException
Wraps the call to getMaxFieldSize

Specified by:
getMaxFieldSize in interface java.sql.Statement
Throws:
java.sql.SQLException

setMaxFieldSize

public void setMaxFieldSize(int p0)
                     throws java.sql.SQLException
Wraps the call to setMaxFieldSize

Specified by:
setMaxFieldSize in interface java.sql.Statement
Throws:
java.sql.SQLException

getMaxRows

public int getMaxRows()
               throws java.sql.SQLException
Wraps the call to getMaxRows

Specified by:
getMaxRows in interface java.sql.Statement
Throws:
java.sql.SQLException

setMaxRows

public void setMaxRows(int p0)
                throws java.sql.SQLException
Wraps the call to setMaxRows

Specified by:
setMaxRows in interface java.sql.Statement
Throws:
java.sql.SQLException

setEscapeProcessing

public void setEscapeProcessing(boolean p0)
                         throws java.sql.SQLException
Wraps the call to setEscapeProcessing

Specified by:
setEscapeProcessing in interface java.sql.Statement
Throws:
java.sql.SQLException

getQueryTimeout

public int getQueryTimeout()
                    throws java.sql.SQLException
Wraps the call to getQueryTimeout

Specified by:
getQueryTimeout in interface java.sql.Statement
Throws:
java.sql.SQLException

setQueryTimeout

public void setQueryTimeout(int p0)
                     throws java.sql.SQLException
Wraps the call to setQueryTimeout

Specified by:
setQueryTimeout in interface java.sql.Statement
Throws:
java.sql.SQLException

getFetchDirection

public int getFetchDirection()
                      throws java.sql.SQLException
Wraps the call to getFetchDirection

Specified by:
getFetchDirection in interface java.sql.Statement
Throws:
java.sql.SQLException

setFetchDirection

public void setFetchDirection(int p0)
                       throws java.sql.SQLException
Wraps the call to setFetchDirection

Specified by:
setFetchDirection in interface java.sql.Statement
Throws:
java.sql.SQLException

getFetchSize

public int getFetchSize()
                 throws java.sql.SQLException
Wraps the call to getFetchSize

Specified by:
getFetchSize in interface java.sql.Statement
Throws:
java.sql.SQLException

setFetchSize

public void setFetchSize(int p0)
                  throws java.sql.SQLException
Wraps the call to setFetchSize

Specified by:
setFetchSize in interface java.sql.Statement
Throws:
java.sql.SQLException

getResultSetConcurrency

public int getResultSetConcurrency()
                            throws java.sql.SQLException
Wraps the call to getResultSetConcurrency

Specified by:
getResultSetConcurrency in interface java.sql.Statement
Throws:
java.sql.SQLException

getResultSetType

public int getResultSetType()
                     throws java.sql.SQLException
Wraps the call to getResultSetType

Specified by:
getResultSetType in interface java.sql.Statement
Throws:
java.sql.SQLException

cancel

public void cancel()
            throws java.sql.SQLException
Wraps the call to cancel

Specified by:
cancel in interface java.sql.Statement
Throws:
java.sql.SQLException

getWarnings

public java.sql.SQLWarning getWarnings()
                                throws java.sql.SQLException
Wraps the call to getWarnings

Specified by:
getWarnings in interface java.sql.Statement
Throws:
java.sql.SQLException

clearWarnings

public void clearWarnings()
                   throws java.sql.SQLException
Wraps the call to clearWarnings

Specified by:
clearWarnings in interface java.sql.Statement
Throws:
java.sql.SQLException

setCursorName

public void setCursorName(java.lang.String p0)
                   throws java.sql.SQLException
Wraps the call to setCursorName

Specified by:
setCursorName in interface java.sql.Statement
Throws:
java.sql.SQLException

execute

public boolean execute(java.lang.String p0)
                throws java.sql.SQLException
Wraps the call to execute

Specified by:
execute in interface java.sql.Statement
Throws:
java.sql.SQLException

getResultSet

public java.sql.ResultSet getResultSet()
                                throws java.sql.SQLException
Wraps the call to getResultSet

Specified by:
getResultSet in interface java.sql.Statement
Throws:
java.sql.SQLException

getMetaData

public java.sql.ResultSetMetaData getMetaData()
                                       throws java.sql.SQLException
Wraps the call to getMetaData

Specified by:
getMetaData in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

getUpdateCount

public int getUpdateCount()
                   throws java.sql.SQLException
Wraps the call to getUpdateCount

Specified by:
getUpdateCount in interface java.sql.Statement
Throws:
java.sql.SQLException

getMoreResults

public boolean getMoreResults()
                       throws java.sql.SQLException
Wraps the call to getMoreResults

Specified by:
getMoreResults in interface java.sql.Statement
Throws:
java.sql.SQLException

executeQuery

public java.sql.ResultSet executeQuery()
                                throws java.sql.SQLException
Wraps the call to executeQuery

Specified by:
executeQuery in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

executeUpdate

public int executeUpdate()
                  throws java.sql.SQLException
Wraps the call to executeUpdate

Specified by:
executeUpdate in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setNull

public void setNull(int p0,
                    int p1)
             throws java.sql.SQLException
Wraps the call to setNull

Specified by:
setNull in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setNull

public void setNull(int p0,
                    int p1,
                    java.lang.String p2)
             throws java.sql.SQLException
Wraps the call to setNull

Specified by:
setNull in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setArray

public void setArray(int p0,
                     java.sql.Array p1)
              throws java.sql.SQLException
Wraps the call to setArray

Specified by:
setArray in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setBlob

public void setBlob(int p0,
                    java.sql.Blob p1)
             throws java.sql.SQLException
Wraps the call to setBlob

Specified by:
setBlob in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setClob

public void setClob(int p0,
                    java.sql.Clob p1)
             throws java.sql.SQLException
Wraps the call to setClob

Specified by:
setClob in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setCharacterStream

public void setCharacterStream(int p0,
                               java.io.Reader p1,
                               int p2)
                        throws java.sql.SQLException
Wraps the call to setCharacterStream

Specified by:
setCharacterStream in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setBoolean

public void setBoolean(int p0,
                       boolean p1)
                throws java.sql.SQLException
Wraps the call to setBoolean

Specified by:
setBoolean in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setByte

public void setByte(int p0,
                    byte p1)
             throws java.sql.SQLException
Wraps the call to setByte

Specified by:
setByte in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setRef

public void setRef(int p0,
                   java.sql.Ref p1)
            throws java.sql.SQLException
Wraps the call to setRef

Specified by:
setRef in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setShort

public void setShort(int p0,
                     short p1)
              throws java.sql.SQLException
Wraps the call to setShort

Specified by:
setShort in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setInt

public void setInt(int p0,
                   int p1)
            throws java.sql.SQLException
Wraps the call to setInt

Specified by:
setInt in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setLong

public void setLong(int p0,
                    long p1)
             throws java.sql.SQLException
Wraps the call to setLong

Specified by:
setLong in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setFloat

public void setFloat(int p0,
                     float p1)
              throws java.sql.SQLException
Wraps the call to setFloat

Specified by:
setFloat in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setDouble

public void setDouble(int p0,
                      double p1)
               throws java.sql.SQLException
Wraps the call to setDouble

Specified by:
setDouble in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setBigDecimal

public void setBigDecimal(int p0,
                          java.math.BigDecimal p1)
                   throws java.sql.SQLException
Wraps the call to setBigDecimal

Specified by:
setBigDecimal in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setString

public void setString(int p0,
                      java.lang.String p1)
               throws java.sql.SQLException
Wraps the call to setString

Specified by:
setString in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setBytes

public void setBytes(int p0,
                     byte[] p1)
              throws java.sql.SQLException
Wraps the call to setBytes

Specified by:
setBytes in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setDate

public void setDate(int p0,
                    java.sql.Date p1)
             throws java.sql.SQLException
Wraps the call to setDate

Specified by:
setDate in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setDate

public void setDate(int p0,
                    java.sql.Date p1,
                    java.util.Calendar p2)
             throws java.sql.SQLException
Wraps the call to setDate

Specified by:
setDate in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setTime

public void setTime(int p0,
                    java.sql.Time p1)
             throws java.sql.SQLException
Wraps the call to setTime

Specified by:
setTime in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setTime

public void setTime(int p0,
                    java.sql.Time p1,
                    java.util.Calendar p2)
             throws java.sql.SQLException
Wraps the call to setTime

Specified by:
setTime in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setTimestamp

public void setTimestamp(int p0,
                         java.sql.Timestamp p1)
                  throws java.sql.SQLException
Wraps the call to setTimestamp

Specified by:
setTimestamp in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setTimestamp

public void setTimestamp(int p0,
                         java.sql.Timestamp p1,
                         java.util.Calendar p2)
                  throws java.sql.SQLException
Wraps the call to setTimestamp

Specified by:
setTimestamp in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setAsciiStream

public void setAsciiStream(int p0,
                           java.io.InputStream p1,
                           int p2)
                    throws java.sql.SQLException
Wraps the call to setAsciiStream

Specified by:
setAsciiStream in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setUnicodeStream

public void setUnicodeStream(int p0,
                             java.io.InputStream p1,
                             int p2)
                      throws java.sql.SQLException
Wraps the call to setUnicodeStream

Specified by:
setUnicodeStream in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setBinaryStream

public void setBinaryStream(int p0,
                            java.io.InputStream p1,
                            int p2)
                     throws java.sql.SQLException
Wraps the call to setBinaryStream

Specified by:
setBinaryStream in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

clearParameters

public void clearParameters()
                     throws java.sql.SQLException
Wraps the call to clearParameters

Specified by:
clearParameters in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setObject

public void setObject(int p0,
                      java.lang.Object p1,
                      int p2,
                      int p3)
               throws java.sql.SQLException
Wraps the call to setObject

Specified by:
setObject in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setObject

public void setObject(int p0,
                      java.lang.Object p1,
                      int p2)
               throws java.sql.SQLException
Wraps the call to setObject

Specified by:
setObject in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

setObject

public void setObject(int p0,
                      java.lang.Object p1)
               throws java.sql.SQLException
Wraps the call to setObject

Specified by:
setObject in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

execute

public boolean execute()
                throws java.sql.SQLException
Wraps the call to execute

Specified by:
execute in interface java.sql.PreparedStatement
Throws:
java.sql.SQLException

registerOutParameter

public void registerOutParameter(int p0,
                                 int p1)
                          throws java.sql.SQLException
Wraps the call to registerOutParameter

Specified by:
registerOutParameter in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

registerOutParameter

public void registerOutParameter(int p0,
                                 int p1,
                                 java.lang.String p2)
                          throws java.sql.SQLException
Wraps the call to registerOutParameter

Specified by:
registerOutParameter in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

registerOutParameter

public void registerOutParameter(int p0,
                                 int p1,
                                 int p2)
                          throws java.sql.SQLException
Wraps the call to registerOutParameter

Specified by:
registerOutParameter in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

wasNull

public boolean wasNull()
                throws java.sql.SQLException
Wraps the call to wasNull

Specified by:
wasNull in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getArray

public java.sql.Array getArray(int p0)
                        throws java.sql.SQLException
Wraps the call to getArray

Specified by:
getArray in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getBlob

public java.sql.Blob getBlob(int p0)
                      throws java.sql.SQLException
Wraps the call to getBlob

Specified by:
getBlob in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getClob

public java.sql.Clob getClob(int p0)
                      throws java.sql.SQLException
Wraps the call to getClob

Specified by:
getClob in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getString

public java.lang.String getString(int p0)
                           throws java.sql.SQLException
Wraps the call to getString

Specified by:
getString in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getBoolean

public boolean getBoolean(int p0)
                   throws java.sql.SQLException
Wraps the call to getBoolean

Specified by:
getBoolean in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getByte

public byte getByte(int p0)
             throws java.sql.SQLException
Wraps the call to getByte

Specified by:
getByte in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getShort

public short getShort(int p0)
               throws java.sql.SQLException
Wraps the call to getShort

Specified by:
getShort in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getInt

public int getInt(int p0)
           throws java.sql.SQLException
Wraps the call to getInt

Specified by:
getInt in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getLong

public long getLong(int p0)
             throws java.sql.SQLException
Wraps the call to getLong

Specified by:
getLong in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getFloat

public float getFloat(int p0)
               throws java.sql.SQLException
Wraps the call to getFloat

Specified by:
getFloat in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getDouble

public double getDouble(int p0)
                 throws java.sql.SQLException
Wraps the call to getDouble

Specified by:
getDouble in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getBigDecimal

public java.math.BigDecimal getBigDecimal(int p0)
                                   throws java.sql.SQLException
Wraps the call to getBigDecimal

Specified by:
getBigDecimal in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getBigDecimal

public java.math.BigDecimal getBigDecimal(int p0,
                                          int p1)
                                   throws java.sql.SQLException
Deprecated. 

Wraps the call to getBigDecimal

Specified by:
getBigDecimal in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getBytes

public byte[] getBytes(int p0)
                throws java.sql.SQLException
Wraps the call to getBytes

Specified by:
getBytes in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getDate

public java.sql.Date getDate(int p0)
                      throws java.sql.SQLException
Wraps the call to getDate

Specified by:
getDate in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getDate

public java.sql.Date getDate(int p0,
                             java.util.Calendar p1)
                      throws java.sql.SQLException
Wraps the call to getDate

Specified by:
getDate in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getTime

public java.sql.Time getTime(int p0)
                      throws java.sql.SQLException
Wraps the call to getTime

Specified by:
getTime in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getTime

public java.sql.Time getTime(int p0,
                             java.util.Calendar p1)
                      throws java.sql.SQLException
Wraps the call to getTime

Specified by:
getTime in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getTimestamp

public java.sql.Timestamp getTimestamp(int p0)
                                throws java.sql.SQLException
Wraps the call to getTimestamp

Specified by:
getTimestamp in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getTimestamp

public java.sql.Timestamp getTimestamp(int p0,
                                       java.util.Calendar p1)
                                throws java.sql.SQLException
Wraps the call to getTimestamp

Specified by:
getTimestamp in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getObject

public java.lang.Object getObject(int p0)
                           throws java.sql.SQLException
Wraps the call to getObject

Specified by:
getObject in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getObject

public java.lang.Object getObject(int p0,
                                  java.util.Map p1)
                           throws java.sql.SQLException
Wraps the call to getObject

Specified by:
getObject in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getRef

public java.sql.Ref getRef(int p0)
                    throws java.sql.SQLException
Wraps the call to getRef

Specified by:
getRef in interface java.sql.CallableStatement
Throws:
java.sql.SQLException

getWrapped

public java.sql.CallableStatement getWrapped()
Returns the original statement that this MonitoredCallableStatement is monitoring.


setWrapped

public void setWrapped(java.sql.CallableStatement pWrapped)

getMoreResults

public boolean getMoreResults(int current)
                       throws java.sql.SQLException
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.

There are no more results when the following is true:

      (!getMoreResults() && (getUpdateCount() == -1)
 

Specified by:
getMoreResults in interface java.sql.Statement
Parameters:
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
Returns:
true if the next result is a ResultSet object; false if it is an update count or there are no more results
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
execute(java.lang.String)

getGeneratedKeys

public java.sql.ResultSet getGeneratedKeys()
                                    throws java.sql.SQLException
Retrieves any auto-generated keys created as a result of executing this Statement object. If this Statement object did not generate any keys, an empty ResultSet object is returned.

Specified by:
getGeneratedKeys in interface java.sql.Statement
Returns:
a ResultSet object containing the auto-generated key(s) generated by the execution of this Statement object
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

executeUpdate

public int executeUpdate(java.lang.String sql,
                         int autoGeneratedKeys)
                  throws java.sql.SQLException
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.

Specified by:
executeUpdate in interface java.sql.Statement
Parameters:
sql - must be an SQL INSERT, UPDATE or DELETE statement or an SQL statement that returns nothing
autoGeneratedKeys - 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
Returns:
either the row count for INSERT, UPDATE or DELETE statements, or 0 for SQL statements that return nothing
Throws:
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 allowed
Since:
1.4

executeUpdate

public int executeUpdate(java.lang.String sql,
                         int[] columnIndexes)
                  throws java.sql.SQLException
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. The driver will ignore the array if the SQL statement is not an INSERT statement.

Specified by:
executeUpdate in interface java.sql.Statement
Parameters:
sql - an SQL INSERT, UPDATE or DELETE statement or an SQL statement that returns nothing, such as an SQL DDL statement
columnIndexes - an array of column indexes indicating the columns that should be returned from the inserted row
Returns:
either the row count for INSERT, UPDATE, or DELETE statements, or 0 for SQL statements that return nothing
Throws:
java.sql.SQLException - if a database access error occurs or the SQL statement returns a ResultSet object
Since:
1.4

executeUpdate

public int executeUpdate(java.lang.String sql,
                         java.lang.String[] columnNames)
                  throws java.sql.SQLException
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. The driver will ignore the array if the SQL statement is not an INSERT statement.

Specified by:
executeUpdate in interface java.sql.Statement
Parameters:
sql - an SQL INSERT, UPDATE or DELETE statement or an SQL statement that returns nothing
columnNames - an array of the names of the columns that should be returned from the inserted row
Returns:
either the row count for INSERT, UPDATE, or DELETE statements, or 0 for SQL statements that return nothing
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

execute

public boolean execute(java.lang.String sql,
                       int autoGeneratedKeys)
                throws java.sql.SQLException
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. The driver will ignore this signal if the SQL statement is not an 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).

Specified by:
execute in interface java.sql.Statement
Parameters:
sql - any SQL statement
autoGeneratedKeys - 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
Returns:
true if the first result is a ResultSet object; false if it is an update count or there are no results
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getResultSet(), getUpdateCount(), getMoreResults(), getGeneratedKeys()

execute

public boolean execute(java.lang.String sql,
                       int[] columnIndexes)
                throws java.sql.SQLException
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. This array contains the indexes of the columns in the target table that contain the auto-generated keys that should be made available. The driver will ignore the array if the given SQL statement is not an 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).

Specified by:
execute in interface java.sql.Statement
Parameters:
sql - any SQL statement
columnIndexes - 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
Returns:
true if the first result is a ResultSet object; false if it is an update count or there are no results
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getResultSet(), getUpdateCount(), getMoreResults()

execute

public boolean execute(java.lang.String sql,
                       java.lang.String[] columnNames)
                throws java.sql.SQLException
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. This array contains the names of the columns in the target table that contain the auto-generated keys that should be made available. The driver will ignore the array if the given SQL statement is not an 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).

Specified by:
execute in interface java.sql.Statement
Parameters:
sql - any SQL statement
columnNames - 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
Returns:
true if the next result is a ResultSet object; false if it is an update count or there are no more results
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getResultSet(), getUpdateCount(), getMoreResults(), getGeneratedKeys()

getResultSetHoldability

public int getResultSetHoldability()
                            throws java.sql.SQLException
Retrieves the result set holdability for ResultSet objects generated by this Statement object.

Specified by:
getResultSetHoldability in interface java.sql.Statement
Returns:
either ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

setURL

public void setURL(int parameterIndex,
                   java.net.URL x)
            throws java.sql.SQLException
Sets the designated parameter to the given java.net.URL value. The driver converts this to an SQL DATALINK value when it sends it to the database.

Specified by:
setURL in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
x - the java.net.URL object to be set
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

getParameterMetaData

public java.sql.ParameterMetaData getParameterMetaData()
                                                throws java.sql.SQLException
Retrieves the number, types and properties of this PreparedStatement object's parameters.

Specified by:
getParameterMetaData in interface java.sql.PreparedStatement
Returns:
a ParameterMetaData object that contains information about the number, types and properties of this PreparedStatement object's parameters
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
ParameterMetaData

registerOutParameter

public void registerOutParameter(java.lang.String parameterName,
                                 int sqlType)
                          throws java.sql.SQLException
Registers the OUT parameter named 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.

Specified by:
registerOutParameter in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
sqlType - 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.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
Types

registerOutParameter

public void registerOutParameter(java.lang.String parameterName,
                                 int sqlType,
                                 int scale)
                          throws java.sql.SQLException
Registers the parameter named 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.

Specified by:
registerOutParameter in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
sqlType - 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.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
Types

registerOutParameter

public void registerOutParameter(java.lang.String parameterName,
                                 int sqlType,
                                 java.lang.String typeName)
                          throws java.sql.SQLException
Registers the designated output parameter. This version of the method 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.

Specified by:
registerOutParameter in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
sqlType - a value from Types
typeName - the fully-qualified name of an SQL structured type
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
Types

getURL

public java.net.URL getURL(int parameterIndex)
                    throws java.sql.SQLException
Retrieves the value of the designated JDBC DATALINK parameter as a java.net.URL object.

Specified by:
getURL in interface java.sql.CallableStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2,...
Returns:
a java.net.URL object that represents the JDBC DATALINK value used as the designated parameter
Throws:
java.sql.SQLException - if a database access error occurs, or if the URL being returned is not a valid URL on the Java platform
Since:
1.4
See Also:
setURL(int, java.net.URL)

setURL

public void setURL(java.lang.String parameterName,
                   java.net.URL val)
            throws java.sql.SQLException
Sets the designated parameter to the given java.net.URL object. The driver converts this to an SQL DATALINK value when it sends it to the database.

Specified by:
setURL in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
val - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs, or if a URL is malformed
Since:
1.4
See Also:
getURL(int)

setNull

public void setNull(java.lang.String parameterName,
                    int sqlType)
             throws java.sql.SQLException
Sets the designated parameter to SQL NULL.

Note: You must specify the parameter's SQL type.

Specified by:
setNull in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
sqlType - the SQL type code defined in Types
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

setBoolean

public void setBoolean(java.lang.String parameterName,
                       boolean x)
                throws java.sql.SQLException
Sets the designated parameter to the given Java boolean value. The driver converts this to an SQL BIT value when it sends it to the database.

Specified by:
setBoolean in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getBoolean(int)

setByte

public void setByte(java.lang.String parameterName,
                    byte x)
             throws java.sql.SQLException
Sets the designated parameter to the given Java byte value. The driver converts this to an SQL TINYINT value when it sends it to the database.

Specified by:
setByte in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getByte(int)

setShort

public void setShort(java.lang.String parameterName,
                     short x)
              throws java.sql.SQLException
Sets the designated parameter to the given Java short value. The driver converts this to an SQL SMALLINT value when it sends it to the database.

Specified by:
setShort in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getShort(int)

setInt

public void setInt(java.lang.String parameterName,
                   int x)
            throws java.sql.SQLException
Sets the designated parameter to the given Java int value. The driver converts this to an SQL INTEGER value when it sends it to the database.

Specified by:
setInt in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getInt(int)

setLong

public void setLong(java.lang.String parameterName,
                    long x)
             throws java.sql.SQLException
Sets the designated parameter to the given Java long value. The driver converts this to an SQL BIGINT value when it sends it to the database.

Specified by:
setLong in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getLong(int)

setFloat

public void setFloat(java.lang.String parameterName,
                     float x)
              throws java.sql.SQLException
Sets the designated parameter to the given Java float value. The driver converts this to an SQL FLOAT value when it sends it to the database.

Specified by:
setFloat in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getFloat(int)

setDouble

public void setDouble(java.lang.String parameterName,
                      double x)
               throws java.sql.SQLException
Sets the designated parameter to the given Java double value. The driver converts this to an SQL DOUBLE value when it sends it to the database.

Specified by:
setDouble in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getDouble(int)

setBigDecimal

public void setBigDecimal(java.lang.String parameterName,
                          java.math.BigDecimal x)
                   throws java.sql.SQLException
Sets the designated parameter to the given java.math.BigDecimal value. The driver converts this to an SQL NUMERIC value when it sends it to the database.

Specified by:
setBigDecimal in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getBigDecimal(int)

setString

public void setString(java.lang.String parameterName,
                      java.lang.String x)
               throws java.sql.SQLException
Sets the designated parameter to the given Java 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.

Specified by:
setString in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getString(int)

setBytes

public void setBytes(java.lang.String parameterName,
                     byte[] x)
              throws java.sql.SQLException
Sets the designated parameter to the given Java array of bytes. The driver converts this to an SQL 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.

Specified by:
setBytes in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getBytes(int)

setDate

public void setDate(java.lang.String parameterName,
                    java.sql.Date x)
             throws java.sql.SQLException
Sets the designated parameter to the given Date value. The driver converts this to an SQL DATE value when it sends it to the database.

Specified by:
setDate in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getDate(int)

setTime

public void setTime(java.lang.String parameterName,
                    java.sql.Time x)
             throws java.sql.SQLException
Sets the designated parameter to the given Time value. The driver converts this to an SQL TIME value when it sends it to the database.

Specified by:
setTime in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getTime(int)

setTimestamp

public void setTimestamp(java.lang.String parameterName,
                         java.sql.Timestamp x)
                  throws java.sql.SQLException
Sets the designated parameter to the given Timestamp value. The driver converts this to an SQL TIMESTAMP value when it sends it to the database.

Specified by:
setTimestamp in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getTimestamp(int)

setAsciiStream

public void setAsciiStream(java.lang.String parameterName,
                           java.io.InputStream x,
                           int length)
                    throws java.sql.SQLException
Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large ASCII value is input to a 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.

Specified by:
setAsciiStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the Java input stream that contains the ASCII parameter value
length - the number of bytes in the stream
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

setBinaryStream

public void setBinaryStream(java.lang.String parameterName,
                            java.io.InputStream x,
                            int length)
                     throws java.sql.SQLException
Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large binary value is input to a 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.

Specified by:
setBinaryStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the java input stream which contains the binary parameter value
length - the number of bytes in the stream
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

setObject

public void setObject(java.lang.String parameterName,
                      java.lang.Object x,
                      int targetSqlType,
                      int scale)
               throws java.sql.SQLException
Sets the value of the designated parameter with the given object. The second argument must be an object type; for integral values, the 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.

Specified by:
setObject in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the object containing the input parameter value
targetSqlType - 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.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
Types, getObject(int)

setObject

public void setObject(java.lang.String parameterName,
                      java.lang.Object x,
                      int targetSqlType)
               throws java.sql.SQLException
Sets the value of the designated parameter with the given object. This method is like the method setObject above, except that it assumes a scale of zero.

Specified by:
setObject in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the object containing the input parameter value
targetSqlType - the SQL type (as defined in Types) to be sent to the database
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getObject(int)

setObject

public void setObject(java.lang.String parameterName,
                      java.lang.Object x)
               throws java.sql.SQLException
Sets the value of the designated parameter with the given object. The second parameter must be of type 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.

Specified by:
setObject in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the object containing the input parameter value
Throws:
java.sql.SQLException - if a database access error occurs or if the given Object parameter is ambiguous
Since:
1.4
See Also:
getObject(int)

setCharacterStream

public void setCharacterStream(java.lang.String parameterName,
                               java.io.Reader reader,
                               int length)
                        throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
reader - the Reader object that contains the UNICODE data used as the designated parameter
length - the number of characters in the stream
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

setDate

public void setDate(java.lang.String parameterName,
                    java.sql.Date x,
                    java.util.Calendar cal)
             throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setDate in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
cal - the Calendar object the driver will use to construct the date
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getDate(int)

setTime

public void setTime(java.lang.String parameterName,
                    java.sql.Time x,
                    java.util.Calendar cal)
             throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setTime in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
cal - the Calendar object the driver will use to construct the time
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getTime(int)

setTimestamp

public void setTimestamp(java.lang.String parameterName,
                         java.sql.Timestamp x,
                         java.util.Calendar cal)
                  throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setTimestamp in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
cal - the Calendar object the driver will use to construct the timestamp
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
getTimestamp(int)

setNull

public void setNull(java.lang.String parameterName,
                    int sqlType,
                    java.lang.String typeName)
             throws java.sql.SQLException
Sets the designated parameter to SQL 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.

Specified by:
setNull in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
sqlType - 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
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

getString

public java.lang.String getString(java.lang.String parameterName)
                           throws java.sql.SQLException
Retrieves the value of a JDBC 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.

Specified by:
getString in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setString(int, java.lang.String)

getBoolean

public boolean getBoolean(java.lang.String parameterName)
                   throws java.sql.SQLException
Retrieves the value of a JDBC BIT parameter as a boolean in the Java programming language.

Specified by:
getBoolean in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is false.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setBoolean(int, boolean)

getByte

public byte getByte(java.lang.String parameterName)
             throws java.sql.SQLException
Retrieves the value of a JDBC TINYINT parameter as a byte in the Java programming language.

Specified by:
getByte in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is 0.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setByte(int, byte)

getShort

public short getShort(java.lang.String parameterName)
               throws java.sql.SQLException
Retrieves the value of a JDBC SMALLINT parameter as a short in the Java programming language.

Specified by:
getShort in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is 0.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setShort(int, short)

getInt

public int getInt(java.lang.String parameterName)
           throws java.sql.SQLException
Retrieves the value of a JDBC INTEGER parameter as an int in the Java programming language.

Specified by:
getInt in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is 0.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setInt(int, int)

getLong

public long getLong(java.lang.String parameterName)
             throws java.sql.SQLException
Retrieves the value of a JDBC BIGINT parameter as a long in the Java programming language.

Specified by:
getLong in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is 0.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setLong(int, long)

getFloat

public float getFloat(java.lang.String parameterName)
               throws java.sql.SQLException
Retrieves the value of a JDBC FLOAT parameter as a float in the Java programming language.

Specified by:
getFloat in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is 0.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setFloat(int, float)

getDouble

public double getDouble(java.lang.String parameterName)
                 throws java.sql.SQLException
Retrieves the value of a JDBC DOUBLE parameter as a double in the Java programming language.

Specified by:
getDouble in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is 0.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setDouble(int, double)

getBytes

public byte[] getBytes(java.lang.String parameterName)
                throws java.sql.SQLException
Retrieves the value of a JDBC BINARY or VARBINARY parameter as an array of byte values in the Java programming language.

Specified by:
getBytes in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setBytes(int, byte[])

getDate

public java.sql.Date getDate(java.lang.String parameterName)
                      throws java.sql.SQLException
Retrieves the value of a JDBC DATE parameter as a Date object.

Specified by:
getDate in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setDate(int, java.sql.Date)

getTime

public java.sql.Time getTime(java.lang.String parameterName)
                      throws java.sql.SQLException
Retrieves the value of a JDBC TIME parameter as a Time object.

Specified by:
getTime in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setTime(int, java.sql.Time)

getTimestamp

public java.sql.Timestamp getTimestamp(java.lang.String parameterName)
                                throws java.sql.SQLException
Retrieves the value of a JDBC TIMESTAMP parameter as a Timestamp object.

Specified by:
getTimestamp in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setTimestamp(int, java.sql.Timestamp)

getObject

public java.lang.Object getObject(java.lang.String parameterName)
                           throws java.sql.SQLException
Retrieves the value of a parameter as an 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.

Specified by:
getObject in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
A java.lang.Object holding the OUT parameter value.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
Types, setObject(int, java.lang.Object, int, int)

getBigDecimal

public java.math.BigDecimal getBigDecimal(java.lang.String parameterName)
                                   throws java.sql.SQLException
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.

Specified by:
getBigDecimal in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value in full precision. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setBigDecimal(int, java.math.BigDecimal)

getObject

public java.lang.Object getObject(java.lang.String parameterName,
                                  java.util.Map map)
                           throws java.sql.SQLException
Returns an object representing the value of OUT parameter 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.

Specified by:
getObject in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
map - the mapping from SQL type names to Java classes
Returns:
a java.lang.Object holding the OUT parameter value
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setObject(int, java.lang.Object, int, int)

getRef

public java.sql.Ref getRef(java.lang.String parameterName)
                    throws java.sql.SQLException
Retrieves the value of a JDBC REF(<structured-type>) parameter as a Ref object in the Java programming language.

Specified by:
getRef in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value as a Ref object in the Java programming language. If the value was SQL NULL, the value null is returned.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

getBlob

public java.sql.Blob getBlob(java.lang.String parameterName)
                      throws java.sql.SQLException
Retrieves the value of a JDBC BLOB parameter as a Blob object in the Java programming language.

Specified by:
getBlob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value as a Blob object in the Java programming language. If the value was SQL NULL, the value null is returned.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

getClob

public java.sql.Clob getClob(java.lang.String parameterName)
                      throws java.sql.SQLException
Retrieves the value of a JDBC CLOB parameter as a Clob object in the Java programming language.

Specified by:
getClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value as a Clob object in the Java programming language. If the value was SQL NULL, the value null is returned.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

getArray

public java.sql.Array getArray(java.lang.String parameterName)
                        throws java.sql.SQLException
Retrieves the value of a JDBC ARRAY parameter as an Array object in the Java programming language.

Specified by:
getArray in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value as an Array object in Java programming language. If the value was SQL NULL, the value null is returned.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4

getDate

public java.sql.Date getDate(java.lang.String parameterName,
                             java.util.Calendar cal)
                      throws java.sql.SQLException
Retrieves the value of a JDBC 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.

Specified by:
getDate in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
cal - the Calendar object the driver will use to construct the date
Returns:
the parameter value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setDate(int, java.sql.Date)

getTime

public java.sql.Time getTime(java.lang.String parameterName,
                             java.util.Calendar cal)
                      throws java.sql.SQLException
Retrieves the value of a JDBC 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.

Specified by:
getTime in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
cal - the Calendar object the driver will use to construct the time
Returns:
the parameter value; if the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setTime(int, java.sql.Time)

getTimestamp

public java.sql.Timestamp getTimestamp(java.lang.String parameterName,
                                       java.util.Calendar cal)
                                throws java.sql.SQLException
Retrieves the value of a JDBC 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.

Specified by:
getTimestamp in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
cal - the Calendar object the driver will use to construct the timestamp
Returns:
the parameter value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.4
See Also:
setTimestamp(int, java.sql.Timestamp)

getURL

public java.net.URL getURL(java.lang.String parameterName)
                    throws java.sql.SQLException
Retrieves the value of a JDBC DATALINK parameter as a java.net.URL object.

Specified by:
getURL in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value as a java.net.URL object in the Java programming language. If the value was SQL NULL, the value null is returned.
Throws:
java.sql.SQLException - if a database access error occurs, or if there is a problem with the URL
Since:
1.4
See Also:
setURL(int, java.net.URL)

getRowId

public java.sql.RowId getRowId(int parameterIndex)
                        throws java.sql.SQLException
Retrieves the value of the designated JDBC ROWID parameter as a java.sql.RowId object.

Specified by:
getRowId in interface java.sql.CallableStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2,...
Returns:
a 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.
Throws:
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 method
Since:
1.6

getRowId

public java.sql.RowId getRowId(java.lang.String parameterName)
                        throws java.sql.SQLException
Retrieves the value of the designated JDBC ROWID parameter as a java.sql.RowId object.

Specified by:
getRowId in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
a 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.
Throws:
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 method
Since:
1.6

setRowId

public void setRowId(java.lang.String parameterName,
                     java.sql.RowId x)
              throws java.sql.SQLException
Sets the designated parameter to the given java.sql.RowId object. The driver converts this to a SQL ROWID when it sends it to the database.

Specified by:
setRowId in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the parameter value
Throws:
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 method
Since:
1.6

setNString

public void setNString(java.lang.String parameterName,
                       java.lang.String value)
                throws java.sql.SQLException
Sets the designated parameter to the given String object. The driver converts this to a SQL NCHAR or NVARCHAR or LONGNVARCHAR

Specified by:
setNString in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter to be set
value - the parameter value
Throws:
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 method
Since:
1.6

setNCharacterStream

public void setNCharacterStream(java.lang.String parameterName,
                                java.io.Reader value,
                                long length)
                         throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setNCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter to be set
value - the parameter value
length - the number of characters in the parameter data.
Throws:
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 method
Since:
1.6

setNClob

public void setNClob(java.lang.String parameterName,
                     java.sql.NClob value)
              throws java.sql.SQLException
Sets the designated parameter to a java.sql.NClob object. The object implements the java.sql.NClob interface. This NClob object maps to a SQL NCLOB.

Specified by:
setNClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter to be set
value - the parameter value
Throws:
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 method
Since:
1.6

setClob

public void setClob(java.lang.String parameterName,
                    java.io.Reader reader,
                    long length)
             throws java.sql.SQLException
Sets the designated parameter to a 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

Specified by:
setClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter to be set
reader - An object that contains the data to set the parameter value to.
length - the number of characters in the parameter data.
Throws:
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 method
Since:
1.6

setBlob

public void setBlob(java.lang.String parameterName,
                    java.io.InputStream inputStream,
                    long length)
             throws java.sql.SQLException
Sets the designated parameter to a 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

Specified by:
setBlob in interface java.sql.CallableStatement
Parameters:
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.
Throws:
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 method
Since:
1.6

setNClob

public void setNClob(java.lang.String parameterName,
                     java.io.Reader reader,
                     long length)
              throws java.sql.SQLException
Sets the designated parameter to a 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

Specified by:
setNClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter to be set
reader - An object that contains the data to set the parameter value to.
length - the number of characters in the parameter data.
Throws:
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 method
Since:
1.6

getNClob

public java.sql.NClob getNClob(int parameterIndex)
                        throws java.sql.SQLException
Retrieves the value of the designated JDBC NCLOB parameter as a java.sql.NClob object in the Java programming language.

Specified by:
getNClob in interface java.sql.CallableStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, and so on
Returns:
the parameter value as a NClob object in the Java programming language. If the value was SQL NULL, the value null is returned.
Throws:
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 method
Since:
1.6

getNClob

public java.sql.NClob getNClob(java.lang.String parameterName)
                        throws java.sql.SQLException
Retrieves the value of a JDBC NCLOB parameter as a java.sql.NClob object in the Java programming language.

Specified by:
getNClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
the parameter value as a NClob object in the Java programming language. If the value was SQL NULL, the value null is returned.
Throws:
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 method
Since:
1.6

setSQLXML

public void setSQLXML(java.lang.String parameterName,
                      java.sql.SQLXML xmlObject)
               throws java.sql.SQLException
Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an SQL XML value when it sends it to the database.

Specified by:
setSQLXML in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
xmlObject - a SQLXML object that maps an SQL XML value
Throws:
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 method
Since:
1.6

getSQLXML

public java.sql.SQLXML getSQLXML(int parameterIndex)
                          throws java.sql.SQLException
Retrieves the value of the designated SQL XML parameter as a java.sql.SQLXML object in the Java programming language.

Specified by:
getSQLXML in interface java.sql.CallableStatement
Parameters:
parameterIndex - index of the first parameter is 1, the second is 2, ...
Returns:
a SQLXML object that maps an SQL XML value
Throws:
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 method
Since:
1.6

getSQLXML

public java.sql.SQLXML getSQLXML(java.lang.String parameterName)
                          throws java.sql.SQLException
Retrieves the value of the designated SQL XML parameter as a java.sql.SQLXML object in the Java programming language.

Specified by:
getSQLXML in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
a SQLXML object that maps an SQL XML value
Throws:
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 method
Since:
1.6

getNString

public java.lang.String getNString(int parameterIndex)
                            throws java.sql.SQLException
Retrieves the value of the designated 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.

Specified by:
getNString in interface java.sql.CallableStatement
Parameters:
parameterIndex - index of the first parameter is 1, the second is 2, ...
Returns:
a String object that maps an NCHAR, NVARCHAR or LONGNVARCHAR value
Throws:
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 method
Since:
1.6
See Also:
setNString(java.lang.String, java.lang.String)

getNString

public java.lang.String getNString(java.lang.String parameterName)
                            throws java.sql.SQLException
Retrieves the value of the designated 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.

Specified by:
getNString in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
a String object that maps an NCHAR, NVARCHAR or LONGNVARCHAR value
Throws:
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 method
Since:
1.6
See Also:
setNString(java.lang.String, java.lang.String)

getNCharacterStream

public java.io.Reader getNCharacterStream(int parameterIndex)
                                   throws java.sql.SQLException
Retrieves the value of the designated parameter as a Reader object in the Java programming language. It is intended for use when accessing NCHAR,NVARCHAR and LONGNVARCHAR parameters.

Specified by:
getNCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
Returns:
a Reader object that contains the parameter value; if the value is SQL NULL, the value returned is null in the Java programming language.
Throws:
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 method
Since:
1.6

getNCharacterStream

public java.io.Reader getNCharacterStream(java.lang.String parameterName)
                                   throws java.sql.SQLException
Retrieves the value of the designated parameter as a Reader object in the Java programming language. It is intended for use when accessing NCHAR,NVARCHAR and LONGNVARCHAR parameters.

Specified by:
getNCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
a Reader object that contains the parameter value; if the value is SQL NULL, the value returned is null in the Java programming language
Throws:
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 method
Since:
1.6

getCharacterStream

public java.io.Reader getCharacterStream(int parameterIndex)
                                  throws java.sql.SQLException
Retrieves the value of the designated parameter as a Reader object in the Java programming language.

Specified by:
getCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
Returns:
a Reader object that contains the parameter value; if the value is SQL NULL, the value returned is null in the Java programming language.
Throws:
java.sql.SQLException - if the parameterIndex is not valid; if a database access error occurs or this method is called on a closed CallableStatement
Since:
1.6

getCharacterStream

public java.io.Reader getCharacterStream(java.lang.String parameterName)
                                  throws java.sql.SQLException
Retrieves the value of the designated parameter as a Reader object in the Java programming language.

Specified by:
getCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
Returns:
a Reader object that contains the parameter value; if the value is SQL NULL, the value returned is null in the Java programming language
Throws:
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 method
Since:
1.6

setBlob

public void setBlob(java.lang.String parameterName,
                    java.sql.Blob x)
             throws java.sql.SQLException
Sets the designated parameter to the given java.sql.Blob object. The driver converts this to an SQL BLOB value when it sends it to the database.

Specified by:
setBlob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - a Blob object that maps an SQL BLOB value
Throws:
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 method
Since:
1.6

setClob

public void setClob(java.lang.String parameterName,
                    java.sql.Clob x)
             throws java.sql.SQLException
Sets the designated parameter to the given java.sql.Clob object. The driver converts this to an SQL CLOB value when it sends it to the database.

Specified by:
setClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - a Clob object that maps an SQL CLOB value
Throws:
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 method
Since:
1.6

setAsciiStream

public void setAsciiStream(java.lang.String parameterName,
                           java.io.InputStream x,
                           long length)
                    throws java.sql.SQLException
Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large ASCII value is input to a 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.

Specified by:
setAsciiStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the Java input stream that contains the ASCII parameter value
length - the number of bytes in the stream
Throws:
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 method
Since:
1.6

setBinaryStream

public void setBinaryStream(java.lang.String parameterName,
                            java.io.InputStream x,
                            long length)
                     throws java.sql.SQLException
Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large binary value is input to a 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.

Specified by:
setBinaryStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the java input stream which contains the binary parameter value
length - the number of bytes in the stream
Throws:
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 method
Since:
1.6

setCharacterStream

public void setCharacterStream(java.lang.String parameterName,
                               java.io.Reader reader,
                               long length)
                        throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
reader - the Reader object that contains the UNICODE data used as the designated parameter
length - the number of characters in the stream
Throws:
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 method
Since:
1.6

setAsciiStream

public void setAsciiStream(java.lang.String parameterName,
                           java.io.InputStream x)
                    throws java.sql.SQLException
Sets the designated parameter to the given input stream. When a very large ASCII value is input to a 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.

Specified by:
setAsciiStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the Java input stream that contains the ASCII parameter value
Throws:
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 method
Since:
1.6

setBinaryStream

public void setBinaryStream(java.lang.String parameterName,
                            java.io.InputStream x)
                     throws java.sql.SQLException
Sets the designated parameter to the given input stream. When a very large binary value is input to a 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.

Specified by:
setBinaryStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
x - the java input stream which contains the binary parameter value
Throws:
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 method
Since:
1.6

setCharacterStream

public void setCharacterStream(java.lang.String parameterName,
                               java.io.Reader reader)
                        throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
reader - the Reader object that contains the Unicode data
Throws:
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 method
Since:
1.6

setNCharacterStream

public void setNCharacterStream(java.lang.String parameterName,
                                java.io.Reader value)
                         throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setNCharacterStream in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
value - the parameter value
Throws:
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 method
Since:
1.6

setClob

public void setClob(java.lang.String parameterName,
                    java.io.Reader reader)
             throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
reader - An object that contains the data to set the parameter value to.
Throws:
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 method
Since:
1.6

setBlob

public void setBlob(java.lang.String parameterName,
                    java.io.InputStream inputStream)
             throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setBlob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
inputStream - An object that contains the data to set the parameter value to.
Throws:
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 method
Since:
1.6

setNClob

public void setNClob(java.lang.String parameterName,
                     java.io.Reader reader)
              throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setNClob in interface java.sql.CallableStatement
Parameters:
parameterName - the name of the parameter
reader - An object that contains the data to set the parameter value to.
Throws:
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 method
Since:
1.6

setRowId

public void setRowId(int parameterIndex,
                     java.sql.RowId x)
              throws java.sql.SQLException
Sets the designated parameter to the given java.sql.RowId object. The driver converts this to a SQL ROWID value when it sends it to the database

Specified by:
setRowId in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
x - the parameter value
Throws:
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 method
Since:
1.6

setNString

public void setNString(int parameterIndex,
                       java.lang.String value)
                throws java.sql.SQLException
Sets the designated paramter to the given 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.

Specified by:
setNString in interface java.sql.PreparedStatement
Parameters:
parameterIndex - of the first parameter is 1, the second is 2, ...
value - the parameter value
Throws:
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 method
Since:
1.6

setNCharacterStream

public void setNCharacterStream(int parameterIndex,
                                java.io.Reader value,
                                long length)
                         throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setNCharacterStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - of the first parameter is 1, the second is 2, ...
value - the parameter value
length - the number of characters in the parameter data.
Throws:
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 method
Since:
1.6

setNClob

public void setNClob(int parameterIndex,
                     java.sql.NClob value)
              throws java.sql.SQLException
Sets the designated parameter to a java.sql.NClob object. The driver converts this to a SQL NCLOB value when it sends it to the database.

Specified by:
setNClob in interface java.sql.PreparedStatement
Parameters:
parameterIndex - of the first parameter is 1, the second is 2, ...
value - the parameter value
Throws:
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 method
Since:
1.6

setClob

public void setClob(int parameterIndex,
                    java.io.Reader reader,
                    long length)
             throws java.sql.SQLException
Sets the designated parameter to a 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

Specified by:
setClob in interface java.sql.PreparedStatement
Parameters:
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.
Throws:
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 method
Since:
1.6

setBlob

public void setBlob(int parameterIndex,
                    java.io.InputStream inputStream,
                    long length)
             throws java.sql.SQLException
Sets the designated parameter to a 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

Specified by:
setBlob in interface java.sql.PreparedStatement
Parameters:
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.
Throws:
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 method
Since:
1.6

setNClob

public void setNClob(int parameterIndex,
                     java.io.Reader reader,
                     long length)
              throws java.sql.SQLException
Sets the designated parameter to a 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

Specified by:
setNClob in interface java.sql.PreparedStatement
Parameters:
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.
Throws:
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 method
Since:
1.6

setSQLXML

public void setSQLXML(int parameterIndex,
                      java.sql.SQLXML xmlObject)
               throws java.sql.SQLException
Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an SQL XML value when it sends it to the database.

Specified by:
setSQLXML in interface java.sql.PreparedStatement
Parameters:
parameterIndex - index of the first parameter is 1, the second is 2, ...
xmlObject - a SQLXML object that maps an SQL XML value
Throws:
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 method
Since:
1.6

setAsciiStream

public void setAsciiStream(int parameterIndex,
                           java.io.InputStream x,
                           long length)
                    throws java.sql.SQLException
Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large ASCII value is input to a 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.

Specified by:
setAsciiStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
x - the Java input stream that contains the ASCII parameter value
length - the number of bytes in the stream
Throws:
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
Since:
1.6

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            java.io.InputStream x,
                            long length)
                     throws java.sql.SQLException
Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large binary value is input to a 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.

Specified by:
setBinaryStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
x - the java input stream which contains the binary parameter value
length - the number of bytes in the stream
Throws:
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
Since:
1.6

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               java.io.Reader reader,
                               long length)
                        throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setCharacterStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
reader - the java.io.Reader object that contains the Unicode data
length - the number of characters in the stream
Throws:
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
Since:
1.6

setAsciiStream

public void setAsciiStream(int parameterIndex,
                           java.io.InputStream x)
                    throws java.sql.SQLException
Sets the designated parameter to the given input stream. When a very large ASCII value is input to a 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.

Specified by:
setAsciiStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
x - the Java input stream that contains the ASCII parameter value
Throws:
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 method
Since:
1.6

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            java.io.InputStream x)
                     throws java.sql.SQLException
Sets the designated parameter to the given input stream. When a very large binary value is input to a 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.

Specified by:
setBinaryStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
x - the java input stream which contains the binary parameter value
Throws:
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 method
Since:
1.6

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               java.io.Reader reader)
                        throws java.sql.SQLException
Sets the designated parameter to the given 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.

Specified by:
setCharacterStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - the first parameter is 1, the second is 2, ...
reader - the java.io.Reader object that contains the Unicode data
Throws:
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 method
Since:
1.6

setNCharacterStream

public void setNCharacterStream(int parameterIndex,
                                java.io.Reader value)
                         throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setNCharacterStream in interface java.sql.PreparedStatement
Parameters:
parameterIndex - of the first parameter is 1, the second is 2, ...
value - the parameter value
Throws:
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 method
Since:
1.6

setClob

public void setClob(int parameterIndex,
                    java.io.Reader reader)
             throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setClob in interface java.sql.PreparedStatement
Parameters:
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.
Throws:
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 PreparedStatementor if parameterIndex does not correspond to a parameter marker in the SQL statement
java.sql.SQLFeatureNotSupportedException - if the JDBC driver does not support this method
Since:
1.6

setBlob

public void setBlob(int parameterIndex,
                    java.io.InputStream inputStream)
             throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setBlob in interface java.sql.PreparedStatement
Parameters:
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.
Throws:
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 method
Since:
1.6

setNClob

public void setNClob(int parameterIndex,
                     java.io.Reader reader)
              throws java.sql.SQLException
Sets the designated parameter to a 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.

Specified by:
setNClob in interface java.sql.PreparedStatement
Parameters:
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.
Throws:
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 method
Since:
1.6

isWrapperFor

public boolean isWrapperFor(java.lang.Class<?> pInterface)
                     throws java.sql.SQLException
Returns true if this class implements the pInterface argument

Specified by:
isWrapperFor in interface java.sql.Wrapper
Parameters:
pInterface - the interface to test
Returns:
true of this instance implements the interface, false otherwise
Throws:
java.sql.SQLException - if there's an error determining whether this is a wrapper for the interface
Since:
1.6

unwrap

public <T> T unwrap(java.lang.Class<T> pInterface)
         throws java.sql.SQLException
Returns an object that implements the given interface

Specified by:
unwrap in interface java.sql.Wrapper
Parameters:
pInterface - the interface of the object to return
Throws:
java.sql.SQLException - if no object is found that implements the given interface
Since:
1.6

isClosed

public boolean isClosed()
                 throws java.sql.SQLException
Retrieves whether this Statement object has been closed. A Statement is closed if the method close has been called on it, or if it is automatically closed.

Specified by:
isClosed in interface java.sql.Statement
Returns:
true if this Statement object is closed; false if it is still open
Throws:
java.sql.SQLException - if a database access error occurs
Since:
1.6

setPoolable

public void setPoolable(boolean poolable)
                 throws java.sql.SQLException
Requests that a 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.

Specified by:
setPoolable in interface java.sql.Statement
Parameters:
poolable - requests that the statement be pooled if true and that the statement not be pooled if false

Throws:
java.sql.SQLException - if this method is called on a closed Statement

Since:
1.6

isPoolable

public boolean isPoolable()
                   throws java.sql.SQLException
Returns a value indicating whether the Statement is poolable or not.

Specified by:
isPoolable in interface java.sql.Statement
Returns:
true if the Statement is poolable; false otherwise

Throws:
java.sql.SQLException - if this method is called on a closed Statement

Since:
1.6

See Also:
setPoolable(boolean)