Package com.arjuna.ats.internal.jdbc.drivers.modifiers

Interface ConnectionModifier

All Superinterfaces:

XAModifier

All Known Implementing Classes:

IsSameRMModifier, SupportsMultipleConnectionsModifier

public interface ConnectionModifier
extends XAModifier

Instances of this class enable us to work around problems in certain databases (specifically Oracle).

Since:

JTS 1.2.4.

Version:

$Id: ConnectionModifier.java 2342 2006-03-30 13:06:17Z $

Author:

Mark Little (mark@arjuna.com)

Method Summary

Modifier and Type	Method	Description
XAConnection	getConnection(XAConnection conn)	Deprecated. This is no longer used by the transaction manager
String	initialise(String dbName)	Initialise the modifier.
boolean	requiresSameRMOverride()	This method indicates whether the driver supports TMJOIN reliably.
void	setIsolationLevel(Connection conn, int level)
boolean	supportsMultipleConnections()	Does their JDBC driver support multiple connections in a single transaction?

Methods inherited from interface com.arjuna.ats.jta.xa.XAModifier

createXid, xaStartParameters

Method Details

initialise

String initialise(String dbName)

Initialise the modifier.

Returns:

the database name to use.

Since:

JTS 2.2.

getConnection

XAConnection getConnection(XAConnection conn)
                    throws SQLException,
NotImplementedException

Deprecated.

This is no longer used by the transaction manager

Return a new connection.

Throws:

SQLException

NotImplementedException

supportsMultipleConnections

boolean supportsMultipleConnections()
                             throws SQLException,
NotImplementedException

Does their JDBC driver support multiple connections in a single transaction?

Throws:

SQLException

NotImplementedException

setIsolationLevel

void setIsolationLevel(Connection conn,
 int level)
                throws SQLException,
NotImplementedException

Throws:

SQLException

NotImplementedException

requiresSameRMOverride

boolean requiresSameRMOverride()

This method indicates whether the driver supports TMJOIN reliably. If isSameRM returns true but does not support xares1.start(xid1,TMNOFLAGS); xares2.start(xid2, TMJOIN) then you need to make sure you set this to true to use a wrapped XAR that returns false for the driver. See JBTM-2264 for more details.