Quadcap Embeddable Database

com.quadcap.jdbc.Connection Class Reference

Inheritance diagram for com.quadcap.jdbc.Connection:

List of all members.

Detailed Description

Author:
Stan Bailes

Definition at line 69 of file Connection.java.

Public Member Functions

 Connection (Database db, String auth, String passwd) throws SQLException
 Construct a new connection object for the specified database and userid.

Database getDatabase ()
 Return the database to which this connection is bound.

final com.quadcap.sql.Connection getConnection ()
 Return the connection's session.

void clearWarnings ()
 Clears all warnings that have been reported on calls to this connection.

void close () throws SQLException
 Close this connection, which implicitly ends (i.e., commits) any pending transactions for this connection, closes any ResultSets opened on this connection, and marks the connection as closed.

void finalize () throws Throwable
 Make sure the connection closes on gc...

void commit () throws SQLException
 Commit any pending changes for the current transaction.

java.sql.Statement createStatement () throws SQLException
 Return a new Statement object that can be used to execute SQL statements on this connection.

boolean getAutoCommit () throws SQLException
 Return the current value for the autoCommit variable.

String getCatalog ()
 QED doesn't support catalogs, so this function returns null.

java.sql.DatabaseMetaData getMetaData () throws SQLException
int getTransactionIsolation ()
 Return the current transaction isolation level -- QED currently only supports TRANSACTION_SERIALIZABLE.

SQLWarning getWarnings ()
 QED doesn't generate any SQLWarnings, so this function always returns null.

boolean isClosed ()
 Return true if this connection has been closed.

boolean isReadOnly ()
 Return true if this connection is read only.

String nativeSQL (String stmt)
 This function is supposed to translate the specified query into the native query language of the underlying DBMS.

CallableStatement prepareCall (String sql) throws SQLException
 QED doesn't support stored procedures, so this method returns a "not implemented" exception.

CallableStatement prepareCall (String sql, int resultType, int resultSetConcurrency) throws SQLException
 QED doesn't support stored procedures, so this method returns a "not implemented" exception.

java.sql.PreparedStatement prepareStatement (String sql) throws SQLException
 Returns a new PreparedStatement statement, which is a pre-compiled representation of the statement sql, with place holders for parameters specified using the '?' character.

java.sql.PreparedStatement prepareStatement (String sql, int resultType, int resultSetConcurrency) throws SQLException
 Returns a new PreparedStatement statement, which is a pre-compiled representation of the statement sql, with place holders for parameters specified using the '?' character.

void rollback () throws SQLException
 Roll back any pending changes for the current transaction.

void setAutoCommit (boolean autoCommit) throws SQLException
 Set the state of the autoCommit flag.

void setCatalog (String catalog) throws SQLException
 QED doesn't support catalogs, so this function throws a "not implemented" exception.

void setReadOnly (boolean readOnly) throws SQLException
 QED doesn't support read-only connections, so this function will throw a "not implemented" exception if it is called with readOnly == true.

void setTransactionIsolation (int trans) throws SQLException
 QED only supports the TRANSACTION_SERIALIZABLE isolation level, so this function will throw a "not implemented" exception if it is called with any other value.

void setTypeMap (Map map) throws SQLException
 Set the type map to be used for custom type mapping of UDTS.

Map getTypeMap () throws SQLException
 Return the current type map to be used for custom type mapping of UDTS.

java.sql.Statement createStatement (int resultType, int resultSetConcurrency) throws SQLException
 Return a new Statement object that can be used to execute SQL statements on this connection.

void setHoldability (int holdability) throws SQLException
 Changes the holdability of ResultSet objects created using this Connection object to the given holdability.

int getHoldability () throws SQLException
 Retrieves the current holdability of ResultSet objects created using this Connection object.

Savepoint setSavepoint () throws SQLException
 Creates an unnamed savepoint in the current transaction and returns the new Savepoint object that represents it.

Savepoint setSavepoint (String name) throws SQLException
 Creates a savepoint with the given name in the current transaction and returns the new Savepoint object that represents it.

void rollback (Savepoint savepoint) throws SQLException
 Undoes all changes made after the given Savepoint object was set.

