/*
* Bitronix Transaction Manager
*
* Copyright (c) 2010, Bitronix Software.
*
* This copyrighted material is made available to anyone wishing to use, modify,
* copy, or redistribute it subject to the terms and conditions of the GNU
* Lesser General Public License, as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this distribution; if not, write to:
* Free Software Foundation, Inc.
* 51 Franklin Street, Fifth Floor
* Boston, MA 02110-1301 USA
*/
package bitronix.tm.twopc;
import java.lang.reflect.*;
import java.sql.Connection;
import java.util.List;
import java.util.concurrent.atomic.AtomicReference;
import javax.sql.XAConnection;
import javax.transaction.*;
import javax.transaction.xa.XAException;
import bitronix.tm.journal.Journal;
import junit.framework.TestCase;
import bitronix.tm.*;
import bitronix.tm.mock.AbstractMockJdbcTest;
import bitronix.tm.mock.events.*;
import bitronix.tm.mock.resource.*;
import bitronix.tm.mock.resource.jdbc.*;
import bitronix.tm.resource.jdbc.*;
import bitronix.tm.resource.jdbc.lrc.LrcXADataSource;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
*
* @author lorban
*/
public class Phase1FailureTest extends TestCase {
private final static Logger log = LoggerFactory.getLogger(Phase1FailureTest.class);
private PoolingDataSource poolingDataSource1;
private PoolingDataSource poolingDataSource2;
private PoolingDataSource poolingDataSource3;
private PoolingDataSource poolingDataSourceLrc;
private BitronixTransactionManager tm;
/**
* Test scenario:
*
* XAResources: 2
* TX timeout: 10s
* TX resolution: rollback
*
* XAResource 1 resolution: rollback throws exception XAException.XAER_INVAL, exception fixed after 2s
* XAResource 2 resolution: prepare throws exception XAException.XAER_RMERR
*
* Expected outcome:
* TM fails on resource 2 prepare and throws RollbackException. On call to rollback, resource 2 fails to rollback
* and is retried twice (once per second) then rollback should succeed.
* Expected TM events:
* 2 XAResourcePrepareEvent, 1 XAResourceRollbackEvent
* Expected journal events:
* ACTIVE, PREPARING, UNKNOWN, ROLLING_BACK, UNKNOWN
* @throws Exception if any error happens.
*/
public void testPrepareFailureRollbackFailure() throws Exception {
tm.begin();
tm.setTransactionTimeout(10); // TX must not timeout
Connection connection1 = poolingDataSource1.getConnection();
PooledConnectionProxy handle = (PooledConnectionProxy) connection1;
XAConnection xaConnection1 = (XAConnection) AbstractMockJdbcTest.getWrappedXAConnectionOf(handle.getPooledConnection());
connection1.createStatement();
Connection connection2 = poolingDataSource2.getConnection();
PooledConnectionProxy handle2 = (PooledConnectionProxy) connection2;
XAConnection xaConnection2 = (XAConnection) AbstractMockJdbcTest.getWrappedXAConnectionOf(handle2.getPooledConnection());
connection2.createStatement();
final MockXAResource mockXAResource1 = (MockXAResource) xaConnection1.getXAResource();
mockXAResource1.setRollbackException(createXAException("resource 1 rollback failed", XAException.XAER_INVAL));
MockXAResource mockXAResource2 = (MockXAResource) xaConnection2.getXAResource();
mockXAResource2.setPrepareException(createXAException("resource 2 prepare failed", XAException.XAER_RMERR));
try {
tm.commit();
fail("TM should have thrown an exception");
} catch (RollbackException ex) {
assertTrue(ex.getMessage().matches("transaction failed to prepare: a Bitronix Transaction with GTRID \\[.*\\], status=ROLLEDBACK, 2 resource\\(s\\) enlisted .*"));
assertEquals("collected 1 exception(s):" + System.getProperty("line.separator") +
" [pds2 - javax.transaction.xa.XAException(XAER_RMERR) - resource 2 prepare failed]", ex.getCause().getCause().getMessage());
}
log.info(EventRecorder.dumpToString());
// we should find in the journal log:
// 2 prepare tries (1 successful for resource 1, 1 failed for resource 2)
// 2 rollback tries (1 failed for resource 1, 1 successful for resource 2)
// the rollabck error on resource 1 should not be reported to the code as it is the job
// of the recovery engine to clean it up and eventually report the heuristic
int journalUnknownEventCount = 0;
int prepareEventCount = 0;
int rollbackEventCount = 0;
List events = EventRecorder.getOrderedEvents();
for (int i = 0; i < events.size(); i++) {
Event event = (Event) events.get(i);
if (event instanceof XAResourceRollbackEvent)
rollbackEventCount++;
if (event instanceof XAResourcePrepareEvent)
prepareEventCount++;
if (event instanceof JournalLogEvent) {
if (((JournalLogEvent) event).getStatus() == Status.STATUS_UNKNOWN)
journalUnknownEventCount++;
}
}
assertEquals("TM should have journaled 0 UNKNOWN status", 0, journalUnknownEventCount);
assertEquals("TM haven't properly tried to prepare", 2, prepareEventCount);
assertEquals("TM haven't properly tried to rollback", 2, rollbackEventCount);
}
/**
* Test scenario:
*
* XAResources: 3
* TX timeout: 10s
* TX resolution: rollback
*
* @throws Exception if any error happens.
*/
public void testPrepareFailure() throws Exception {
tm.begin();
tm.setTransactionTimeout(10); // TX must not timeout
Connection connection1 = poolingDataSource1.getConnection();
connection1.createStatement();
Connection connection2 = poolingDataSource2.getConnection();
PooledConnectionProxy handle = (PooledConnectionProxy) connection2;
XAConnection xaConnection2 = (XAConnection) AbstractMockJdbcTest.getWrappedXAConnectionOf(handle.getPooledConnection());
connection2.createStatement();
Connection connection3 = poolingDataSource2.getConnection();
connection3.createStatement();
MockXAResource mockXAResource2 = (MockXAResource) xaConnection2.getXAResource();
mockXAResource2.setPrepareException(createXAException("resource 2 prepare failed", XAException.XAER_RMERR));
try {
tm.commit();
fail("TM should have thrown an exception");
} catch (RollbackException ex) {
assertTrue(ex.getMessage().matches("transaction failed to prepare: a Bitronix Transaction with GTRID (.*?) status=ROLLEDBACK, 3 resource\\(s\\) enlisted (.*?)"));
assertTrue(ex.getCause().getMessage().matches("transaction failed during prepare of a Bitronix Transaction with GTRID (.*?), status=PREPARING, 3 resource\\(s\\) enlisted (.*?): resource\\(s\\) \\[pds2\\] threw unexpected exception"));
assertEquals("collected 1 exception(s):" + System.getProperty("line.separator") +
" [pds2 - javax.transaction.xa.XAException(XAER_RMERR) - resource 2 prepare failed]", ex.getCause().getCause().getMessage());
}
log.info(EventRecorder.dumpToString());
// we should find a ROLLEDBACK status in the journal log
// and 3 prepare tries (1 successful for resources 1 and 3, 1 failed for resource 2)
// and 3 rollback tries (1 successful for each resource)
int journalRollbackEventCount = 0;
int prepareEventCount = 0;
int rollbackEventCount = 0;
List events = EventRecorder.getOrderedEvents();
for (int i = 0; i < events.size(); i++) {
Event event = (Event) events.get(i);
if (event instanceof XAResourceRollbackEvent)
rollbackEventCount++;
if (event instanceof XAResourcePrepareEvent)
prepareEventCount++;
if (event instanceof JournalLogEvent) {
if (((JournalLogEvent) event).getStatus() == Status.STATUS_ROLLEDBACK)
journalRollbackEventCount++;
}
}
assertEquals("TM should have journaled 1 ROLLEDBACK status", 1, journalRollbackEventCount);
assertEquals("TM haven't properly tried to prepare", 3, prepareEventCount);
assertEquals("TM haven't properly tried to rollback", 3, rollbackEventCount);
}
/**
* Test scenario:
*
* XAResources: 2
* TX timeout: 10s
* TX resolution: rollback
* XAResource 1 resolution: prepare throws exception XAException.XAER_RMERR
* XAResource 2 resolution: it's an LRCXaResource and prepare does not happen on this resource.
*
* Expected outcome:
* TM fails on resource 1 prepare and throws RollbackException. Prepare must not happen on resource 2.
* On call to rollback, the two resource rollback should succeed.
* Expected TM events:
* 1 XAResourcePrepareEvent, 1 XAResourceRollbackEvent
* Expected journal events:
* ACTIVE, MARKED_ROLLBACK, ROLLING_BACK, ROLLEDBACK
* @throws Exception if any error happens.
*/
public void testPrepareLrcFailure() throws Exception {
tm.begin();
tm.setTransactionTimeout(10); // TX must not timeout
Connection connection1 = poolingDataSource1.getConnection();
PooledConnectionProxy handle = (PooledConnectionProxy) connection1;
XAConnection xaConnection1 = (XAConnection) AbstractMockJdbcTest.getWrappedXAConnectionOf(handle.getPooledConnection());
connection1.createStatement();
Connection connection2 = poolingDataSourceLrc.getConnection();
connection2.createStatement();
MockXAResource mockXAResource1 = (MockXAResource) xaConnection1.getXAResource();
mockXAResource1.setPrepareException(createXAException("resource 1 prepare failed", XAException.XAER_RMERR));
try {
tm.commit();
fail("TM should have thrown an exception");
} catch (RollbackException ex) {
assertTrue(ex.getMessage().matches("transaction failed to prepare: a Bitronix Transaction with GTRID (.*?) status=ROLLEDBACK, 2 resource\\(s\\) enlisted (.*?)"));
assertTrue(ex.getCause().getMessage().matches("transaction failed during prepare of a Bitronix Transaction with GTRID (.*?), status=PREPARING, 2 resource\\(s\\) enlisted (.*?): resource\\(s\\) \\[pds1\\] threw unexpected exception"));
assertEquals("collected 1 exception(s):" + System.getProperty("line.separator") +
" [pds1 - javax.transaction.xa.XAException(XAER_RMERR) - resource 1 prepare failed]", ex.getCause().getCause().getMessage());
}
log.info(EventRecorder.dumpToString());
// we should find a ROLLEDBACK status in the journal log
// and 1 prepare tries (1 failed for resource 1)
// and 2 rollback tries (1 rollback and 1 localRollback)
int journalRollbackEventCount = 0;
int prepareEventCount = 0;
int rollbackEventCount = 0;
int localRollbackEventCount = 0;
List events = EventRecorder.getOrderedEvents();
for (int i = 0; i < events.size(); i++) {
Event event = (Event) events.get(i);
if (event instanceof XAResourceRollbackEvent)
rollbackEventCount++;
if (event instanceof XAResourcePrepareEvent)
prepareEventCount++;
if (event instanceof LocalRollbackEvent)
localRollbackEventCount++;
if (event instanceof JournalLogEvent) {
if (((JournalLogEvent) event).getStatus() == Status.STATUS_ROLLEDBACK)
journalRollbackEventCount++;
}
}
assertEquals("TM should have journaled 1 ROLLEDBACK status", 1, journalRollbackEventCount);
assertEquals("TM haven't properly tried to prepare", 1, prepareEventCount);
assertEquals("TM haven't properly tried to rollback", 1, rollbackEventCount);
assertEquals("TM haven't properly tried to rollback", 1, localRollbackEventCount);
}
protected void setUp() throws Exception {
EventRecorder.clear();
// change disk journal into mock journal
Field field = TransactionManagerServices.class.getDeclaredField("journalRef");
field.setAccessible(true);
AtomicReference<Journal> journalRef = (AtomicReference<Journal>) field.get(TransactionManagerServices.class);
journalRef.set(new MockJournal());
poolingDataSource1 = new PoolingDataSource();
poolingDataSource1.setClassName(MockitoXADataSource.class.getName());
poolingDataSource1.setUniqueName("pds1");
poolingDataSource1.setMinPoolSize(5);
poolingDataSource1.setMaxPoolSize(5);
poolingDataSource1.setAutomaticEnlistingEnabled(true);
poolingDataSource1.init();
poolingDataSource2 = new PoolingDataSource();
poolingDataSource2.setClassName(MockitoXADataSource.class.getName());
poolingDataSource2.setUniqueName("pds2");
poolingDataSource2.setMinPoolSize(5);
poolingDataSource2.setMaxPoolSize(5);
poolingDataSource2.setAutomaticEnlistingEnabled(true);
poolingDataSource2.init();
poolingDataSource3 = new PoolingDataSource();
poolingDataSource3.setClassName(MockitoXADataSource.class.getName());
poolingDataSource3.setUniqueName("pds3");
poolingDataSource3.setMinPoolSize(5);
poolingDataSource3.setMaxPoolSize(5);
poolingDataSource3.setAutomaticEnlistingEnabled(true);
poolingDataSource3.init();
poolingDataSourceLrc = new PoolingDataSource();
poolingDataSourceLrc.setClassName(LrcXADataSource.class.getName());
poolingDataSourceLrc.setUniqueName("pds4_lrc");
poolingDataSourceLrc.setMinPoolSize(5);
poolingDataSourceLrc.setMaxPoolSize(5);
poolingDataSourceLrc.setAllowLocalTransactions(true);
poolingDataSourceLrc.getDriverProperties().setProperty("driverClassName", MockDriver.class.getName());
poolingDataSourceLrc.getDriverProperties().setProperty("user", "user");
poolingDataSourceLrc.getDriverProperties().setProperty("password", "password");
poolingDataSourceLrc.init();
tm = TransactionManagerServices.getTransactionManager();
}
protected void tearDown() throws Exception {
poolingDataSource1.close();
poolingDataSource2.close();
poolingDataSource3.close();
poolingDataSourceLrc.close();
tm.shutdown();
}
private XAException createXAException(String msg, int errorCode) {
XAException prepareException = new XAException(msg);
prepareException.errorCode = errorCode;
return prepareException;
}
}