TxnManagerImpl (Apache River v3.0.0 API Documentation (internals))

java.lang.Object
- org.apache.river.mahalo.TxnManagerImpl

All Implemented Interfaces:

Remote, Administrable, JoinAdmin, TransactionConstants, TransactionManager, ProxyAccessor, ServerProxyTrust, DestroyAdmin, Startable, TimeConstants, Landlord, LocalLandlord, LeaseExpirationMgr.Expirer, LogRecovery, TxnManager, TxnSettler, ServiceProxyAccessor

Direct Known Subclasses:

ActivatableMahaloImpl, NonActivatableMahaloImpl, TransientMahaloImpl
```
class TxnManagerImpl
extends Object
implements TxnManager, LeaseExpirationMgr.Expirer, LogRecovery, TxnSettler, TimeConstants, LocalLandlord, ServerProxyTrust, ProxyAccessor, Startable
```
An implementation of the Jini Transaction Specification.

Author:

Sun Microsystems, Inc.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

private class TxnManagerImpl.DestroyThread
Termination thread code.

private static class TxnManagerImpl.FutureFactory
- Nested classes/interfaces inherited from interface org.apache.river.landlord.Landlord
  Landlord.RenewResults
- Nested classes/interfaces inherited from interface net.jini.core.transaction.server.TransactionManager
  TransactionManager.Created

Nested Classes
Modifier and Type	Class and Description
`private class`	`TxnManagerImpl.DestroyThread` Termination thread code.
`private static class`	`TxnManagerImpl.FutureFactory`

Field Summary

Fields
Modifier and Type	Field and Description
`private ActivationID`	`activationID`
`private boolean`	`activationPrepared` Whether the activation ID has been prepared
`private ActivationSystem`	`activationSystem` The activation system, prepared
`private Configuration`	`config`
`private AccessControlContext`	`context`
`(package private) static Logger`	`destroyLogger` Logger for service destruction related messages
`private LeaseExpirationMgr`	`expMgr` `LeaseExpirationMgr` used by our `LeasePolicy`.
`protected Exporter`	`exporter` The exporter for exporting and unexporting
`private static SecureRandom`	`idGen` The generator for our IDs.
`private static byte[]`	`idGenBuf` The buffer for generating IDs.
`(package private) static Logger`	`initLogger` Logger for service re/initialization related messages
`private JoinStateManager`	`joinStateManager`
`private LeaseFactory`	`leaseFactory` `LandLordLeaseFactory` we use to create leases
`private LifeCycle`	`lifeCycle` Cache of our `LifeCycle` object
`protected LoginContext`	`loginContext` The login context, for logging out
`private LogManager`	`logmgr`
`private static long`	`MAX_UNEXPORT_DELAY` Maximum delay for unexport attempts
`(package private) static Logger`	`operationsLogger` Logger for service operation messages
`(package private) static Logger`	`participantLogger` Logger for transaction participant related messages
`private ProxyPreparer`	`participantPreparer` Proxy preparer for listeners
`private String`	`persistenceDirectory`
`(package private) static Logger`	`persistenceLogger` Logger for transaction persistence related messages
`private boolean`	`persistent`
`private ReadyState`	`readyState`
`private TxnManager`	`serverStub` Cache of our inner proxy.
`private java.util.concurrent.ExecutorService`	`settlerpool`
`private WakeupManager`	`settlerWakeupMgr` wakeup manager for `SettlerTask`
`private InterruptedStatusThread`	`settleThread`
`private boolean`	`started`
`(package private) static Logger`	`startupLogger` Logger for (successful) service startup message
`private java.util.concurrent.ExecutorService`	`taskpool`
`private WakeupManager`	`taskWakeupMgr` wakeup manager for `ParticipantTask`
`private Throwable`	`thrown`
`private Uuid`	`topUuid`
`(package private) static Logger`	`transactionsLogger` Logger for transaction related messages (creation, destruction, transition, etc.)
`private LeasePeriodPolicy`	`txnLeasePeriodPolicy`
`private TxnMgrAdminProxy`	`txnMgrAdminProxy` The admin proxy of this server
`private TxnMgrProxy`	`txnMgrProxy` The outer proxy of this server
`private java.util.concurrent.ConcurrentMap<Long,TxnManagerTransaction>`	`txns`
`private Queue<Long>`	`unsettledtxns`

Fields inherited from interface org.apache.river.mahalo.TxnManager
MAHALO

