com.arjuna.ats.internal.jts.orbspecific.interposition

Class ServerControl

java.lang.Object

org.omg.PortableServer.Servant

com.arjuna.ArjunaOTS.ActionControlPOA

com.arjuna.ats.internal.jts.orbspecific.ControlImple

com.arjuna.ats.internal.jts.orbspecific.interposition.ServerControl

All Implemented Interfaces:

ActionControlOperations, InvokeHandler, ControlOperations

public class ServerControl
extends ControlImple

As with ControlImple, the transaction is maintained until the control object is deleted. This class maintains a handle on the current server-side transaction, and also references to the original transaction it is "mirroring". This allows us to have a single place to hold both sets of information which is accessible to interposed resources, synchronizations, and transactions.

Since:

JTS 1.0.

Version:

$Id: ServerControl.java 2342 2006-03-30 13:06:17Z $

Author:

Mark Little (mark@arjuna.com)

Field Summary

Fields

Modifier and Type	Field and Description
static Hashtable	allServerControls

Fields inherited from class com.arjuna.ats.internal.jts.orbspecific.ControlImple

_destroyed, _myControl, _parentControl, _theCoordinator, _theTerminator, _theUid, _transactionHandle, _transactionImpl, allControls

Constructor Summary

Constructors

Constructor and Description
ServerControl(ServerTransaction stx)
ServerControl(Uid actUid, Control parentCon, ArjunaTransactionImple parentTran, Coordinator realCoord, Terminator realTerm)

Method Summary

Modifier and Type	Method and Description
protected boolean	addControl() Transaction needs to call these methods to enable garbage collection to occur.
void	destroy() destroy should only be called for remote Control objects.
boolean	forgetHeuristics()
ControlImple	getParentImple()
boolean	isWrapper()
Coordinator	originalCoordinator()
Terminator	originalTerminator()
protected boolean	removeControl()
String	toString()

Methods inherited from class com.arjuna.ats.internal.jts.orbspecific.ControlImple

canDestroy, canDestroy, createTransactionHandle, duplicateTransactionHandle, equals, finalize, get_coordinator, get_terminator, get_uid, getControl, getFinalStatus, getImplHandle, getParentControl, set_coordinator, set_terminator, tidyup

Methods inherited from class com.arjuna.ArjunaOTS.ActionControlPOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

clone, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

allServerControls

public static Hashtable allServerControls

Constructor Detail

ServerControl

public ServerControl(Uid actUid,
                     Control parentCon,
                     ArjunaTransactionImple parentTran,
                     Coordinator realCoord,
                     Terminator realTerm)

ServerControl

public ServerControl(ServerTransaction stx)

Method Detail

isWrapper

public final boolean isWrapper()

originalCoordinator

public Coordinator originalCoordinator()

originalTerminator

public Terminator originalTerminator()

destroy

public void destroy()
             throws ActiveTransaction,
                    ActiveThreads,
                    BadControl,
                    Destroyed,
                    SystemException

Description copied from class: ControlImple

destroy should only be called for remote Control objects. Destroy them locally by calling DESTROY_IMPL. Since we assume that a factory will either be remote or local, we can destroy this object and rely upon the ORB to return an exception to subsequent clients which indicates they no longer have a valid reference.

Specified by:

destroy in interface ActionControlOperations

Overrides:

destroy in class ControlImple

Throws:

ActiveTransaction

ActiveThreads

BadControl

Destroyed

SystemException

getParentImple

public ControlImple getParentImple()

Overrides:

getParentImple in class ControlImple

toString

public String toString()

Overrides:

toString in class ControlImple

forgetHeuristics

public final boolean forgetHeuristics()

addControl

protected boolean addControl()

Description copied from class: ControlImple

Transaction needs to call these methods to enable garbage collection to occur. Note, we assume that one ContorlImple per transaction is maintained per address space, so that overwriting a previously added ControlImple for the same tx is not possible.

Overrides:

addControl in class ControlImple

removeControl

protected boolean removeControl()

Overrides:

removeControl in class ControlImple