1.1

java.sql.BatchUpdateException Class
This class is an extension of SQLException that is thrown if a failure occurs during execution of a batch statement.
Such a failure can occur with the batch operation of the JDBC Statement, PreparedStatement or CallableStatement
classes. Exceptions caused by other batch elements are maintained in the getNextException() chain, as they are
for SQLExceptions.
This class adds one new method to the SQLException class named getUpdateCounts(). This method returns an
array of update counts of the statements that executed successfully before the exception occurred.
java.sql.Connection Interface
A SQLFire Connection object is not garbage-collected until all other JDBC objects created from that connection
are explicitly closed or are themselves garbage-collected. Once the connection is closed, no further JDBC requests
can be made against objects created from the connection. Do not explicitly close the Connection object until you
no longer need it for executing statements.
A session-severity or higher exception causes the connection to close and all other JDBC objects against it to
be closed.
java.sql.Connection.setTransactionIsolation Method
Only java.sql.Connection.TRANSACTION_NONE, and
java.sql.Connection.TRANSACTION_READ_COMMITTED transaction isolation levels are available in
SQLFire.
TRANSACTION_NONE is the default isolation level.
Changing the current isolation for the connection with setTransactionIsolation commits the current transaction
and begins a new transaction.
Note: Special Note on TRANSACTION_NONE
SQLFire provides atomicity and thread safety for row-level operations even in TRANSACTION_NONE
isolation level.
For more details about transaction isolation, see Using Distributed Transactions in Your Applications on page
147.
Connection Functionality Not Supported
java.sql.Connection.setReadOnly and isReadOnly methodsRead-only connections are not supported in SQLFire.
Calling setReadOnly with a value of true throws a "Feature not supported" exception, and isReadOnly always
returns false.
Connections to XA DataSources (javax.sql.XADataSource) are not supported in this release of SQLFire.
SQLFire does not use catalog names. In addition, the following optional methods raise "Feature not supported"
exceptions:
• createArrayOf( java.lang.String, java.lang.Object[] )
• createNClob( )
• createSQLXML( )
• createStruct( java.lang.String, java.lang.Object[] )
• getTypeMap( )
vFabric SQLFire User's Guide352
vFabric SQLFire Reference