Fields inherited from interface net.jini.core.transaction.server.TransactionConstants
ABORTED, ACTIVE, COMMITTED, NOTCHANGED, PREPARED, VOTING

Fields inherited from interface org.apache.river.constants.TimeConstants
DAYS, HOURS, MINUTES, SECONDS

Constructor Summary

Constructors
Modifier	Constructor and Description
`(package private)`	`TxnManagerImpl(ActivationID activationID, MarshalledObject data)` Constructs an activatable transaction manager.
`private`	`TxnManagerImpl(String[] configArgs, ActivationID activID, boolean persistant, Object[] logMessage)`
`(package private)`	`TxnManagerImpl(String[] args, LifeCycle lc, boolean persistent)` Constructs a non-activatable transaction manager.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`abort(long id)` Abort the transaction.
`private void`	`abort(long id, boolean doExpiryCheck)`
`void`	`abort(long id, long waitFor)` Abort the transaction, waiting for participants to be notified of the decision.
`private void`	`abort(long id, long waitFor, boolean doExpiryCheck)`
`void`	`addLookupAttributes(Entry[] attrSets)` Add attribute sets for the service.
`void`	`addLookupGroups(String[] groups)` Add new groups to the set to join.
`void`	`addLookupLocators(LookupLocator[] locators)` Add locators for specific new lookup services to join.
`private static Entry[]`	`attributesFor()` Create the service owned attributes for an Mahalo server
`void`	`cancel(Uuid uuid)` Cancels the lease on a `Transaction`.
`Map`	`cancelAll(Uuid[] cookies)` Bulk cancel of leases on `Transaction`s.
`private void`	`cleanup()`
`void`	`commit(long id)` Commit the transaction.
`void`	`commit(long id, long waitFor)` Commit the transaction, waiting for participants to be notified of the decision.
`TransactionManager.Created`	`create(long lease)` Begin a new top-level transaction.
`private Uuid`	`createLeaseUuid(long txnId)`
`void`	`destroy()` Cleans up and exits the transaction manager.
`private static boolean`	`ensureCurrent(LeasedResource resource)` Utility method that check for valid resource
`private TxnManagerTransaction`	`enterTMT(long cookie)`
`Object`	`getAdmin()` Returns the administration object for the transaction manager.
`private Long`	`getLeaseTid(Uuid uuid)`
`Entry[]`	`getLookupAttributes()` Get the current attribute sets for the service.
`String[]`	`getLookupGroups()` Get the list of groups to join.
`LookupLocator[]`	`getLookupLocators()` Get the list of locators of specific lookup services to join.
`Object`	`getProxy()` Returns a proxy object for this remote object.
`TrustVerifier`	`getProxyVerifier()` Returns a `TrustVerifier` that can be used to verify that a proxy can be trusted as a proxy for the service; that is, the `isTrustedObject` method of the returned verifier can be called with a candidate proxy.
`Object`	`getServiceProxy()` Returns a proxy object for this object.
`int`	`getState(long id)` Returns the current state of the given transaction.
`Transaction`	`getTransaction(long id)` Method from `TxnManager` which produces a `Transaction` from its ID.
`protected void`	`initFailed(Throwable e)` Log information about failing to initialize the service and rethrow the appropriate exception.
`void`	`join(long id, TransactionParticipant part, long crashCount)` Join a transaction that is managed by this transaction manager.
`TransactionManager`	`manager()` Returns a reference to the `TransactionManager` interface.
`void`	`modifyLookupAttributes(Entry[] attrSetTemplates, Entry[] attrSets)` Modify the current attribute sets, using the same semantics as ServiceRegistration.modifyAttributes.
`(package private) static long`	`nextID()` gets the next available transaction ID.
`void`	`noteUnsettledTxn(long tid)` Informs the transaction manager to attempt to settle a given transaction.
`void`	`recover(long cookie, LogRecord rec)` This method recovers state changes resulting from committing a transaction.
`void`	`removeLookupGroups(String[] groups)` Remove groups from the set to join.
`void`	`removeLookupLocators(LookupLocator[] locators)` Remove locators for specific lookup services from the set to join.
`long`	`renew(Uuid uuid, long extension)` Requests the renewal of a lease on a `Transaction`.
`Landlord.RenewResults`	`renewAll(Uuid[] cookies, long[] extensions)` Bulk renewal request of leases on `Transaction`s.
`private ServerTransaction`	`serverTransaction(Transaction baseTr)`
`void`	`setLookupGroups(String[] groups)` Replace the list of groups to join with a new list.
`void`	`setLookupLocators(LookupLocator[] locators)` Replace the list of locators of specific lookup services to join with a new list.
`private void`	`settleTxns()`
`void`	`start()` Called after construction, this method enables objects to delay starting threads or exporting until after construction is complete, to allow safe publication of the service in accordance with the JMM.
`private void`	`verifyLeaseUuid(Uuid uuid)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - startupLogger
```
static final Logger startupLogger
```
    Logger for (successful) service startup message
  - initLogger
```
static final Logger initLogger
```
    Logger for service re/initialization related messages
  - destroyLogger
```
static final Logger destroyLogger
```
    Logger for service destruction related messages
  - operationsLogger
```
static final Logger operationsLogger
```
    Logger for service operation messages
  - transactionsLogger
```
static final Logger transactionsLogger
```
    Logger for transaction related messages (creation, destruction, transition, etc.)
  - participantLogger
```
static final Logger participantLogger
```
    Logger for transaction participant related messages
  - persistenceLogger
```
static final Logger persistenceLogger
```
    Logger for transaction persistence related messages
  - logmgr
```
private volatile LogManager logmgr
```
  - settlerpool
```
private final java.util.concurrent.ExecutorService settlerpool
```
  - settlerWakeupMgr
```
private final WakeupManager settlerWakeupMgr
```
    wakeup manager for SettlerTask
  - taskpool
```
private final java.util.concurrent.ExecutorService taskpool
```
  - taskWakeupMgr
```
private final WakeupManager taskWakeupMgr
```
    wakeup manager for ParticipantTask
  - txns
```
private final java.util.concurrent.ConcurrentMap<Long,TxnManagerTransaction> txns
```
  - unsettledtxns
```
private final Queue<Long> unsettledtxns
```
  - settleThread
```
private final InterruptedStatusThread settleThread
```
  - persistenceDirectory
```
private final String persistenceDirectory
```
  - activationID
```
private final ActivationID activationID
```
  - activationPrepared
```
private final boolean activationPrepared
```
    Whether the activation ID has been prepared
  - activationSystem
```
private final ActivationSystem activationSystem
```
    The activation system, prepared
  - participantPreparer
```
private volatile ProxyPreparer participantPreparer
```
    Proxy preparer for listeners
  - exporter
```
protected final Exporter exporter
```
    The exporter for exporting and unexporting
  - loginContext
```
protected volatile LoginContext loginContext
```
    The login context, for logging out
  - idGen
```
private static final SecureRandom idGen
```
    The generator for our IDs.
  - idGenBuf
```
private static final byte[] idGenBuf
```
    The buffer for generating IDs.
  - expMgr
```
private volatile LeaseExpirationMgr expMgr
```
    LeaseExpirationMgr used by our LeasePolicy.
  - txnLeasePeriodPolicy
```
private final LeasePeriodPolicy txnLeasePeriodPolicy
```
  - leaseFactory
```
private volatile LeaseFactory leaseFactory
```
    LandLordLeaseFactory we use to create leases
  - joinStateManager
```
private final JoinStateManager joinStateManager
```
  - topUuid
```
private final Uuid topUuid
```
  - txnMgrProxy
```
private volatile TxnMgrProxy txnMgrProxy
```
    The outer proxy of this server
  - txnMgrAdminProxy
```
private volatile TxnMgrAdminProxy txnMgrAdminProxy
```
    The admin proxy of this server
  - serverStub
```
private volatile TxnManager serverStub
```
    Cache of our inner proxy.
  - lifeCycle
```
private volatile LifeCycle lifeCycle
```
    Cache of our LifeCycle object
  - readyState
```
private final ReadyState readyState
```
  - persistent
```
private final boolean persistent
```
  - config
```
private Configuration config
```
  - context
```
private AccessControlContext context
```
  - thrown
```
private Throwable thrown
```
  - started
```
private boolean started
```
  - MAX_UNEXPORT_DELAY
```
private static final long MAX_UNEXPORT_DELAY
```
    Maximum delay for unexport attempts
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TxnManagerImpl
```
TxnManagerImpl(String[] args,
               LifeCycle lc,
               boolean persistent)
