Class ConnectionWrapper
- All Implemented Interfaces:
ManagedResource,AutoCloseable,Connection,Wrapper
The contract with JDBC says that result sets must be closed before statements and statements must be closed before connections but java does not enforce this contract. It is quite possible to close a connection while statements and result sets are still open. While some database drivers handle this condition nicely, others will start failing in undefined ways when this happens.
This wrapper class is a solution to this problem. If the connection is only accessed through the wrapper then the wrapper will ensure that everything is closed in the correct order. It will also ensure that the various jdbc objects (connections, statements, result sets and metadata) cannot be used after they are closed.
This class was created for the JDBCResourceFactory but can be used
by itself.
- Version:
- $Revision: 1.4 $
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate Connectionprivate booleanprivate final Listprivate final Listprivate StringFields inherited from interface java.sql.Connection
TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidprivate voidCheck to see if the connection is still open.voidClears all warnings reported for thisConnectionobject.voidclose()Releases a Connection's database and JDBC resources immediately instead of waiting for them to be automatically released.voidClose any open DatabaseMetaData objectsvoidClose any open statementsvoidcommit()Makes all changes made since the previous commit/rollback permanent and releases any database locks currently held by the Connection.createArrayOf(String typeName, Object[] elements) Creates aStatementobject for sending SQL statements to the database.createStatement(int resultSetType, int resultSetConcurrency) Creates aStatementobject that will generateResultSetobjects with the given type and concurrency.createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) Creates aStatementobject that will generateResultSetobjects with the given type, concurrency, and holdability.createStruct(String typeName, Object[] attributes) booleanGets the current auto-commit state.Returns the Connection's current catalog name.getClientInfo(String name) final ConnectionReturn the wrapped connectionintRetrieves the current holdability ofResultSetobjects created using thisConnectionobject.Gets the metadata regarding this connection's database.intintReturn the number of statements that are currently open.final StringReturn the name of the factory that allocated this connectionintGets this Connection's current transaction isolation level.Gets the type map object associated with this connection.Returns the first warning reported by calls on this Connection.booleanisClosed()Tests to see if a Connection is closed.booleanTests to see if the connection is in read-only mode.booleanisValid(int timeout) booleanisWrapperFor(Class<?> iface) Converts the given SQL statement into the system's native SQL grammar.prepareCall(String sql) Creates aCallableStatementobject for calling database stored procedures.prepareCall(String sql, int resultSetType, int resultSetConcurrency) Creates aCallableStatementobject that will generateResultSetobjects with the given type and concurrency.prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) Creates aCallableStatementobject that will generateResultSetobjects with the given type and concurrency.prepareStatement(String sql) Creates aPreparedStatementobject for sending parameterized SQL statements to the database.prepareStatement(String sql, int autoGeneratedKeys) Creates a defaultPreparedStatementobject that has the capability to retrieve auto-generated keys.prepareStatement(String sql, int[] columnIndexes) Creates a defaultPreparedStatementobject capable of returning the auto-generated keys designated by the given array.prepareStatement(String sql, int resultSetType, int resultSetConcurrency) Creates aPreparedStatementobject that will generateResultSetobjects with the given type and concurrency.prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) Creates aPreparedStatementobject that will generateResultSetobjects with the given type, concurrency, and holdability.prepareStatement(String sql, String[] columnNames) Creates a defaultPreparedStatementobject capable of returning the auto-generated keys designated by the given array.voidreleaseSavepoint(Savepoint savepoint) Removes the givenSavepointobject from the current transaction.voidrollback()Drops all changes made since the previous commit/rollback and releases any database locks currently held by this Connection.voidUndoes all changes made after the givenSavepointobject was set.voidsetAutoCommit(boolean autoCommit) Sets this connection's auto-commit mode.voidsetCatalog(String catalog) Sets a catalog name in order to select a subspace of this Connection's database in which to work.voidsetClientInfo(String name, String value) voidsetClientInfo(Properties properties) voidsetHoldability(int holdability) Changes the holdability ofResultSetobjects created using thisConnectionobject to the given holdability.voidsetNetworkTimeout(Executor executor, int timeout) voidsetReadOnly(boolean readOnly) Puts this connection in read-only mode as a hint to enable database optimizations.final voidsetResourceFactoryName(String name) Set the name of the factory that allocated this connectionCreates an unnamed savepoint in the current transaction and returns the newSavepointobject that represents it.setSavepoint(String name) Creates a savepoint with the given name in the current transaction and returns the newSavepointobject that represents it.voidvoidsetTransactionIsolation(int level) Attempts to change the transaction isolation level to the one given.voidsetTypeMap(Map map) Installs the given type map as the type map for this connection.<T> TMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface java.sql.Connection
beginRequest, endRequest, setShardingKey, setShardingKey, setShardingKeyIfValid, setShardingKeyIfValid
-
Field Details
-
delegate_
-
isOpen_
private boolean isOpen_ -
resourceFactoryName_
-
openStatements_
-
openDatabaseMetaData_
-
-
Constructor Details
-
ConnectionWrapper
Create a new connection wrapper- Parameters:
connection- The connection that we are wrapping
-
-
Method Details
-
setResourceFactoryName
Set the name of the factory that allocated this connection- Specified by:
setResourceFactoryNamein interfaceManagedResource- Parameters:
name- The name of the factory
-
setAutoCommit
Sets this connection's auto-commit mode. If a connection is in auto-commit mode, then all its SQL statements will be executed and committed as individual transactions. Otherwise, its SQL statements are grouped into transactions that are terminated by a call to either the methodcommitor the methodrollback. By default, new connections are in auto-commit mode.The commit occurs when the statement completes or the next execute occurs, whichever comes first. In the case of statements returning a ResultSet, the statement completes when the last row of the ResultSet has been retrieved or the ResultSet has been closed. In advanced cases, a single statement may return multiple results as well as output parameter values. In these cases the commit occurs when all results and output parameter values have been retrieved.
- Specified by:
setAutoCommitin interfaceConnection- Parameters:
autoCommit- true enables auto-commit; false disables auto-commit.- Throws:
SQLException- if a database access error occurs
-
setReadOnly
Puts this connection in read-only mode as a hint to enable database optimizations.Note: This method cannot be called while in the middle of a transaction.
- Specified by:
setReadOnlyin interfaceConnection- Parameters:
readOnly- true enables read-only mode; false disables read-only mode.- Throws:
SQLException- if a database access error occurs
-
setCatalog
Sets a catalog name in order to select a subspace of this Connection's database in which to work. If the driver does not support catalogs, it will silently ignore this request.- Specified by:
setCatalogin interfaceConnection- Parameters:
catalog- The catalog name- Throws:
SQLException- if a database access error occurs
-
setTransactionIsolation
Attempts to change the transaction isolation level to the one given. The constants defined in the interfaceConnectionare the possible transaction isolation levels.Note: This method cannot be called while in the middle of a transaction.
- Specified by:
setTransactionIsolationin interfaceConnection- Parameters:
level- one of the TRANSACTION_* isolation values with the exception of TRANSACTION_NONE; some databases may not support other values- Throws:
SQLException- if a database access error occurs
-
setTypeMap
Installs the given type map as the type map for this connection. The type map will be used for the custom mapping of SQL structured types and distinct types.- Specified by:
setTypeMapin interfaceConnection- Parameters:
map- thejava.util.Mapobject to install as the replacement for thisConnectionobject's default type map- Throws:
SQLException- If a sql error occurs- Since:
- 1.2
-
getResourceFactoryName
Return the name of the factory that allocated this connection- Specified by:
getResourceFactoryNamein interfaceManagedResource- Returns:
- The name of the factory
-
getDelegate
Return the wrapped connection- Returns:
- The wrapped connection
-
getAutoCommit
Gets the current auto-commit state.- Specified by:
getAutoCommitin interfaceConnection- Returns:
- the current state of auto-commit mode
- Throws:
SQLException- if a database access error occurs- See Also:
-
isClosed
Tests to see if a Connection is closed.- Specified by:
isClosedin interfaceConnection- Returns:
- true if the connection is closed; false if it's still open
- Throws:
SQLException- if a database access error occurs
-
getMetaData
Gets the metadata regarding this connection's database. A Connection's database is able to provide information describing its tables, its supported SQL grammar, its stored procedures, the capabilities of this connection, and so on. This information is made available through a DatabaseMetaData object.- Specified by:
getMetaDatain interfaceConnection- Returns:
- a DatabaseMetaData object for this Connection
- Throws:
SQLException- if a database access error occurs
-
isReadOnly
Tests to see if the connection is in read-only mode.- Specified by:
isReadOnlyin interfaceConnection- Returns:
- true if connection is read-only and false otherwise
- Throws:
SQLException- if a database access error occurs
-
getCatalog
Returns the Connection's current catalog name.- Specified by:
getCatalogin interfaceConnection- Returns:
- the current catalog name or null
- Throws:
SQLException- if a database access error occurs
-
getTransactionIsolation
Gets this Connection's current transaction isolation level.- Specified by:
getTransactionIsolationin interfaceConnection- Returns:
- the current TRANSACTION_* mode value
- Throws:
SQLException- if a database access error occurs
-
getWarnings
Returns the first warning reported by calls on this Connection.Note: Subsequent warnings will be chained to this SQLWarning.
- Specified by:
getWarningsin interfaceConnection- Returns:
- the first SQLWarning or null
- Throws:
SQLException- if a database access error occurs
-
getTypeMap
Gets the type map object associated with this connection. Unless the application has added an entry to the type map, the map returned will be empty.- Specified by:
getTypeMapin interfaceConnection- Returns:
- the
java.util.Mapobject associated with thisConnectionobject - Throws:
SQLException- If a sql error occurs- Since:
- 1.2
-
createStatement
Creates aStatementobject for sending SQL statements to the database. SQL statements without parameters are normally executed using Statement objects. If the same SQL statement is executed many times, it is more efficient to use aPreparedStatementobject.Result sets created using the returned
Statementobject will by default have forward-only type and read-only concurrency.- Specified by:
createStatementin interfaceConnection- Returns:
- a new Statement object
- Throws:
SQLException- if a database access error occurs
-
prepareStatement
Creates aPreparedStatementobject for sending parameterized SQL statements to the database. A SQL statement with or without IN parameters can be pre-compiled and stored in a PreparedStatement object. This object can then be used to efficiently execute this statement multiple times.Note: This method is optimized for handling parametric SQL statements that benefit from precompilation. If the driver supports precompilation, the method
prepareStatementwill send the statement to the database for precompilation. Some drivers may not support precompilation. In this case, the statement may not be sent to the database until thePreparedStatementis executed. This has no direct effect on users; however, it does affect which method throws certain SQLExceptions.Result sets created using the returned PreparedStatement will have forward-only type and read-only concurrency, by default.
- Specified by:
prepareStatementin interfaceConnection- Parameters:
sql- a SQL statement that may contain one or more '?' IN parameter placeholders- Returns:
- a new PreparedStatement object containing the pre-compiled statement
- Throws:
SQLException- if a database access error occurs
-
prepareCall
Creates aCallableStatementobject for calling database stored procedures. TheCallableStatementobject provides methods for setting up its IN and OUT parameters, and methods for executing the call to a stored procedure.Note: This method is optimized for handling stored procedure call statements. Some drivers may send the call statement to the database when the method
prepareCallis done; others may wait until theCallableStatementobject is executed. This has no direct effect on users; however, it does affect which method throws certain SQLExceptions. Result sets created using the returned CallableStatement will have forward-only type and read-only concurrency, by default.- Specified by:
prepareCallin interfaceConnection- Parameters:
sql- a SQL statement that may contain one or more '?' parameter placeholders. Typically this statement is a JDBC function call escape string.- Returns:
- a new CallableStatement object containing the pre-compiled SQL statement
- Throws:
SQLException- if a database access error occurs
-
nativeSQL
Converts the given SQL statement into the system's native SQL grammar. A driver may convert the JDBC sql grammar into its system's native SQL grammar prior to sending it; this method returns the native form of the statement that the driver would have sent.- Specified by:
nativeSQLin interfaceConnection- Parameters:
sql- a SQL statement that may contain one or more '?' parameter placeholders- Returns:
- the native form of this statement
- Throws:
SQLException- if a database access error occurs
-
commit
Makes all changes made since the previous commit/rollback permanent and releases any database locks currently held by the Connection. This method should be used only when auto-commit mode has been disabled.- Specified by:
commitin interfaceConnection- Throws:
SQLException- if a database access error occurs- See Also:
-
rollback
Drops all changes made since the previous commit/rollback and releases any database locks currently held by this Connection. This method should be used only when auto- commit has been disabled.- Specified by:
rollbackin interfaceConnection- Throws:
SQLException- if a database access error occurs- See Also:
-
close
Releases a Connection's database and JDBC resources immediately instead of waiting for them to be automatically released.Note: A Connection is automatically closed when it is garbage collected. Certain fatal errors also result in a closed Connection.
- Specified by:
closein interfaceAutoCloseable- Specified by:
closein interfaceConnection- Throws:
SQLException- if a database access error occurs
-
closeAnyOpenStatements
Close any open statements- Throws:
SQLException- If an error occurs
-
closeAnyOpenMetaDatas
Close any open DatabaseMetaData objects- Throws:
SQLException- If an error occurs
-
clearWarnings
Clears all warnings reported for thisConnectionobject. After a call to this method, the methodgetWarningsreturns null until a new warning is reported for this Connection.- Specified by:
clearWarningsin interfaceConnection- Throws:
SQLException- if a database access error occurs
-
createStatement
Creates aStatementobject that will generateResultSetobjects with the given type and concurrency. This method is the same as thecreateStatementmethod above, but it allows the default result set type and result set concurrency type to be overridden.- Specified by:
createStatementin interfaceConnection- Parameters:
resultSetType- a result set type; see ResultSet.TYPE_XXXresultSetConcurrency- a concurrency type; see ResultSet.CONCUR_XXX- Returns:
- a new Statement object
- Throws:
SQLException- if a database access error occurs- Since:
- 1.2
-
prepareStatement
public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException Creates aPreparedStatementobject that will generateResultSetobjects with the given type and concurrency. This method is the same as theprepareStatementmethod above, but it allows the default result set type and result set concurrency type to be overridden.- Specified by:
prepareStatementin interfaceConnection- Parameters:
sql- a SQL statement that may contain one or more '?' parameter placeholders. Typically this statement is a JDBC function call escape string.resultSetType- a result set type; see ResultSet.TYPE_XXXresultSetConcurrency- a concurrency type; see ResultSet.CONCUR_XXX- Returns:
- a new PreparedStatement object containing the pre-compiled SQL statement
- Throws:
SQLException- if a database access error occurs- Since:
- 1.2
-
prepareCall
public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException Creates aCallableStatementobject that will generateResultSetobjects with the given type and concurrency. This method is the same as theprepareCallmethod above, but it allows the default result set type and result set concurrency type to be overridden.- Specified by:
prepareCallin interfaceConnection- Parameters:
sql- a SQL statement that may contain one or more '?' parameter placeholders. Typically this statement is a JDBC function call escape string.resultSetType- a result set type; see ResultSet.TYPE_XXXresultSetConcurrency- a concurrency type; see ResultSet.CONCUR_XXX- Returns:
- a new CallableStatement object containing the pre-compiled SQL statement
- Throws:
SQLException- if a database access error occurs- Since:
- 1.2
-
checkConnection
Check to see if the connection is still open. If not, throw an exception.- Throws:
SQLException
-
getOpenStatementCount
public int getOpenStatementCount()Return the number of statements that are currently open. Useful for debugging purposes.- Returns:
- The number of statements that are currently open.
-
setHoldability
Changes the holdability ofResultSetobjects created using thisConnectionobject to the given holdability.- Specified by:
setHoldabilityin interfaceConnection- Parameters:
holdability- aResultSetholdability constant; one ofResultSet.HOLD_CURSORS_OVER_COMMITorResultSet.CLOSE_CURSORS_AT_COMMIT- Throws:
SQLException- if a database access occurs, the given parameter is not aResultSetconstant indicating holdability, or the given holdability is not supported- Since:
- 1.4
- See Also:
-
getHoldability
Retrieves the current holdability ofResultSetobjects created using thisConnectionobject.- Specified by:
getHoldabilityin interfaceConnection- Returns:
- the holdability, one of
ResultSet.HOLD_CURSORS_OVER_COMMITorResultSet.CLOSE_CURSORS_AT_COMMIT - Throws:
SQLException- if a database access occurs- Since:
- 1.4
- See Also:
-
setSavepoint
Creates an unnamed savepoint in the current transaction and returns the newSavepointobject that represents it.- Specified by:
setSavepointin interfaceConnection- Returns:
- the new
Savepointobject - Throws:
SQLException- if a database access error occurs or thisConnectionobject is currently in auto-commit mode- Since:
- 1.4
- See Also:
-
setSavepoint
Creates a savepoint with the given name in the current transaction and returns the newSavepointobject that represents it.- Specified by:
setSavepointin interfaceConnection- Parameters:
name- aStringcontaining the name of the savepoint- Returns:
- the new
Savepointobject - Throws:
SQLException- if a database access error occurs or thisConnectionobject is currently in auto-commit mode- Since:
- 1.4
- See Also:
-
rollback
Undoes all changes made after the givenSavepointobject was set.This method should be used only when auto-commit has been disabled.
- Specified by:
rollbackin interfaceConnection- Parameters:
savepoint- theSavepointobject to roll back to- Throws:
SQLException- if a database access error occurs, theSavepointobject is no longer valid, or thisConnectionobject is currently in auto-commit mode- Since:
- 1.4
- See Also:
-
releaseSavepoint
Removes the givenSavepointobject from the current transaction. Any reference to the savepoint after it have been removed will cause anSQLExceptionto be thrown.- Specified by:
releaseSavepointin interfaceConnection- Parameters:
savepoint- theSavepointobject to be removed- Throws:
SQLException- if a database access error occurs or the givenSavepointobject is not a valid savepoint in the current transaction- Since:
- 1.4
-
createStatement
public Statement createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException Creates aStatementobject that will generateResultSetobjects with the given type, concurrency, and holdability. This method is the same as thecreateStatementmethod above, but it allows the default result set type, concurrency, and holdability to be overridden.- Specified by:
createStatementin interfaceConnection- Parameters:
resultSetType- one of the followingResultSetconstants:ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVE, orResultSet.TYPE_SCROLL_SENSITIVEresultSetConcurrency- one of the followingResultSetconstants:ResultSet.CONCUR_READ_ONLYorResultSet.CONCUR_UPDATABLEresultSetHoldability- one of the followingResultSetconstants:ResultSet.HOLD_CURSORS_OVER_COMMITorResultSet.CLOSE_CURSORS_AT_COMMIT- Returns:
- a new
Statementobject that will generateResultSetobjects with the given type, concurrency, and holdability - Throws:
SQLException- if a database access error occurs or the given parameters are notResultSetconstants indicating type, concurrency, and holdability- Since:
- 1.4
- See Also:
-
prepareStatement
public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException Creates aPreparedStatementobject that will generateResultSetobjects with the given type, concurrency, and holdability.This method is the same as the
prepareStatementmethod above, but it allows the default result set type, concurrency, and holdability to be overridden.- Specified by:
prepareStatementin interfaceConnection- Parameters:
sql- aStringobject that is the SQL statement to be sent to the database; may contain one or more ? IN parametersresultSetType- one of the followingResultSetconstants:ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVE, orResultSet.TYPE_SCROLL_SENSITIVEresultSetConcurrency- one of the followingResultSetconstants:ResultSet.CONCUR_READ_ONLYorResultSet.CONCUR_UPDATABLEresultSetHoldability- one of the followingResultSetconstants:ResultSet.HOLD_CURSORS_OVER_COMMITorResultSet.CLOSE_CURSORS_AT_COMMIT- Returns:
- a new
PreparedStatementobject, containing the pre-compiled SQL statement, that will generateResultSetobjects with the given type, concurrency, and holdability - Throws:
SQLException- if a database access error occurs or the given parameters are notResultSetconstants indicating type, concurrency, and holdability- Since:
- 1.4
- See Also:
-
prepareCall
public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException Creates aCallableStatementobject that will generateResultSetobjects with the given type and concurrency. This method is the same as theprepareCallmethod above, but it allows the default result set type, result set concurrency type and holdability to be overridden.- Specified by:
prepareCallin interfaceConnection- Parameters:
sql- aStringobject that is the SQL statement to be sent to the database; may contain on or more ? parametersresultSetType- one of the followingResultSetconstants:ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVE, orResultSet.TYPE_SCROLL_SENSITIVEresultSetConcurrency- one of the followingResultSetconstants:ResultSet.CONCUR_READ_ONLYorResultSet.CONCUR_UPDATABLEresultSetHoldability- one of the followingResultSetconstants:ResultSet.HOLD_CURSORS_OVER_COMMITorResultSet.CLOSE_CURSORS_AT_COMMIT- Returns:
- a new
CallableStatementobject, containing the pre-compiled SQL statement, that will generateResultSetobjects with the given type, concurrency, and holdability - Throws:
SQLException- if a database access error occurs or the given parameters are notResultSetconstants indicating type, concurrency, and holdability- Since:
- 1.4
- See Also:
-
prepareStatement
Creates a defaultPreparedStatementobject that has the capability to retrieve auto-generated keys. The given constant tells the driver whether it should make auto-generated keys available for retrieval. This parameter is ignored if the SQL statement is not anINSERTstatement.Note: This method is optimized for handling parametric SQL statements that benefit from precompilation. If the driver supports precompilation, the method
prepareStatementwill send the statement to the database for precompilation. Some drivers may not support precompilation. In this case, the statement may not be sent to the database until thePreparedStatementobject is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.Result sets created using the returned
PreparedStatementobject will by default be typeTYPE_FORWARD_ONLYand have a concurrency level ofCONCUR_READ_ONLY.- Specified by:
prepareStatementin interfaceConnection- Parameters:
sql- an SQL statement that may contain one or more '?' IN parameter placeholdersautoGeneratedKeys- a flag indicating whether auto-generated keys should be returned; one ofStatement.RETURN_GENERATED_KEYSorStatement.NO_GENERATED_KEYS- Returns:
- a new
PreparedStatementobject, containing the pre-compiled SQL statement, that will have the capability of returning auto-generated keys - Throws:
SQLException- if a database access error occurs or the given parameter is not aStatementconstant indicating whether auto-generated keys should be returned- Since:
- 1.4
-
prepareStatement
Creates a defaultPreparedStatementobject capable of returning the auto-generated keys designated by the given array. This array contains the indexes of the columns in the target table that contain the auto-generated keys that should be made available. This array is ignored if the SQL statement is not anINSERTstatement.An SQL statement with or without IN parameters can be pre-compiled and stored in a
PreparedStatementobject. This object can then be used to efficiently execute this statement multiple times.Note: This method is optimized for handling parametric SQL statements that benefit from precompilation. If the driver supports precompilation, the method
prepareStatementwill send the statement to the database for precompilation. Some drivers may not support precompilation. In this case, the statement may not be sent to the database until thePreparedStatementobject is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.Result sets created using the returned
PreparedStatementobject will by default be typeTYPE_FORWARD_ONLYand have a concurrency level ofCONCUR_READ_ONLY.- Specified by:
prepareStatementin interfaceConnection- Parameters:
sql- an SQL statement that may contain one or more '?' IN parameter placeholderscolumnIndexes- an array of column indexes indicating the columns that should be returned from the inserted row or rows- Returns:
- a new
PreparedStatementobject, containing the pre-compiled statement, that is capable of returning the auto-generated keys designated by the given array of column indexes - Throws:
SQLException- if a database access error occurs- Since:
- 1.4
-
prepareStatement
Creates a defaultPreparedStatementobject capable of returning the auto-generated keys designated by the given array. This array contains the names of the columns in the target table that contain the auto-generated keys that should be returned. This array is ignored if the SQL statement is not anINSERTstatement.An SQL statement with or without IN parameters can be pre-compiled and stored in a
PreparedStatementobject. This object can then be used to efficiently execute this statement multiple times.Note: This method is optimized for handling parametric SQL statements that benefit from precompilation. If the driver supports precompilation, the method
prepareStatementwill send the statement to the database for precompilation. Some drivers may not support precompilation. In this case, the statement may not be sent to the database until thePreparedStatementobject is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.Result sets created using the returned
PreparedStatementobject will by default be typeTYPE_FORWARD_ONLYand have a concurrency level ofCONCUR_READ_ONLY.- Specified by:
prepareStatementin interfaceConnection- Parameters:
sql- an SQL statement that may contain one or more '?' IN parameter placeholderscolumnNames- an array of column names indicating the columns that should be returned from the inserted row or rows- Returns:
- a new
PreparedStatementobject, containing the pre-compiled statement, that is capable of returning the auto-generated keys designated by the given array of column names - Throws:
SQLException- if a database access error occurs- Since:
- 1.4
-
getNetworkTimeout
- Specified by:
getNetworkTimeoutin interfaceConnection- Throws:
SQLException
-
setNetworkTimeout
- Specified by:
setNetworkTimeoutin interfaceConnection- Throws:
SQLException
-
abort
- Specified by:
abortin interfaceConnection- Throws:
SQLException
-
getSchema
- Specified by:
getSchemain interfaceConnection- Throws:
SQLException
-
setSchema
- Specified by:
setSchemain interfaceConnection- Throws:
SQLException
-
createStruct
- Specified by:
createStructin interfaceConnection- Throws:
SQLException
-
createArrayOf
- Specified by:
createArrayOfin interfaceConnection- Throws:
SQLException
-
getClientInfo
- Specified by:
getClientInfoin interfaceConnection- Throws:
SQLException
-
getClientInfo
- Specified by:
getClientInfoin interfaceConnection- Throws:
SQLException
-
setClientInfo
- Specified by:
setClientInfoin interfaceConnection- Throws:
SQLClientInfoException
-
setClientInfo
- Specified by:
setClientInfoin interfaceConnection- Throws:
SQLClientInfoException
-
isValid
- Specified by:
isValidin interfaceConnection- Throws:
SQLException
-
createSQLXML
- Specified by:
createSQLXMLin interfaceConnection- Throws:
SQLException
-
createNClob
- Specified by:
createNClobin interfaceConnection- Throws:
SQLException
-
createBlob
- Specified by:
createBlobin interfaceConnection- Throws:
SQLException
-
createClob
- Specified by:
createClobin interfaceConnection- Throws:
SQLException
-
isWrapperFor
- Specified by:
isWrapperForin interfaceWrapper- Throws:
SQLException
-
unwrap
- Specified by:
unwrapin interfaceWrapper- Throws:
SQLException
-