Package org.apache.activemq.artemis.service.extensions.xa.recovery

Class ActiveMQXAResourceWrapper

java.lang.Object

org.apache.activemq.artemis.service.extensions.xa.recovery.ActiveMQXAResourceWrapper

All Implemented Interfaces:

XAResource, SessionFailureListener, FailureListener

public class ActiveMQXAResourceWrapper
extends Object
implements XAResource, SessionFailureListener

XAResourceWrapper. Mainly from org.jboss.server.XAResourceWrapper from the JBoss AS server module The reason why we don't use that class directly is that it assumes on failure of connection the RM_FAIL or RM_ERR is thrown, but in ActiveMQ Artemis we throw XA_RETRY since we want the recovery manager to be able to retry on failure without having to manually retry

Field Summary

Fields inherited from interface javax.transaction.xa.XAResource

TMENDRSCAN, TMFAIL, TMJOIN, TMNOFLAGS, TMONEPHASE, TMRESUME, TMSTARTRSCAN, TMSUCCESS, TMSUSPEND, XA_OK, XA_RDONLY

Constructor Summary

Constructors

Constructor	Description
ActiveMQXAResourceWrapper(XARecoveryConfig... xaRecoveryConfigs)

Method Summary

Modifier and Type	Method	Description
void	beforeReconnect(ActiveMQException me)	Notifies that a connection has failed due to the specified exception.
protected XAException	check(XAException e)	Check whether an XAException is fatal.
void	close()	Close the connection
void	commit(Xid xid, boolean onePhase)
protected XAResource	connect()	Connect to the server if not already done so
void	connectionFailed(ActiveMQException me, boolean failedOver)	Notifies that a connection has failed due to the specified exception.
void	connectionFailed(ActiveMQException me, boolean failedOver, String scaleDownTargetNodeID)	Notifies that a connection has failed due to the specified exception.
void	end(Xid xid, int flags)
void	forget(Xid xid)
int	getTransactionTimeout()
boolean	isSameRM(XAResource xaRes)
int	prepare(Xid xid)
Xid[]	recover(int flag)
void	rollback(Xid xid)
boolean	setTransactionTimeout(int seconds)
void	start(Xid xid, int flags)
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ActiveMQXAResourceWrapper

public ActiveMQXAResourceWrapper(XARecoveryConfig... xaRecoveryConfigs)

Method Detail

recover

public Xid[] recover(int flag)
              throws XAException

Specified by:

recover in interface XAResource

Throws:

XAException

commit

public void commit(Xid xid,
                   boolean onePhase)
            throws XAException

Specified by:

commit in interface XAResource

Throws:

XAException

rollback

public void rollback(Xid xid)
              throws XAException

Specified by:

rollback in interface XAResource

Throws:

XAException

forget

public void forget(Xid xid)
            throws XAException

Specified by:

forget in interface XAResource

Throws:

XAException

isSameRM

public boolean isSameRM(XAResource xaRes)
                 throws XAException

Specified by:

isSameRM in interface XAResource

Throws:

XAException

prepare

public int prepare(Xid xid)
            throws XAException

Specified by:

prepare in interface XAResource

Throws:

XAException

start

public void start(Xid xid,
                  int flags)
           throws XAException

Specified by:

start in interface XAResource

Throws:

XAException

end

public void end(Xid xid,
                int flags)
         throws XAException

Specified by:

end in interface XAResource

Throws:

XAException

getTransactionTimeout

public int getTransactionTimeout()
                          throws XAException

Specified by:

getTransactionTimeout in interface XAResource

Throws:

XAException

setTransactionTimeout

public boolean setTransactionTimeout(int seconds)
                              throws XAException

Specified by:

setTransactionTimeout in interface XAResource

Throws:

XAException

connectionFailed

public void connectionFailed(ActiveMQException me,
                             boolean failedOver)

Description copied from interface: FailureListener

Notifies that a connection has failed due to the specified exception.

Specified by:

connectionFailed in interface FailureListener

Parameters:

me - exception which has caused the connection to fail

connectionFailed

public void connectionFailed(ActiveMQException me,
                             boolean failedOver,
                             String scaleDownTargetNodeID)

Description copied from interface: FailureListener

Notifies that a connection has failed due to the specified exception.

Specified by:

connectionFailed in interface FailureListener

Parameters:

me - exception which has caused the connection to fail

scaleDownTargetNodeID - the ID of the node to which messages are scaling down

beforeReconnect

public void beforeReconnect(ActiveMQException me)

Description copied from interface: SessionFailureListener

Notifies that a connection has failed due to the specified exception.
This method is called before the session attempts to reconnect/failover.

Specified by:

beforeReconnect in interface SessionFailureListener

Parameters:

me - exception which has caused the connection to fail

connect

protected XAResource connect()
                      throws Exception

Connect to the server if not already done so

Returns:

the connectionFactory XAResource

Throws:

Exception - for any problem

toString

public String toString()

Overrides:

toString in class Object

close

public void close()

Close the connection

check

protected XAException check(XAException e)
                     throws XAException

Check whether an XAException is fatal. If it is an RM problem we close the connection so the next call will reconnect.

Parameters:

e - the xa exception

Returns:

never

Throws:

XAException - always