程序包 org.apache.seatunnel.connectors.seatunnel.jdbc.internal.xa

接口 XaFacade

所有超级接口:

AutoCloseable, JdbcConnectionProvider, Serializable

所有已知实现类:

XaFacadeImplAutoLoad

public interface XaFacade
extends JdbcConnectionProvider, Serializable, AutoCloseable

Typical workflow:

1. open()
2. start(javax.transaction.xa.Xid) transaction
3. JdbcConnectionProvider.getConnection(), write some data
4. endAndPrepare(javax.transaction.xa.Xid) (or failAndRollback(javax.transaction.xa.Xid))
5. commit(javax.transaction.xa.Xid, boolean) / rollback(javax.transaction.xa.Xid)
6. AutoCloseable.close()

recover() can be used to get abandoned prepared transactions for cleanup.

嵌套类概要

嵌套类

修饰符和类型	接口	说明
static class	XaFacade.EmptyXaTransactionException	Thrown by XaFacade when RM responds with XA_RDONLY indicating that the transaction doesn't include any changes.
static class	XaFacade.TransientXaException	Indicates a transient or unknown failure from the resource manager (see XA_RBTRANSIENT, XAER_RMFAIL).

方法概要

修饰符和类型	方法	说明
void	commit(Xid xid, boolean ignoreUnknown)	Commit previously prepared transaction.
void	endAndPrepare(Xid xid)	End and then prepare the transaction.
void	failAndRollback(Xid xid)	End transaction as failed; in case of error, try to roll it back.
static XaFacade	fromJdbcConnectionOptions(JdbcConnectionConfig jdbcConnectionConfig)
boolean	isOpen()
void	open()
Collection<Xid>	recover()	Note: this can block on some non-MVCC databases if there are ended not prepared transactions.
void	rollback(Xid xid)	Rollback previously prepared transaction.
void	start(Xid xid)	Start a new transaction.

从接口继承的方法 java.lang.AutoCloseable

close

从接口继承的方法 org.apache.seatunnel.connectors.seatunnel.jdbc.internal.connection.JdbcConnectionProvider

closeConnection, getConnection, getOrEstablishConnection, isConnectionValid, reestablishConnection

方法详细资料

fromJdbcConnectionOptions

static XaFacade fromJdbcConnectionOptions(JdbcConnectionConfig jdbcConnectionConfig)

open

void open()
   throws Exception

抛出:

Exception

isOpen

boolean isOpen()

start

void start(Xid xid)
    throws Exception

Start a new transaction.

抛出:

Exception

endAndPrepare

void endAndPrepare(Xid xid)
            throws Exception

End and then prepare the transaction. Transaction can't be resumed afterwards.

抛出:

Exception

commit

void commit(Xid xid,
            boolean ignoreUnknown)
     throws XaFacade.TransientXaException

Commit previously prepared transaction.

参数:

ignoreUnknown - whether to ignore XAER_NOTA error.

抛出:

XaFacade.TransientXaException

rollback

void rollback(Xid xid)
       throws XaFacade.TransientXaException

Rollback previously prepared transaction.

抛出:

XaFacade.TransientXaException

failAndRollback

void failAndRollback(Xid xid)
              throws XaFacade.TransientXaException

End transaction as failed; in case of error, try to roll it back.

抛出:

XaFacade.TransientXaException

recover

Collection<Xid> recover()
                 throws XaFacade.TransientXaException

Note: this can block on some non-MVCC databases if there are ended not prepared transactions.

抛出:

XaFacade.TransientXaException