void releaseSavepoint (Savepoint savepoint) throws SQLException
 Removes the given Savepoint object from the current transaction.

java.sql.Statement createStatement (int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
 Creates a Statement object that will generate ResultSet objects with the given type, concurrency, and holdability.

java.sql.PreparedStatement prepareStatement (String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
 Creates a PreparedStatement object that will generate ResultSet objects with the given type, concurrency, and holdability.

CallableStatement prepareCall (String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
 Creates a CallableStatement object that will generate ResultSet objects with the given type and concurrency.

java.sql.PreparedStatement prepareStatement (String sql, int autoGeneratedKeys) throws SQLException
 Creates a default PreparedStatement object that has the capability to retrieve auto-generated keys.

java.sql.PreparedStatement prepareStatement (String sql, int columnIndexes[]) throws SQLException
 Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array.

java.sql.PreparedStatement prepareStatement (String sql, String columnNames[]) throws SQLException
 Creates a default PreparedStatement object capable of returning the auto-generated keys designated by the given array.


Package Attributes

Database db
com.quadcap.sql.Connection qConn = null
boolean closed = false
Map typeMap = null
DatabaseMetaData dbm = null
 Return a DatabaseMetaData object that can be used to get information about the features supported by QED.


Static Package Attributes

final ConfigNumber trace

Constructor & Destructor Documentation

com.quadcap.jdbc.Connection.Connection (  Database  db,
String  auth,
String  passwd
)  throws SQLException
 

Construct a new connection object for the specified database and userid.

Deprecated:
Pay no attention to that man behind the curtains.
Parameters:
db the database
auth the userid
passwd the password

Definition at line 102 of file Connection.java.

References com.quadcap.jdbc.Connection.db, com.quadcap.jdbc.Connection.qConn, and com.quadcap.jdbc.Connection.trace.

Member Function Documentation

void com.quadcap.jdbc.Connection.clearWarnings (   ) 
 

Clears all warnings that have been reported on calls to this connection.

QED doesn't currently throw any SQLWarnings, so this operation does nothing.

Definition at line 145 of file Connection.java.

void com.quadcap.jdbc.Connection.close (   )  throws SQLException
 

Close this connection, which implicitly ends (i.e., commits) any pending transactions for this connection, closes any ResultSets opened on this connection, and marks the connection as closed.

It is an error to attempt to use this connection after the close operation

Exceptions:
SQLException may be thrown

Definition at line 157 of file Connection.java.

References com.quadcap.jdbc.Connection.closed, com.quadcap.jdbc.Connection.qConn, and com.quadcap.jdbc.Connection.trace.

Referenced by com.quadcap.jdbc.Connection.finalize().

void com.quadcap.jdbc.Connection.commit (   )  throws SQLException
 

Commit any pending changes for the current transaction.

This ends the transaction; any further statements executed by this connection will cause a new transaction to be started. This method closes any ResultSets opened on this connection.

Exceptions:
SQLException may be thrown

Definition at line 193 of file Connection.java.

References com.quadcap.jdbc.Connection.closed, com.quadcap.jdbc.Connection.qConn, and com.quadcap.jdbc.Connection.trace.

java.sql.Statement com.quadcap.jdbc.Connection.createStatement (  int  resultSetType,
int  resultSetConcurrency,
int  resultSetHoldability
)  throws SQLException
 

Creates a Statement object that will generate ResultSet objects with the given type, concurrency, and holdability.

This method is the same as the createStatement method above, but it allows the default result set type, concurrency, and holdability to be overridden.

Parameters:
resultSetType one of the following ResultSet constants: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE
resultSetConcurrency one of the following ResultSet constants: ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
resultSetHoldability one of the following ResultSet constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
Returns:
a new Statement object that will generate ResultSet objects with the given type, concurrency, and holdability
Exceptions:
SQLException if a database access error occurs or the given parameters are not ResultSet constants indicating type, concurrency, and holdability
See also:
ResultSet
Since:
1.4

Definition at line 676 of file Connection.java.

References com.quadcap.jdbc.Connection.createStatement().

java.sql.Statement com.quadcap.jdbc.Connection.createStatement (  int  resultType,
int  resultSetConcurrency
)  throws SQLException
 

Return a new Statement object that can be used to execute SQL statements on this connection.

Parameters:
resultType the desired ResultSet type
resultSetConcurrency the desired ResultSet concurrency
Returns:
a new Statement object
Exceptions:
SQLException may be thrown

Definition at line 514 of file Connection.java.

References com.quadcap.jdbc.Connection.closed.

java.sql.Statement com.quadcap.jdbc.Connection.createStatement (   )  throws SQLException
 

Return a new Statement object that can be used to execute SQL statements on this connection.

Returns:
a new Statement object
Exceptions:
SQLException may be thrown

Definition at line 214 of file Connection.java.

References com.quadcap.jdbc.Connection.closed.

Referenced by com.quadcap.jdbc.Connection.createStatement().

void com.quadcap.jdbc.Connection.finalize (   )  throws Throwable
 

Make sure the connection closes on gc...

Definition at line 176 of file Connection.java.

References com.quadcap.jdbc.Connection.close(), and com.quadcap.jdbc.Connection.closed.

boolean com.quadcap.jdbc.Connection.getAutoCommit (   )  throws SQLException
 

Return the current value for the autoCommit variable.

By default, connections are created with autoCommit equal to true

Returns:
the current autoCommit state

Definition at line 230 of file Connection.java.

References com.quadcap.jdbc.Connection.closed, and com.quadcap.jdbc.Connection.qConn.

String com.quadcap.jdbc.Connection.getCatalog (   ) 
 

QED doesn't support catalogs, so this function returns null.

Returns:
null

Definition at line 241 of file Connection.java.

final com.quadcap.sql.Connection com.quadcap.jdbc.Connection.getConnection (   ) 
 

Return the connection's session.

Deprecated:
Pay no attention to that man behind the curtains.
Returns:
the connection's session

Definition at line 132 of file Connection.java.

References com.quadcap.jdbc.Connection.qConn.

Referenced by com.quadcap.jdbc.DatabaseMetaData.DatabaseMetaData(), and com.quadcap.jdbc.Statement.Statement().

Database com.quadcap.jdbc.Connection.getDatabase (   ) 
 

Return the database to which this connection is bound.

Deprecated:
Pay no attention to that man behind the curtains.
Returns:
the connection's database

Definition at line 122 of file Connection.java.

References com.quadcap.jdbc.Connection.db.

Referenced by com.quadcap.jdbc.DatabaseMetaData.DatabaseMetaData().

int com.quadcap.jdbc.Connection.getHoldability (   )  throws SQLException
 

Retrieves the current holdability of ResultSet objects created using this Connection object.

QED: ResultSets are always closed on commit.

Returns:
the holdability, one of ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
Exceptions:
SQLException if a database access occurs
See also:
setHoldability

ResultSet

Since:
1.4

Definition at line 569 of file Connection.java.

java.sql.DatabaseMetaData com.quadcap.jdbc.Connection.getMetaData (   )  throws SQLException
 

Definition at line 252 of file Connection.java.

References com.quadcap.jdbc.Connection.dbm.

int com.quadcap.jdbc.Connection.getTransactionIsolation (   ) 
 

Return the current transaction isolation level -- QED currently only supports TRANSACTION_SERIALIZABLE.

Returns:
TRANSACTION_SERIALIZABLE

Definition at line 269 of file Connection.java.

Map com.quadcap.jdbc.Connection.getTypeMap (   )  throws SQLException
 

Return the current type map to be used for custom type mapping of UDTS.

In this release of QED, this call will succeed, but type mapping is not fully implemented in this release.

Returns:
the curren type map

Definition at line 500 of file Connection.java.

References com.quadcap.jdbc.Connection.typeMap.

SQLWarning com.quadcap.jdbc.Connection.getWarnings (   ) 
 

QED doesn't generate any SQLWarnings, so this function always returns null.

Returns:
null

Definition at line 279 of file Connection.java.

boolean com.quadcap.jdbc.Connection.isClosed (   ) 
 

Return true if this connection has been closed.

Returns:
true if this connection has been closed.

Definition at line 288 of file Connection.java.

References com.quadcap.jdbc.Connection.closed.

boolean com.quadcap.jdbc.Connection.isReadOnly (   ) 
 

Return true if this connection is read only.

QED doesn't currently support read-only connections, so this always returns false

Returns:
false

Definition at line 299 of file Connection.java.

String com.quadcap.jdbc.Connection.nativeSQL (  String  stmt  ) 
 

This function is supposed to translate the specified query into the native query language of the underlying DBMS.

In QED, the native query language is SQL-92, and JDBC escapes are directly supported by the DBMS, so this translation is a no-op, and always returns the original string

Parameters:
stmt an SQL statement
Returns:
the same SQL statement

Definition at line 313 of file Connection.java.

References com.quadcap.jdbc.Connection.nativeSQL().

Referenced by com.quadcap.jdbc.Connection.nativeSQL().

CallableStatement com.quadcap.jdbc.Connection.prepareCall (  String  sql,
int  resultSetType,
int  resultSetConcurrency,
int  resultSetHoldability
)  throws SQLException
 

Creates a CallableStatement object that will generate ResultSet objects with the given type and concurrency.

This method is the same as the prepareCall method above, but it allows the default result set type, result set concurrency type and holdability to be overridden.

Parameters:
sql a String object that is the SQL statement to be sent to the database; may contain on or more ? parameters
resultSetType one of the following ResultSet constants: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE
resultSetConcurrency one of the following ResultSet constants: ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
resultSetHoldability one of the following ResultSet constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
Returns:
a new CallableStatement object, containing the pre-compiled SQL statement, that will generate ResultSet objects with the given type, concurrency, and holdability
Exceptions:
SQLException if a database access error occurs or the given parameters are not ResultSet constants indicating type, concurrency, and holdability
See also:
ResultSet
Since:
1.4

Definition at line 762 of file Connection.java.

CallableStatement com.quadcap.jdbc.Connection.prepareCall (  String  sql,
int  resultType,
int  resultSetConcurrency
)  throws SQLException
 

QED doesn't support stored procedures, so this method returns a "not implemented" exception.

Parameters:
sql the SQL statement
resultType the desired ResultSet type
resultSetConcurrency the desired ResultSet concurrency
Returns:
never
Exceptions:
SQLException "not implemented"

Definition at line 340 of file Connection.java.

CallableStatement com.quadcap.jdbc.Connection.prepareCall (  String  sql  )  throws SQLException
 

QED doesn't support stored procedures, so this method returns a "not implemented" exception.

Parameters:
sql the SQL statement
Returns:
never
Exceptions:
SQLException "not implemented"

Definition at line 325 of file Connection.java.

References com.quadcap.jdbc.Connection.prepareCall().

Referenced by com.quadcap.jdbc.Connection.prepareCall().

java.sql.PreparedStatement com.quadcap.jdbc.Connection.prepareStatement (  String  sql,
String  columnNames[]
)  throws SQLException
 

Creates a default PreparedStatement object 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 an INSERT statement.

An 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 prepareStatement will 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 the PreparedStatement object is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.

Result sets created using the returned PreparedStatement object will by default be type TYPE_FORWARD_ONLY and have a concurrency level of CONCUR_READ_ONLY.

Parameters:
sql an SQL statement that may contain one or more '?' IN parameter placeholders
columnNames an array of column names indicating the columns that should be returned from the inserted row or rows
Returns:
a new PreparedStatement object, containing the pre-compiled statement, that is capable of returning the auto-generated keys designated by the given array of column names
Exceptions:
SQLException if a database access error occurs
Since:
1.4

Definition at line 908 of file Connection.java.

References com.quadcap.jdbc.Connection.prepareStatement().

java.sql.PreparedStatement com.quadcap.jdbc.Connection.prepareStatement (  String  sql,
int  columnIndexes[]
)  throws SQLException
 

Creates a default PreparedStatement object 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 an INSERT statement.

An 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 prepareStatement will 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 the PreparedStatement object is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.

Result sets created using the returned PreparedStatement object will by default be type TYPE_FORWARD_ONLY and have a concurrency level of CONCUR_READ_ONLY.

Parameters:
sql an SQL statement that may contain one or more '?' IN parameter placeholders
columnIndexes an array of column indexes indicating the columns that should be returned from the inserted row or rows
Returns:
a new PreparedStatement object, containing the pre-compiled statement, that is capable of returning the auto-generated keys designated by the given array of column indexes
Exceptions:
SQLException if a database access error occurs
Since:
1.4

Definition at line 861 of file Connection.java.

References com.quadcap.jdbc.Connection.prepareStatement().

java.sql.PreparedStatement com.quadcap.jdbc.Connection.prepareStatement (  String  sql,
int  autoGeneratedKeys
)  throws SQLException
 

Creates a default PreparedStatement object 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 an INSERT statement.

Note: This method is optimized for handling parametric SQL statements that benefit from precompilation. If the driver supports precompilation, the method prepareStatement will 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 the PreparedStatement object is executed. This has no direct effect on users; however, it does affect which methods throw certain SQLExceptions.

Result sets created using the returned PreparedStatement object will by default be type TYPE_FORWARD_ONLY and have a concurrency level of CONCUR_READ_ONLY.

Parameters:
sql an SQL statement that may contain one or more '?' IN parameter placeholders
autoGeneratedKeys a flag indicating whether auto-generated keys should be returned; one of the following Statement constants:
autoGeneratedKeys a flag indicating that auto-generated keys should be returned, one of Statement.RETURN_GENERATED_KEYS or Statement.NO_GENERATED_KEYS.
Returns:
a new PreparedStatement object, containing the pre-compiled SQL statement, that will have the capability of returning auto-generated keys
Exceptions:
SQLException if a database access error occurs or the given parameter is not a Statement constant indicating whether auto-generated keys should be returned
Since:
1.4

Definition at line 811 of file Connection.java.

References com.quadcap.jdbc.Connection.prepareStatement().

java.sql.PreparedStatement com.quadcap.jdbc.Connection.prepareStatement (  String  sql,
int  resultSetType,
int  resultSetConcurrency,
int  resultSetHoldability
)  throws SQLException
 

Creates a PreparedStatement object that will generate ResultSet objects with the given type, concurrency, and holdability.

This method is the same as the prepareStatement method above, but it allows the default result set type, concurrency, and holdability to be overridden.

Parameters:
sql a String object that is the SQL statement to be sent to the database; may contain one or more ? IN parameters
resultSetType one of the following ResultSet constants: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE
resultSetConcurrency one of the following ResultSet constants: ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
resultSetHoldability one of the following ResultSet constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
Returns:
a new PreparedStatement object, containing the pre-compiled SQL statement, that will generate ResultSet objects with the given type, concurrency, and holdability
Exceptions:
SQLException if a database access error occurs or the given parameters are not ResultSet constants indicating type, concurrency, and holdability
See also:
ResultSet
Since:
1.4

Definition at line 721 of file Connection.java.

References com.quadcap.jdbc.Connection.prepareStatement().

java.sql.PreparedStatement com.quadcap.jdbc.Connection.prepareStatement (  String  sql,
int  resultType,
int  resultSetConcurrency
)  throws SQLException
 

Returns a new PreparedStatement statement, which is a pre-compiled representation of the statement sql, with place holders for parameters specified using the '?' character.

Parameters:
sql the SQL statement
resultType the desired ResultSet type
resultSetConcurrency the desired ResultSet concurrency
Returns:
the PreparedStatement statement that can be used to invoke the SQL statement, after the parameters represented by the '?' characters are supplied
Exceptions:
SQLException may be thrown

Definition at line 387 of file Connection.java.

References com.quadcap.jdbc.Connection.closed, and com.quadcap.jdbc.Connection.prepareStatement().

java.sql.PreparedStatement com.quadcap.jdbc.Connection.prepareStatement (  String  sql  )  throws SQLException
 

Returns a new PreparedStatement statement, which is a pre-compiled representation of the statement sql, with place holders for parameters specified using the '?' character.

Parameters:
sql the SQL statement
Returns:
the PreparedStatement statement that can be used to invoke the SQL statement, after the parameters represented by the '?' characters are supplied
Exceptions:
SQLException may be thrown

Definition at line 360 of file Connection.java.

References com.quadcap.jdbc.Connection.closed, and com.quadcap.jdbc.Connection.prepareStatement().

Referenced by com.quadcap.jdbc.Connection.prepareStatement().

void com.quadcap.jdbc.Connection.releaseSavepoint (  Savepoint  savepoint  )  throws SQLException
 

Removes the given Savepoint object from the current transaction.

Any reference to the savepoint after it have been removed will cause an SQLException to be thrown.

QED: Savepoints not supported.

Parameters:
savepoint the Savepoint object to be removed
Exceptions:
SQLException if a database access error occurs or the given Savepoint object is not a valid savepoint in the current transaction
Since:
1.4

Definition at line 642 of file Connection.java.

References com.quadcap.jdbc.Connection.releaseSavepoint().

Referenced by com.quadcap.jdbc.Connection.releaseSavepoint().

void com.quadcap.jdbc.Connection.rollback (  Savepoint  savepoint  )  throws SQLException
 

Undoes all changes made after the given Savepoint object was set.

This method should be used only when auto-commit has been disabled.

QED: Savepoints not supported.

Parameters:
savepoint the Savepoint object to roll back to
Exceptions:
SQLException if a database access error occurs, the Savepoint object is no longer valid, or this Connection object is currently in auto-commit mode
See also:
Savepoint

rollback

Since:
1.4

Definition at line 625 of file Connection.java.

void com.quadcap.jdbc.Connection.rollback (   )  throws SQLException
 

Roll back any pending changes for the current transaction.

This ends the transaction; any further statements executed by this connection will cause a new transaction to be started. This method closes any ResultSets opened on this connection.

Exceptions:
SQLException may be thrown

Definition at line 409 of file Connection.java.

References com.quadcap.jdbc.Connection.closed, com.quadcap.jdbc.Connection.qConn, and com.quadcap.jdbc.Connection.trace.

void com.quadcap.jdbc.Connection.setAutoCommit (  boolean  autoCommit  )  throws SQLException
 

Set the state of the autoCommit flag.

Parameters:
autoCommit the new autoCommit state.

Definition at line 430 of file Connection.java.

References com.quadcap.jdbc.Connection.closed, com.quadcap.jdbc.Connection.qConn, com.quadcap.jdbc.Connection.setAutoCommit(), and com.quadcap.jdbc.Connection.trace.

Referenced by com.quadcap.jdbc.Connection.setAutoCommit().

void com.quadcap.jdbc.Connection.setCatalog (  String  catalog  )  throws SQLException
 

QED doesn't support catalogs, so this function throws a "not implemented" exception.

Exceptions:
SQLException "not implemented"

Definition at line 446 of file Connection.java.

References com.quadcap.jdbc.Connection.setCatalog().

Referenced by com.quadcap.jdbc.Connection.setCatalog().

void com.quadcap.jdbc.Connection.setHoldability (  int  holdability  )  throws SQLException
 

Changes the holdability of ResultSet objects created using this Connection object to the given holdability.

QED: ResultSets are always closed on commit.

Parameters:
holdability a ResultSet holdability constant; one of ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT
Exceptions:
SQLException if a database access occurs, the given parameter is not a ResultSet constant indicating holdability, or the given holdability is not supported
See also:
getHoldability

ResultSet

Since:
1.4

Definition at line 549 of file Connection.java.

References com.quadcap.jdbc.Connection.setHoldability().

Referenced by com.quadcap.jdbc.Connection.setHoldability().

void com.quadcap.jdbc.Connection.setReadOnly (  boolean  readOnly  )  throws SQLException
 

QED doesn't support read-only connections, so this function will throw a "not implemented" exception if it is called with readOnly == true.

Parameters:
readOnly had better be false
Exceptions:
SQLException if it's not

Definition at line 458 of file Connection.java.

References com.quadcap.jdbc.Connection.setReadOnly().

Referenced by com.quadcap.jdbc.Connection.setReadOnly().

Savepoint com.quadcap.jdbc.Connection.setSavepoint (  String  name  )  throws SQLException
 

Creates a savepoint with the given name in the current transaction and returns the new Savepoint object that represents it.

QED: Savepoints not supported.

Parameters:
name a String containing the name of the savepoint
Returns:
the new Savepoint object
Exceptions:
SQLException if a database access error occurs or this Connection object is currently in auto-commit mode
See also:
Savepoint
Since:
1.4

Definition at line 604 of file Connection.java.

Savepoint com.quadcap.jdbc.Connection.setSavepoint (   )  throws SQLException
 

Creates an unnamed savepoint in the current transaction and returns the new Savepoint object that represents it.

QED: Savepoints not supported.

Returns:
the new Savepoint object
Exceptions:
SQLException if a database access error occurs or this Connection object is currently in auto-commit mode
See also:
Savepoint
Since:
1.4

Definition at line 586 of file Connection.java.

void com.quadcap.jdbc.Connection.setTransactionIsolation (  int  trans  )  throws SQLException
 

QED only supports the TRANSACTION_SERIALIZABLE isolation level, so this function will throw a "not implemented" exception if it is called with any other value.

Parameters:
readOnly had better be TRANSACTION_SERIALIZABLE
Exceptions:
SQLException if it's not

Definition at line 473 of file Connection.java.

References com.quadcap.jdbc.Connection.setTransactionIsolation().

Referenced by com.quadcap.jdbc.Connection.setTransactionIsolation().

void com.quadcap.jdbc.Connection.setTypeMap (  Map  map  )  throws SQLException
 

Set the type map to be used for custom type mapping of UDTS.

In this release of QED, this call will succeed, but type mapping is not fully implemented in this release.

Parameters:
map the new map

Definition at line 489 of file Connection.java.

References com.quadcap.jdbc.Connection.setTypeMap().

Referenced by com.quadcap.jdbc.Connection.setTypeMap().

Member Data Documentation

boolean com.quadcap.jdbc.Connection.closed = false [package]
 

Definition at line 90 of file Connection.java.

Referenced by com.quadcap.jdbc.Connection.close(), com.quadcap.jdbc.Connection.commit(), com.quadcap.jdbc.Connection.createStatement(), com.quadcap.jdbc.Connection.finalize(), com.quadcap.jdbc.Connection.getAutoCommit(), com.quadcap.jdbc.Connection.isClosed(), com.quadcap.jdbc.Connection.prepareStatement(), com.quadcap.jdbc.Connection.rollback(), and com.quadcap.jdbc.Connection.setAutoCommit().

Database com.quadcap.jdbc.Connection.db [package]
 

Definition at line 88 of file Connection.java.

Referenced by com.quadcap.jdbc.Connection.Connection(), and com.quadcap.jdbc.Connection.getDatabase().

DatabaseMetaData com.quadcap.jdbc.Connection.dbm = null [package]
 

Return a DatabaseMetaData object that can be used to get information about the features supported by QED.

Returns:
a DatabaseMetaData

Definition at line 251 of file Connection.java.

Referenced by com.quadcap.jdbc.Connection.getMetaData().

com.quadcap.sql.Connection com.quadcap.jdbc.Connection.qConn = null [package]
 

Definition at line 89 of file Connection.java.

Referenced by com.quadcap.jdbc.Connection.close(), com.quadcap.jdbc.Connection.commit(), com.quadcap.jdbc.Connection.Connection(), com.quadcap.jdbc.DatabaseMetaData.DatabaseMetaData(), com.quadcap.jdbc.Connection.getAutoCommit(), com.quadcap.jdbc.Connection.getConnection(), com.quadcap.jdbc.Connection.rollback(), com.quadcap.jdbc.Connection.setAutoCommit(), and com.quadcap.jdbc.Statement.Statement().

final ConfigNumber com.quadcap.jdbc.Connection.trace [static, package]
 

Initial value:


    ConfigNumber.find("qed.trace.Connection", "0")

Definition at line 84 of file Connection.java.

Referenced by com.quadcap.jdbc.Connection.close(), com.quadcap.jdbc.Connection.commit(), com.quadcap.jdbc.Connection.Connection(), com.quadcap.jdbc.Connection.rollback(), and com.quadcap.jdbc.Connection.setAutoCommit().

Map com.quadcap.jdbc.Connection.typeMap = null [package]
 

Definition at line 91 of file Connection.java.

Referenced by com.quadcap.jdbc.Connection.getTypeMap().