Package com.arjuna.demo.recoverymodule

Source Code of com.arjuna.demo.recoverymodule.TestRecoveryModule

/*
* JBoss, Home of Professional Open Source
* Copyright 2006, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags.
* See the copyright.txt in the distribution for a full listing
* of individual contributors.
* 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, v. 2.1.
* This program is distributed in the hope that it will be useful, but WITHOUT A
* 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,
* v.2.1 along with this distribution; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
* MA  02110-1301, USA.
*
* (C) 2005-2006,
* @author JBoss Inc.
*/
/*
* Copyright (C) 2003, 2004
* Arjuna Technologies Limited
* Newcastle upon Tyne, UK
*
* $Id: TestRecoveryModule.java 2342 2006-03-30 13:06:17Z  $
*/

package com.arjuna.demo.recoverymodule;

import com.arjuna.ats.arjuna.AtomicAction;
import com.arjuna.ats.arjuna.coordinator.ActionStatus;
import com.arjuna.ats.arjuna.coordinator.AddOutcome;

/**
* BEWARE: Implementing a <CODE>RecoveryModule</CODE> and <CODE>AbstractRecord</CODE> is a very advanced feature of the
* transaction service. It should only be performed by users familiar with the all the concepts used in the Arjuna
* Transactions product. Please see the ArjunaCore guide for more information about <CODE>RecoveryModule</CODE>s and
* <CODE>AbstractRecord</CODE>s.

* This is the entry point into the JBoss Transactions product advanced trailmap regarding the implementation of a
* recovery module. It allows a user to create a record within the scope of a transaction and then to commit or
* abort the transaction. The program is quite verbose and describes as it is running what is happening.
*
* The program illustrates the crash recovery capabilities of the JBoss Transactions product. The record type it
* defines allows us to crash the application during the commit of the resource. We can then see how the recovery
* manager will (when the application recovers [restarts]) retry to commit the transaction.
*/
public class TestRecoveryModule
{
    /**
     * Runs the recovery module test program. This will create a <CODE>SimpleRecord</CODE> telling it whether to crash
     * or not and then commit/rollback transaction depending upon user choices.
     *
     * @param args  The arguments are not required but can contain any of "-commit" "-rollback" "-crash"
     */
    public static void main(String args[])
    {
        // Initialize the configuration for the test
        boolean commit = true;
        boolean crash = false;

        // Obtain the user choices about the test type to run
        for (int i = 0; i < args.length; i++)
        {
            if ((args[i].compareTo("-commit") == 0))
                commit = true;
            if ((args[i].compareTo("-rollback") == 0))
                commit = false;
            if ((args[i].compareTo("-crash") == 0))
                crash = true;
        }

        // Create a new JBoss transaction
        AtomicAction tx = new AtomicAction();
        // Allocate space to monitor the transaction, this variable is overriden each time the transaction is used.
        int actionStatus = tx.begin(); // Top level begin

        // If the transaction was successful began
        if (actionStatus == ActionStatus.RUNNING)
        {
            // Enlist the participant
            int addOutcome = tx.add(new SimpleRecord(crash));
            // If the participant was succesfully added to the intentions list
            if (addOutcome == AddOutcome.AR_ADDED)
            {
                System.out.println("About to complete the transaction ");
                // Try to complete the transaction as requested by the user
                if (commit)
                    actionStatus = tx.commit()// Top level commit
                else
                    actionStatus = tx.abort()// Top level rollback

                System.out.println("The status of the transaction is " + ActionStatus.stringForm(actionStatus));
            }
            else
            {
                // There was an unexpected problem adding the record to the transaction
                System.err.println("There was an unexpected problem calling AtomicAction.add(AbstractRecord), returned: " +
                                   AddOutcome.printString(actionStatus));
            }
        }
        // A problem occured beginning the transaction
        else
        {
            // There was an unexpected problem beginning the transaction
            System.err.println("There was an unexpected problem calling AtomicAction.begin(), returned: " +
                               ActionStatus.stringForm(actionStatus));
        }
    }
}
TOP

Related Classes of com.arjuna.demo.recoverymodule.TestRecoveryModule

TOP
Copyright © 2018 www.massapi.com. All rights reserved.
All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.