Class ActivationSystemTransient

protected final Map<K,V> activatedObjects

The cache of the activated objects, maps activation ids to remote object stubs.

public static boolean debug

Set to true to print the event messages to console.

protected final BidiTable descriptions

Maps object identifiers into object activation descriptions

protected final BidiTable groupDescs

Maps group identifiers into group descriptions.

protected final Map<K,V> groupInstantiators

Maps group identifiers into already activated groups.

protected ActivationSystemTransient()

Creates the group with transient maps.

protected ActivationSystemTransient(BidiTable objectDescriptions,
                                    BidiTable groupDescriptiopns)

Creates the group which uses the given maps to store the data.

public MarshalledObject<T> activate(ActivationID id,
                                 boolean force)
            throws ActivationException,
                   UnknownObjectException,
                   RemoteException

Activate the given object (try cache first if force = false)

public ActivationMonitor activeGroup(ActivationGroupID id,
                                     ActivationInstantiator group,
                                     long incarnation)
            throws UnknownGroupException,
                   ActivationException,
                   RemoteException

Returns the activation monitor (THIS) and remebers the instantiator, used by that group.

Specified by:

activeGroup in interface ActivationSystem

public void activeObject(ActivationID id,
                         MarshalledObject<T> obj)
            throws UnknownObjectException,
                   RemoteException

Put the object into active object map.

public ActivationDesc getActivationDesc(ActivationID id)
            throws ActivationException,
                   UnknownObjectException,
                   RemoteException

Get the activation descriptor for the given activation id.

Specified by:

getActivationDesc in interface ActivationSystem

Returns:

the activation descriptor, never null.

Throws:

UnknownObjectException - if such object is unknown.

public ActivationGroupDesc getActivationGroupDesc(ActivationGroupID groupId)
            throws ActivationException,
                   UnknownGroupException,
                   RemoteException

Get the descriptor of the given activation group.

Specified by:

getActivationGroupDesc in interface ActivationSystem

Returns:

the activation group descriptor, never null.

Throws:

UnknownGroupException - if such group is unknown

public static ActivationSystem getInstance()

public void inactiveGroup(ActivationGroupID groupId,
                          long incarnation)
            throws UnknownGroupException,
                   RemoteException

Check if the group is known. Remove all active objects, belonging to that group, from the active object cache.

Specified by:

inactiveGroup in interface ActivationMonitor

public void inactiveObject(ActivationID id)
            throws UnknownObjectException,
                   RemoteException

Removes this id from the active object cache.

Specified by:

inactiveObject in interface ActivationMonitor

public ActivationGroupID registerGroup(ActivationGroupDesc groupDesc)
            throws ActivationException,
                   RemoteException

Create the activation group id and put this id-descriptor combination into the group map. The new ID will only be created if this description has not already been registered, otherwise the id of the registered description will be returned.

Specified by:

registerGroup in interface ActivationSystem

public ActivationID registerObject(ActivationDesc desc)
            throws ActivationException,
                   UnknownGroupException,
                   RemoteException

Create the object activation id and put this id-descriptor combination into the group map. The new ID will only be created if this description has not already been registered, otherwise the id of the registered description will be returned.

Specified by:

registerObject in interface ActivationSystem

public ActivationDesc setActivationDesc(ActivationID id,
                                        ActivationDesc desc)
            throws ActivationException,
                   UnknownObjectException,
                   UnknownGroupException,
                   RemoteException

Replace the activation descriptor, return the previous descriptor.

Specified by:

setActivationDesc in interface ActivationSystem

public ActivationGroupDesc setActivationGroupDesc(ActivationGroupID groupId,
                                                  ActivationGroupDesc groupDesc)
            throws ActivationException,
                   UnknownGroupException,
                   RemoteException

Replace the activation group descriptor, return the previous descriptor.

Specified by:

setActivationGroupDesc in interface ActivationSystem

public void shutdown()
            throws RemoteException

Calls .shutdown on all bidirectional tables (has no effect if these table are not persistent).

Specified by:

shutdown in interface ActivationSystem

public void unregisterGroup(ActivationGroupID groupId)
            throws ActivationException,
                   UnknownGroupException,
                   RemoteException

Remove the group from the group map

Specified by:

unregisterGroup in interface ActivationSystem

public void unregisterObject(ActivationID id)
            throws ActivationException,
                   UnknownObjectException,
                   RemoteException

Remove the object id from the active object and description maps.

Specified by:

unregisterObject in interface ActivationSystem