java.rmi.activation
Interface ActivationMonitor

All Superinterfaces:
Remote

public interface ActivationMonitor
extends Remote

The activation and inactivation event listener. The group obtains this listener via ActivationSystem.activeGroup(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationInstantiator, long) and must notify it when the group objects are activated or inactivated and also when the whole group becomes inactive.


Method Summary
 void activeObject(ActivationID id, MarshalledObject<? extends Remote> obj)
          Informs that the object is now active.
 void inactiveGroup(ActivationGroupID groupId, long incarnation)
          Informs that the whole group is now inactive because all group objects are inactive.
 void inactiveObject(ActivationID id)
          Informs that the object is not inactive.
 

Method Detail

activeObject

void activeObject(ActivationID id,
                  MarshalledObject<? extends Remote> obj)
                  throws UnknownObjectException,
                         RemoteException
Informs that the object is now active.

Parameters:
id - the activation id of the object that is now active
Throws:
UnknownObjectException - is such object is not known in this group
RemoteException - if remote call fails

inactiveObject

void inactiveObject(ActivationID id)
                    throws UnknownObjectException,
                           RemoteException
Informs that the object is not inactive.

Parameters:
id - the activation id of the object that is now inactive
Throws:
UnknownObjectException - is such object is not known in this group
RemoteException - if remote call fails

inactiveGroup

void inactiveGroup(ActivationGroupID groupId,
                   long incarnation)
                   throws UnknownGroupException,
                          RemoteException
Informs that the whole group is now inactive because all group objects are inactive. The group will be recreated upon the later request to activate any object, belonging to the group.

Parameters:
groupId - the group id
incarnation - the group incarnation number
Throws:
UnknownGroupException - if the group id is not known
RemoteException - if the remote call fails