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

Methods

Modifier and Type	Method and Description
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