com.arjuna.ats.jts.OTSManager Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of narayana-jts-jacorb Show documentation
Show all versions of narayana-jts-jacorb Show documentation
JTS uber jar with jacorb stubs
/*
* 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) 2001, 2002,
*
* Hewlett-Packard Arjuna Labs,
* Newcastle upon Tyne,
* Tyne and Wear,
* UK.
*
* $Id: OTSManager.java 2342 2006-03-30 13:06:17Z $
*/
package com.arjuna.ats.jts;
import org.omg.CORBA.BAD_PARAM;
import org.omg.CORBA.SystemException;
import org.omg.CosTransactions.Control;
import org.omg.CosTransactions.Coordinator;
import org.omg.CosTransactions.TransactionFactory;
import com.arjuna.ArjunaOTS.ActionControl;
import com.arjuna.ArjunaOTS.ActiveThreads;
import com.arjuna.ArjunaOTS.ActiveTransaction;
import com.arjuna.ArjunaOTS.BadControl;
import com.arjuna.ArjunaOTS.Destroyed;
import com.arjuna.ats.arjuna.coordinator.TransactionReaper;
import com.arjuna.ats.internal.jts.PseudoControlWrapper;
import com.arjuna.ats.internal.jts.orbspecific.ControlImple;
import com.arjuna.ats.internal.jts.orbspecific.TransactionFactoryImple;
import com.arjuna.ats.internal.jts.utils.Helper;
import com.arjuna.ats.jts.logging.jtsLogger;
/**
* This class is essentially here for convenience purposes, and until
* all ORBs provide a means to set their initial references for Current
* and the TransactionFactory.
*
* @author Mark Little ([email protected])
* @version $Id: OTSManager.java 2342 2006-03-30 13:06:17Z $
* @since JTS 1.0.
*/
public class OTSManager
{
/**
* @return the Current object.
*/
public static org.omg.CosTransactions.Current get_current () throws org.omg.CORBA.SystemException
{
return com.arjuna.ats.internal.jts.OTSImpleManager.get_current();
}
/**
* @return the TransactionFactory object implementation. This has the
* advantage of not needing to register the object withm the ORB, which
* can affect performance.
*/
public static TransactionFactoryImple factory () throws org.omg.CORBA.SystemException
{
return com.arjuna.ats.internal.jts.OTSImpleManager.factory();
}
/**
* @return the TransactionFactory object.
*/
public static TransactionFactory get_factory () throws org.omg.CORBA.SystemException
{
return com.arjuna.ats.internal.jts.OTSImpleManager.get_factory();
}
/**
* Used to destroy a transaction control. Normally garbage collection
* will take care of this, but in certain circumstances (e.g., a context
* is propagated implicitly but we do not use interposition and we
* have to manufacture a local control object) it is not possible for the
* OTS to know when controls can be removed. This is a problem with the
* specification and CORBA in general.
*/
public static void destroyControl (ControlImple control) throws ActiveTransaction, ActiveThreads, BadControl, Destroyed, SystemException
{
if (jtsLogger.logger.isTraceEnabled()) {
jtsLogger.logger.trace("OTS::destroyControl ( " + control + " )");
}
if (control == null)
throw new BadControl();
/*
* Just in case control is a top-level transaction, and has
* been registered with the reaper, we need to get it removed.
*
*/
Coordinator coord = null;
try
{
coord = control.get_coordinator();
}
catch (Exception e)
{
coord = null; // nothing else we can do!
}
if (coord != null)
{
try
{
if (coord.is_top_level_transaction())
{
/*
* Transaction is local, but was registered as
* a Control. If this is a performance hit then
* add explicit add/removes for local instances.
*/
if (jtsLogger.logger.isTraceEnabled()) {
jtsLogger.logger.trace("OTS::destroyControl - removing control from reaper.");
}
// wrap the control so it gets compared against reaper list entries using the correct test
PseudoControlWrapper wrapper = new PseudoControlWrapper(control);
TransactionReaper.transactionReaper().remove(wrapper);
}
}
catch (Exception e)
{
}
coord = null;
}
/*
* Watch out for conflicts with multiple threads deleting
* the same control!
*/
/*
* If local, then delete it here, rather than
* calling the destroy method.
*
* Possible problem if a local factory is being accessed
* remotely?
*/
if (jtsLogger.logger.isTraceEnabled()) {
jtsLogger.logger.trace("OTS::destroyControl - local transaction: " + control.get_uid());
}
control.destroy();
control = null;
}
/**
* Destroy the transaction control.
*/
public static void destroyControl (Control control) throws ActiveTransaction, ActiveThreads, BadControl, Destroyed, SystemException
{
if (control == null)
throw new BadControl();
ControlImple lCont = Helper.localControl(control);
if (lCont != null)
{
destroyControl(lCont);
}
else
{
/*
* Just in case control is a top-level transaction, and has
* been registered with the reaper, we need to get it removed.
*
*/
Coordinator coord = null;
try
{
coord = control.get_coordinator();
}
catch (Exception e)
{
coord = null; // nothing else we can do!
}
if (coord != null)
{
try
{
if (coord.is_top_level_transaction()) {
// wrap the control so it gets compared against reaper list entries using the correct test
PseudoControlWrapper wrapper = new PseudoControlWrapper(control);
TransactionReaper.transactionReaper().remove(wrapper);
}
}
catch (Exception e)
{
}
coord = null;
}
/*
* Watch out for conflicts with multiple threads deleting
* the same control!
*/
if (jtsLogger.logger.isTraceEnabled()) {
jtsLogger.logger.trace("OTS::destroyControl - remote control.");
}
/*
* Remote transaction, so memory management is different!
*/
ActionControl action = null;
try
{
action = com.arjuna.ArjunaOTS.ActionControlHelper.narrow(control);
if (action == null)
throw new BAD_PARAM();
}
catch (Exception e)
{
action = null;
}
if (action != null)
{
if (jtsLogger.logger.isTraceEnabled()) {
jtsLogger.logger.trace("OTS::destroyControl - Arjuna control.");
}
/*
* Is an Arjuna control, so we can call destroy on it?
*/
action.destroy();
action = null;
control = null;
}
else
{
/*
* Just call release on the control.
*
* We could throw a BadControl exception, but
* what would that do for the programmer?
*/
control = null;
}
}
}
public static final void setLocalSlotId (int slotId)
{
_localSlotId = slotId;
}
public static final int getLocalSlotId ()
{
return _localSlotId;
}
public static final void setReceivedSlotId (int slotId)
{
_receivedSlotId = slotId;
}
public static final int getReceivedSlotId ()
{
return _receivedSlotId;
}
public static final void setORB (com.arjuna.orbportability.ORB theOrb)
{
com.arjuna.ats.internal.jts.ORBManager.setORB(theOrb);
}
public static final void setPOA (com.arjuna.orbportability.OA thePoa)
{
com.arjuna.ats.internal.jts.ORBManager.setPOA(thePoa);
}
public static final int serviceId = 0xDEADBEEF;
private static int _localSlotId = -1;
private static int _receivedSlotId = -1;
}