```
    Constructs a non-activatable transaction manager.
    
    Parameters:
    
    args - Service configuration options
    
    lc - LifeCycle reference used for callback
  - TxnManagerImpl
```
TxnManagerImpl(ActivationID activationID,
               MarshalledObject data)
        throws IOException,
               ClassNotFoundException
```
    Constructs an activatable transaction manager.
    
    Parameters:
    
    activationID - activation ID passed in by the activation daemon.
    
    data - state data needed to re-activate a transaction manager.
    
    Throws:
    
    IOException
    
    ClassNotFoundException
  - TxnManagerImpl
```
private TxnManagerImpl(String[] configArgs,
                       ActivationID activID,
                       boolean persistant,
                       Object[] logMessage)
```
- Method Detail
  - start
```
public void start()
           throws Exception
```
    Description copied from interface: Startable
    
    Called after construction, this method enables objects to delay starting threads or exporting until after construction is complete, to allow safe publication of the service in accordance with the JMM.
    In addition to starting threads after construction, it also allows objects to avoid throwing an exception during construction to avoid finalizer attacks.
    The implementation is required to ensure start() is idempotent (only executed once, additional invocations must return immediately).
    
    Specified by:
    
    start in interface Startable
    
    Throws:
    
    Exception - if there's a problem with construction or startup.
  - create
```
public TransactionManager.Created create(long lease)
                                  throws LeaseDeniedException
