JdbcXAConnection

This class provides support for distributed transactions. An application developer usually does not use this interface. It is used by the transaction manager internally.

Methods
void addConnectionEventListener(ConnectionEventListener listener)
Register a new listener for the connection.
void addConnectionEventListener(ConnectionEventListener listener)
Register a new listener for the connection.
Parameters:
listener - the event listener
void addStatementEventListener(StatementEventListener listener)
[Not supported] Add a statement event listener.
void addStatementEventListener(StatementEventListener listener)
[Not supported] Add a statement event listener.
Parameters:
listener - the new statement event listener
void close()
Close the physical connection.
void close() throws SQLException
Close the physical connection. This method is usually called by the connection pool.
void commit(Xid xid, boolean onePhase)
Commit a transaction.
void commit(Xid xid, boolean onePhase) throws XAException
Commit a transaction.
Parameters:
xid - the transaction id
onePhase - use a one-phase protocol if true
void end(Xid xid, int flags)
End a transaction.
void end(Xid xid, int flags) throws XAException
End a transaction.
Parameters:
xid - the transaction id
flags - TMSUCCESS, TMFAIL, or TMSUSPEND
void forget(Xid xid)
Forget a transaction.
void forget(Xid xid)
Forget a transaction. This method does not have an effect for this database.
Parameters:
xid - the transaction id
Connection getConnection()
Get a connection that is a handle to the physical connection.
Connection getConnection() throws SQLException
Get a connection that is a handle to the physical connection. This method is usually called by the connection pool. This method closes the last connection handle if one exists.
Returns:
the connection
int getTransactionTimeout()
Get the transaction timeout.
int getTransactionTimeout()
Get the transaction timeout.
Returns:
0
XAResource getXAResource()
Get the XAResource object.
XAResource getXAResource()
Get the XAResource object.
Returns:
itself
boolean isSameRM(XAResource xares)
Checks if this is the same XAResource.
boolean isSameRM(XAResource xares)
Checks if this is the same XAResource.
Parameters:
xares - the other object
Returns:
true if this is the same object
int prepare(Xid xid)
Prepare a transaction.
int prepare(Xid xid) throws XAException
Prepare a transaction.
Parameters:
xid - the transaction id
Returns:
XA_OK
Xid[] recover(int flag)
Get the list of prepared transaction branches.
Xid[] recover(int flag) throws XAException
Get the list of prepared transaction branches. This method is called by the transaction manager during recovery.
Parameters:
flag - TMSTARTRSCAN, TMENDRSCAN, or TMNOFLAGS. If no other flags are set, TMNOFLAGS must be used.
Returns:
zero or more Xid objects
void removeConnectionEventListener(ConnectionEventListener listener)
Remove the event listener.
void removeConnectionEventListener(ConnectionEventListener listener)
Remove the event listener.
Parameters:
listener - the event listener
void removeStatementEventListener(StatementEventListener listener)
[Not supported] Remove a statement event listener.
void removeStatementEventListener(StatementEventListener listener)
[Not supported] Remove a statement event listener.
Parameters:
listener - the statement event listener
void rollback(Xid xid)
Roll back a transaction.
void rollback(Xid xid) throws XAException
Roll back a transaction.
Parameters:
xid - the transaction id
boolean setTransactionTimeout(int seconds)
Set the transaction timeout.
boolean setTransactionTimeout(int seconds)
Set the transaction timeout.
Parameters:
seconds - ignored
Returns:
false
void start(Xid xid, int flags)
Start or continue to work on a transaction.
void start(Xid xid, int flags) throws XAException
Start or continue to work on a transaction.
Parameters:
xid - the transaction id
flags - TMNOFLAGS, TMJOIN, or TMRESUME