atg.service.resourcepool
Class MonitoredPreparedStatement

java.lang.Object
  atg.service.resourcepool.MonitoredPreparedStatement

All Implemented Interfaces:

java.sql.PreparedStatement, java.sql.Statement

public class MonitoredPreparedStatement
extends java.lang.Object
implements java.sql.PreparedStatement

This class is a wrapper for java.sql.PreparedStatement. All calls are passed through to an embedded instance of java.sql.PreparedStatement.

Field Summary

static java.lang.String	CLASS_VERSION Class version string
protected static java.lang.String	EXECUTE_PREPARED_QUERY
protected static java.lang.String	EXECUTE_PREPARED_UPDATE

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

MonitoredPreparedStatement(java.sql.PreparedStatement pWrapped, ApplicationLogging pLog, ConnectionStats pStats, java.lang.String pId)
Constructs a new wrapper java.sql.PreparedStatement wrapper

MonitoredPreparedStatement(java.sql.PreparedStatement pWrapped, ApplicationLogging pLog, ConnectionStats pStats, java.lang.String pId, java.lang.String pStatement)
Constructs a new wrapper java.sql.PreparedStatement 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.Connection	getConnection() Wraps the call to getConnection
int	getFetchDirection() Wraps the call to getFetchDirection
int	getFetchSize() Wraps the call to getFetchSize
java.sql.ResultSet	getGeneratedKeys() Retrieves any auto-generated keys created as a result of executing this Statement object.
int	getMaxFieldSize() Wraps the call to getMaxFieldSize
int	getMaxRows() Wraps the call to getMaxRows
java.sql.ResultSetMetaData	getMetaData() Wraps the call to getMetaData
MonitoredConnection	getMonitoredConnection()
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.sql.ParameterMetaData	getParameterMetaData() Retrieves the number, types and properties of this PreparedStatement object's parameters.
int	getQueryTimeout() Wraps the call to getQueryTimeout
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
int	getUpdateCount() Wraps the call to getUpdateCount
java.sql.SQLWarning	getWarnings() Wraps the call to getWarnings
java.sql.PreparedStatement	getWrapped() Returns the original statement that this MonitoredPreparedStatement is monitoring.
void	setArray(int p0, java.sql.Array p1) Wraps the call to setArray
void	setAsciiStream(int p0, java.io.InputStream p1, int p2) Wraps the call to setAsciiStream
void	setBigDecimal(int p0, java.math.BigDecimal p1) Wraps the call to setBigDecimal
void	setBinaryStream(int p0, java.io.InputStream p1, int p2) Wraps the call to setBinaryStream
void	setBlob(int p0, java.sql.Blob p1) Wraps the call to setBlob
void	setBoolean(int p0, boolean p1) Wraps the call to setBoolean
void	setByte(int p0, byte p1) Wraps the call to setByte
void	setBytes(int p0, byte[] p1) Wraps the call to setBytes
void	setCharacterStream(int p0, java.io.Reader p1, int p2) Wraps the call to setCharacterStream
void	setClob(int p0, java.sql.Clob p1) Wraps the call to setClob
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	setDouble(int p0, double p1) Wraps the call to setDouble
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	setInt(int p0, int p1) Wraps the call to setInt
void	setLong(int p0, long p1) Wraps the call to setLong
void	setMaxFieldSize(int p0) Wraps the call to setMaxFieldSize
void	setMaxRows(int p0) Wraps the call to setMaxRows
void	setMonitoredConnection(MonitoredConnection pMonitoredConnection)
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	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	setQueryTimeout(int p0) Wraps the call to setQueryTimeout
void	setRef(int p0, java.sql.Ref p1) Wraps the call to setRef
void	setShort(int p0, short p1) Wraps the call to setShort
void	setString(int p0, java.lang.String p1) Wraps the call to setString
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	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	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	setWrapped(java.sql.PreparedStatement pWrapped)

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

EXECUTE_PREPARED_QUERY

protected static final java.lang.String EXECUTE_PREPARED_QUERY

See Also:

Constant Field Values

EXECUTE_PREPARED_UPDATE

protected static final java.lang.String EXECUTE_PREPARED_UPDATE

See Also:

Constant Field Values

Constructor Detail

MonitoredPreparedStatement

public MonitoredPreparedStatement(java.sql.PreparedStatement pWrapped,
                                  ApplicationLogging pLog,
                                  ConnectionStats pStats,
                                  java.lang.String pId,
                                  java.lang.String pStatement)

Constructs a new wrapper java.sql.PreparedStatement wrapper

Parameters:

pWrapped - the instance being wrapped

MonitoredPreparedStatement

public MonitoredPreparedStatement(java.sql.PreparedStatement pWrapped,
                                  ApplicationLogging pLog,
                                  ConnectionStats pStats,
                                  java.lang.String pId)

Constructs a new wrapper java.sql.PreparedStatement wrapper

Parameters:

pWrapped - the instance being wrapped

Method Detail

getMonitoredConnection

public MonitoredConnection getMonitoredConnection()

setMonitoredConnection

public void setMonitoredConnection(MonitoredConnection pMonitoredConnection)

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

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

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

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

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

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

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

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

getWrapped

public java.sql.PreparedStatement getWrapped()

Returns the original statement that this MonitoredPreparedStatement is monitoring.

setWrapped

public void setWrapped(java.sql.PreparedStatement 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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

SQLException - if a database access error occurs

Since:

1.4

See Also:

ParameterMetaData