```
    Description copied from interface: TransactionManager
    
    Begin a new top-level transaction.
    
    Specified by:
    
    create in interface TransactionManager
    
    Parameters:
    
    lease - the requested lease time for the transaction
    
    Returns:
    
    the transaction ID and the lease granted
    
    Throws:
    
    LeaseDeniedException - if this manager is unwilling to grant the requested lease time
  - join
```
public void join(long id,
                 TransactionParticipant part,
                 long crashCount)
          throws UnknownTransactionException,
                 CannotJoinException,
                 CrashCountException,
                 RemoteException
```
    Description copied from interface: TransactionManager
    
    Join a transaction that is managed by this transaction manager. The crashCount marks the state of the storage used by the participant for transactions. If the participant attempts to join a transaction more than once, the crash counts must be the same. Each system crash or other event that destroys the state of the participant's unprepared transaction storage must cause the crash count to increase by at least one.
    
    Specified by:
    
    join in interface TransactionManager
    
    Parameters:
    
    id - the transaction ID
    
    part - the participant joining the transaction
    
    crashCount - the participant's current crash count
    
    Throws:
    
    UnknownTransactionException - if the transaction is unknown to the transaction manager, either because the transaction ID is incorrect or because the transaction is complete and its state has been discarded by the manager.
    
    CannotJoinException - if the transaction is known to the manager but is no longer active.
    
    CrashCountException - if the crash count provided for the participant differs from the crash count in a previous invocation of the same pairing of participant and transaction
    
    RemoteException - if there is a communication error
    
    See Also:
    
    ServerTransaction.join(net.jini.core.transaction.server.TransactionParticipant, long)
  - getState
```
public int getState(long id)
             throws UnknownTransactionException
```
    Description copied from interface: TransactionManager
    
    Returns the current state of the given transaction. The returned state can be any of the TransactionConstants values.
    
    Specified by:
    
    getState in interface TransactionManager
    
    Parameters:
    
    id - the transaction ID
    
    Returns:
    
    an int representing the state of the transaction
    
    Throws:
    
    UnknownTransactionException - if the transaction is unknown to the transaction manager, either because the transaction ID is incorrect or because the transaction is complete and its state has been discarded by the manager.
    
    See Also:
    
    ServerTransaction.getState(), TransactionConstants
  - commit
```
public void commit(long id)
            throws UnknownTransactionException,
                   CannotCommitException,
                   RemoteException
```
    Description copied from interface: TransactionManager
    
    Commit the transaction. Commit asks the transaction manager to execute the voting process with the participants. Returns if the transaction successfully reaches either the NOTCHANGED or the COMMITTED state, without waiting for the transaction manager to notify all participants of the decision. If the transaction must be aborted (because one or more participants are unable to prepare), CannotCommitException is thrown without waiting for the transaction manager to notify all participants of the decision.
    
    Specified by:
    
    commit in interface TransactionManager
    
    Parameters:
    
    id - the transaction ID
    
    Throws:
    
    UnknownTransactionException - if the transaction is unknown to the transaction manager, either because the transaction ID is incorrect or because the transaction is complete and its state has been discarded by the manager.
    
    CannotCommitException - if the transaction is being or already has been aborted
    
    RemoteException - if there is a communication error
  - commit
```
public void commit(long id,
                   long waitFor)
            throws UnknownTransactionException,
                   CannotCommitException,
                   TimeoutExpiredException,
                   RemoteException
