org.teiid.connector.xa.api
Interface XAConnector

All Superinterfaces:

Connector

All Known Implementing Classes:

JDBCConnector, OracleSpatialConnector

public interface XAConnector
extends Connector

Method Summary

XAConnection

getXAConnection(ExecutionContext executionContext, TransactionContext transactionContext) Obtain a connection with the connector.

Methods inherited from interface org.teiid.connector.api.Connector

createIdentity, getCapabilities, getConnection, start, stop

Method Detail

getXAConnection

XAConnection getXAConnection(ExecutionContext executionContext,
                             TransactionContext transactionContext)
                             throws ConnectorException

Obtain a connection with the connector. The connection must have XAResource in order to participate in distributed transaction. The connection typically is associated with a particular context.

Parameters:

context - The context of the current user that will be using this connection, may be null if this connection is for an administrative operation.

transactionContext - The context of the transaction under which the connection will be used. May be null.

Returns:

A Connection, created by the Connector

Throws:

ConnectorException - If an error occurred obtaining a connection