```
    Description copied from interface: TransactionManager
    
    Commit the transaction, waiting for participants to be notified of the decision. Commit asks the transaction manager to execute the voting process with the participants. Returns if the transaction successfully reaches either the NOTCHANGED or the COMMITTED state, and the transaction manager has notified all participants of the decision, before the specified timeout expires. If the transaction must be aborted (because one or more participants are unable to prepare), CannotCommitException is thrown if the transaction manager is able to notify all participants of the decision before the specified timeout expires. If the transaction manager reaches a decision, but is unable to notify all participants of that decision before the specified timeout expires, then TimeoutExpiredException is thrown. If the specified timeout expires before the transaction manager reaches a decision, TimeoutExpiredException is not thrown until the manager reaches a decision.
    
    Specified by:
    
    commit in interface TransactionManager
    
    Parameters:
    
    id - the transaction ID
    
    waitFor - timeout to wait, from the start of the call until all participants have been notified of the transaction manager's decision
    
    Throws:
    
    UnknownTransactionException - if the transaction is unknown to the transaction manager, either because the transaction ID is incorrect or because the transaction is complete and its state has been discarded by the manager.
    
    CannotCommitException - if the transaction is being or already has been aborted
    
    TimeoutExpiredException - if the transaction manager reaches a decision, but is unable to notify all participants of that decision before the specified timeout expires
    
    RemoteException - if there is a communication error
  - abort
```
public void abort(long id)
           throws UnknownTransactionException,
                  CannotAbortException
```
    Description copied from interface: TransactionManager
    
    Abort the transaction. This can be called at any time by any object holding a reference to the transaction. Abort asks the transaction manager to abort the transaction and to notify each participant of the decision, resulting in them rolling back any state changes made as part of the transaction. Returns as soon as the transaction manager records the abort decision, without waiting for the transaction manager to notify all participants of the decision.
    
    Specified by:
    
    abort in interface TransactionManager
    
    Parameters:
    
    id - the transaction ID
    
    Throws:
    
    UnknownTransactionException - if the transaction is unknown to the transaction manager, either because the transaction ID is incorrect or because the transaction is complete and its state has been discarded by the manager.
    
    CannotAbortException - if the transaction is known to have previously reached the COMMITTED state due to an earlier commit
  - abort
```
private void abort(long id,
                   boolean doExpiryCheck)
            throws UnknownTransactionException,
                   CannotAbortException
```
    Throws:
    
    UnknownTransactionException
    
    CannotAbortException
  - abort
```
public void abort(long id,
                  long waitFor)
           throws UnknownTransactionException,
                  CannotAbortException,
                  TimeoutExpiredException
```
    Description copied from interface: TransactionManager
    
    Abort the transaction, waiting for participants to be notified of the decision. This can be called at any time by any object holding a reference to the transaction. Abort asks the transaction manager to abort the transaction and to notify each participant of the decision, resulting in them rolling back any state changes made as part of the transaction. Returns if the transaction manager records the decision and is able to notify all participants of the decision before the specified timeout expires. If the transaction manager is unable to notify all participants of the decision before the specified timeout expires, then TimeoutExpiredException is thrown.
    
    Specified by:
    
    abort in interface TransactionManager
    
    Parameters:
    
    id - the transaction ID
    
    waitFor - timeout to wait, from the start of the call until all participants have been notified of the transaction manager's decision
    
    Throws:
    
    UnknownTransactionException - if the transaction is unknown to the transaction manager, either because the transaction ID is incorrect or because the transaction is complete and its state has been discarded by the manager.
    
    CannotAbortException - if the transaction is known to have previously reached the COMMITTED state due to an earlier commit
    
    TimeoutExpiredException - if the timeout expires before all participants have been notified
  - abort
```
private void abort(long id,
                   long waitFor,
                   boolean doExpiryCheck)
            throws UnknownTransactionException,
                   CannotAbortException,
                   TimeoutExpiredException
```
    Throws:
    
    UnknownTransactionException
    
    CannotAbortException
    
    TimeoutExpiredException
  - recover
```
public void recover(long cookie,
                    LogRecord rec)
             throws LogException
```
    This method recovers state changes resulting from committing a transaction. This re-creates the internal representation of the transaction.
    
    Specified by:
    
    recover in interface LogRecovery
    
    Parameters:
    
    cookie - the transaction's ID
    
    rec - the LogRecord
    
    Throws:
    
    LogException
  - noteUnsettledTxn
```
public void noteUnsettledTxn(long tid)
```
    Informs the transaction manager to attempt to settle a given transaction.
    
    Specified by:
    
    noteUnsettledTxn in interface TxnSettler
    
    Parameters:
    
    tid - the transaction's ID
  - settleTxns
```
private void settleTxns()
                 throws InterruptedException
```
    Throws:
    
    InterruptedException
  - getTransaction
```
public Transaction getTransaction(long id)
                           throws UnknownTransactionException
```
    Method from TxnManager which produces a Transaction from its ID.
    
    Specified by:
    
    getTransaction in interface TxnManager
    
    Parameters:
    
    id - the ID
    
    Throws:
    
    UnknownTransactionException
    
    See Also:
    
    Transaction, TxnManager
  - renew
```
public long renew(Uuid uuid,
                  long extension)
           throws UnknownLeaseException,
                  LeaseDeniedException
```
    Requests the renewal of a lease on a Transaction.
    
    Specified by:
    
    renew in interface Landlord
    
    Specified by:
    
    renew in interface LocalLandlord
    
    Parameters:
    
    uuid - identifies the leased resource
    
    extension - requested lease extension
    
    Returns:
    
    The new duration the lease should have
    
    Throws:
    
    UnknownLeaseException - if landlord does not know about a lease with the specified cookie
    
    LeaseDeniedException - if the landlord is unwilling to renew the lease
    
    See Also:
    
    Lease, LeasedResource, LeaseManager
  - cancel
```
public void cancel(Uuid uuid)
            throws UnknownLeaseException
```
    Cancels the lease on a Transaction.
    
    Specified by:
    
    cancel in interface Landlord
    
    Specified by:
    
    cancel in interface LocalLandlord
    
    Specified by:
    
    cancel in interface LeaseExpirationMgr.Expirer
    
    Parameters:
    
    uuid - identifies the leased resource
    
    Throws:
    
    UnknownLeaseException - if landlord does not know about a lease with the specified cookie
    
    See Also:
    
    Lease, LeasedResource, LeaseManager
  - renewAll
```
public Landlord.RenewResults renewAll(Uuid[] cookies,
                                      long[] extensions)
```
    Bulk renewal request of leases on Transactions.
    
    Specified by:
    
    renewAll in interface Landlord
    
    Parameters:
    
    cookies - identifies the leased resources
    
    extensions - requested lease extensions
    
    Returns:
    
    A RenewResults object that contains the new duration of each lease that was successfully renewed or the exception encountered for each lease that could not be renewed
    
    See Also:
    
    Lease, LeasedResource, LeaseManager
  - cancelAll
```
public Map cancelAll(Uuid[] cookies)
```
    Bulk cancel of leases on Transactions.
    
    Specified by:
    
    cancelAll in interface Landlord
    
    Parameters:
    
    cookies - identifies the leased resources
    
    Returns:
    
    If all the leases specified in the cookies could be cancelled return null. Otherwise, return a Map that for each failed cancel attempt maps the corresponding cookie object to an exception describing the failure.
    
    See Also:
    
    Lease, LeasedResource, LeaseManager
  - nextID
```
static long nextID()
```
    gets the next available transaction ID.
  - serverTransaction
```
private ServerTransaction serverTransaction(Transaction baseTr)
                                     throws UnknownTransactionException
```
    Throws:
    
    UnknownTransactionException
  - manager
```
public TransactionManager manager()
```
    Returns a reference to the TransactionManager interface.
    
    Specified by:
    
    manager in interface TxnManager
    
    See Also:
    
    TransactionManager
  - enterTMT
```
private TxnManagerTransaction enterTMT(long cookie)
```
  - destroy
```
public void destroy()
```
    Cleans up and exits the transaction manager.
    
    Specified by:
    
    destroy in interface DestroyAdmin
  - getAdmin
```
public Object getAdmin()
```
    Returns the administration object for the transaction manager.
    
    Specified by:
    
    getAdmin in interface Administrable
    
    Returns:
    
    an object that implements whatever administration interfaces are appropriate for the particular service.
    
    See Also:
    
    JoinAdmin
  - getLookupAttributes
```
public Entry[] getLookupAttributes()
```
    Description copied from interface: JoinAdmin
    
    Get the current attribute sets for the service.
    
    Specified by:
    
    getLookupAttributes in interface JoinAdmin
    
    Returns:
    
    the current attribute sets for the service
  - addLookupAttributes
```
public void addLookupAttributes(Entry[] attrSets)
```
    Description copied from interface: JoinAdmin
    
    Add attribute sets for the service. The resulting set will be used for all future joins. The attribute sets are also added to all currently-joined lookup services.
    
    Specified by:
    
    addLookupAttributes in interface JoinAdmin
    
    Parameters:
    
    attrSets - the attribute sets to add
  - modifyLookupAttributes
```
public void modifyLookupAttributes(Entry[] attrSetTemplates,
                                   Entry[] attrSets)
```
    Description copied from interface: JoinAdmin
    
    Modify the current attribute sets, using the same semantics as ServiceRegistration.modifyAttributes. The resulting set will be used for all future joins. The same modifications are also made to all currently-joined lookup services.
    
    Specified by:
    
    modifyLookupAttributes in interface JoinAdmin
    
    Parameters:
    
    attrSetTemplates - the templates for matching attribute sets
    
    attrSets - the modifications to make to matching sets
    
    See Also:
    
    ServiceRegistration.modifyAttributes(net.jini.core.entry.Entry[], net.jini.core.entry.Entry[])
  - getLookupGroups
```
public String[] getLookupGroups()
```
    Description copied from interface: JoinAdmin
    
    Get the list of groups to join. An empty array means the service joins no groups (as opposed to "all" groups).
    
    Specified by:
    
    getLookupGroups in interface JoinAdmin
    
    Returns:
    
    an array of groups to join. An empty array means the service joins no groups (as opposed to "all" groups).
    
    See Also:
    
    JoinAdmin.setLookupGroups(java.lang.String[])
  - addLookupGroups
```
public void addLookupGroups(String[] groups)
```
    Description copied from interface: JoinAdmin
    
    Add new groups to the set to join. Lookup services in the new groups will be discovered and joined.
    
    Specified by:
    
    addLookupGroups in interface JoinAdmin
    
    Parameters:
    
    groups - groups to join
    
    See Also:
    
    JoinAdmin.removeLookupGroups(java.lang.String[])
  - removeLookupGroups
```
public void removeLookupGroups(String[] groups)
```
    Description copied from interface: JoinAdmin
    
    Remove groups from the set to join. Leases are cancelled at lookup services that are not members of any of the remaining groups.
    
    Specified by:
    
    removeLookupGroups in interface JoinAdmin
    
    Parameters:
    
    groups - groups to leave
    
    See Also:
    
    JoinAdmin.addLookupGroups(java.lang.String[])
  - setLookupGroups
```
public void setLookupGroups(String[] groups)
```
    Description copied from interface: JoinAdmin
    
    Replace the list of groups to join with a new list. Leases are cancelled at lookup services that are not members of any of the new groups. Lookup services in the new groups will be discovered and joined.
    
    Specified by:
    
    setLookupGroups in interface JoinAdmin
    
    Parameters:
    
    groups - groups to join
    
    See Also:
    
    JoinAdmin.getLookupGroups()
  - getLookupLocators
```
public LookupLocator[] getLookupLocators()
```
    Description copied from interface: JoinAdmin
    
    Get the list of locators of specific lookup services to join.
    
    Specified by:
    
    getLookupLocators in interface JoinAdmin
    
    Returns:
    
    the list of locators of specific lookup services to join
    
    See Also:
    
    JoinAdmin.setLookupLocators(net.jini.core.discovery.LookupLocator[])
  - addLookupLocators
```
public void addLookupLocators(LookupLocator[] locators)
                       throws RemoteException
```
    Description copied from interface: JoinAdmin
    
    Add locators for specific new lookup services to join. The new lookup services will be discovered and joined.
    
    Specified by:
    
    addLookupLocators in interface JoinAdmin
    
    Parameters:
    
    locators - locators of specific lookup services to join
    
    Throws:
    
    RemoteException
    
    See Also:
    
    JoinAdmin.removeLookupLocators(net.jini.core.discovery.LookupLocator[])
  - removeLookupLocators
```
public void removeLookupLocators(LookupLocator[] locators)
                          throws RemoteException
```
    Description copied from interface: JoinAdmin
    
    Remove locators for specific lookup services from the set to join. Any leases held at the lookup services are cancelled.
    
    Specified by:
    
    removeLookupLocators in interface JoinAdmin
    
    Parameters:
    
    locators - locators of specific lookup services to leave
    
    Throws:
    
    RemoteException
    
    See Also:
    
    JoinAdmin.addLookupLocators(net.jini.core.discovery.LookupLocator[])
  - setLookupLocators
```
public void setLookupLocators(LookupLocator[] locators)
                       throws RemoteException
```
    Description copied from interface: JoinAdmin
    
    Replace the list of locators of specific lookup services to join with a new list. Leases are cancelled at lookup services that were in the old list but are not in the new list. Any new lookup services will be discovered and joined.
    
    Specified by:
    
    setLookupLocators in interface JoinAdmin
    
    Parameters:
    
    locators - locators of specific lookup services to join
    
    Throws:
    
    RemoteException
    
    See Also:
    
    JoinAdmin.getLookupLocators()
  - attributesFor
```
private static Entry[] attributesFor()
```
    Create the service owned attributes for an Mahalo server
  - getProxy
```
public Object getProxy()
```
    Description copied from interface: ProxyAccessor
    
    Returns a proxy object for this remote object. If this remote object is not exported (and hence, no proxy is available), then null is returned.
    
    Specified by:
    
    getProxy in interface ProxyAccessor
    
    Returns:
    
    a proxy, or null
  - getServiceProxy
```
public Object getServiceProxy()
```
    Description copied from interface: ServiceProxyAccessor
    
    Returns a proxy object for this object. This value should not be null.
    
    Specified by:
    
    getServiceProxy in interface ServiceProxyAccessor
    
    Returns:
    
    a proxy object reference
  - initFailed
```
protected void initFailed(Throwable e)
                   throws Exception
```
    Log information about failing to initialize the service and rethrow the appropriate exception.
    
    Parameters:
    
    e - the exception produced by the failure
    
    Throws:
    
    Exception
  - cleanup
```
private void cleanup()
```
  - getProxyVerifier
```
public TrustVerifier getProxyVerifier()
```
    Description copied from interface: ServerProxyTrust
    
    Returns a TrustVerifier that can be used to verify that a proxy can be trusted as a proxy for the service; that is, the isTrustedObject method of the returned verifier can be called with a candidate proxy. The verifier should be able to verify all proxies for the service, including proxies for resources (such as leases and registrations).
    
    Specified by:
    
    getProxyVerifier in interface ServerProxyTrust
    
    Returns:
    
    a TrustVerifier that can be used to verify that a proxy can be trusted as a proxy for the service
  - ensureCurrent
```
private static boolean ensureCurrent(LeasedResource resource)
```
    Utility method that check for valid resource
  - createLeaseUuid
```
private Uuid createLeaseUuid(long txnId)
```
  - verifyLeaseUuid
```
private void verifyLeaseUuid(Uuid uuid)
                      throws UnknownLeaseException
```
    Throws:
    
    UnknownLeaseException
  - getLeaseTid
```
private Long getLeaseTid(Uuid uuid)
```

Class TxnManagerImpl

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.river.landlord.Landlord

Nested classes/interfaces inherited from interface net.jini.core.transaction.server.TransactionManager

Field Summary

Fields inherited from interface org.apache.river.mahalo.TxnManager

Fields inherited from interface net.jini.core.transaction.server.TransactionConstants

Fields inherited from interface org.apache.river.constants.TimeConstants

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

startupLogger

initLogger

destroyLogger

operationsLogger

transactionsLogger

participantLogger

persistenceLogger

logmgr

settlerpool

settlerWakeupMgr

taskpool

taskWakeupMgr

txns

unsettledtxns

settleThread

persistenceDirectory

activationID

activationPrepared

activationSystem

participantPreparer

exporter

loginContext

idGen

idGenBuf

expMgr

txnLeasePeriodPolicy

leaseFactory

joinStateManager

topUuid

txnMgrProxy

txnMgrAdminProxy

serverStub

lifeCycle

readyState

persistent

config

context

thrown

started

MAX_UNEXPORT_DELAY

Constructor Detail

TxnManagerImpl

TxnManagerImpl

TxnManagerImpl

Method Detail

start

create

join

getState

commit

commit

abort

abort

abort

abort

recover

noteUnsettledTxn

settleTxns

getTransaction

renew

cancel

renewAll

cancelAll

nextID

serverTransaction

manager

enterTMT

destroy