src/share/classes/java/rmi/activation/ActivationMonitor.java

Print this page




  46  * @see         ActivationGroup
  47  * @since       1.2
  48  */
  49 public interface ActivationMonitor extends Remote {
  50 
  51    /**
  52      * An activation group calls its monitor's
  53      * <code>inactiveObject</code> method when an object in its group
  54      * becomes inactive (deactivates).  An activation group discovers
  55      * that an object (that it participated in activating) in its VM
  56      * is no longer active, via calls to the activation group's
  57      * <code>inactiveObject</code> method. <p>
  58      *
  59      * The <code>inactiveObject</code> call informs the
  60      * <code>ActivationMonitor</code> that the remote object reference
  61      * it holds for the object with the activation identifier,
  62      * <code>id</code>, is no longer valid. The monitor considers the
  63      * reference associated with <code>id</code> as a stale reference.
  64      * Since the reference is considered stale, a subsequent
  65      * <code>activate</code> call for the same activation identifier
  66      * results in re-activating the remote object.<p>
  67      *
  68      * @param id the object's activation identifier
  69      * @exception UnknownObjectException if object is unknown
  70      * @exception RemoteException if remote call fails
  71      * @since 1.2
  72      */
  73     public void inactiveObject(ActivationID id)
  74         throws UnknownObjectException, RemoteException;
  75 
  76     /**
  77      * Informs that an object is now active. An <code>ActivationGroup</code>
  78      * informs its monitor if an object in its group becomes active by
  79      * other means than being activated directly (i.e., the object
  80      * is registered and "activated" itself).
  81      *
  82      * @param id the active object's id
  83      * @param obj the marshalled form of the object's stub
  84      * @exception UnknownObjectException if object is unknown
  85      * @exception RemoteException if remote call fails
  86      * @since 1.2




  46  * @see         ActivationGroup
  47  * @since       1.2
  48  */
  49 public interface ActivationMonitor extends Remote {
  50 
  51    /**
  52      * An activation group calls its monitor's
  53      * <code>inactiveObject</code> method when an object in its group
  54      * becomes inactive (deactivates).  An activation group discovers
  55      * that an object (that it participated in activating) in its VM
  56      * is no longer active, via calls to the activation group's
  57      * <code>inactiveObject</code> method. <p>
  58      *
  59      * The <code>inactiveObject</code> call informs the
  60      * <code>ActivationMonitor</code> that the remote object reference
  61      * it holds for the object with the activation identifier,
  62      * <code>id</code>, is no longer valid. The monitor considers the
  63      * reference associated with <code>id</code> as a stale reference.
  64      * Since the reference is considered stale, a subsequent
  65      * <code>activate</code> call for the same activation identifier
  66      * results in re-activating the remote object.
  67      *
  68      * @param id the object's activation identifier
  69      * @exception UnknownObjectException if object is unknown
  70      * @exception RemoteException if remote call fails
  71      * @since 1.2
  72      */
  73     public void inactiveObject(ActivationID id)
  74         throws UnknownObjectException, RemoteException;
  75 
  76     /**
  77      * Informs that an object is now active. An <code>ActivationGroup</code>
  78      * informs its monitor if an object in its group becomes active by
  79      * other means than being activated directly (i.e., the object
  80      * is registered and "activated" itself).
  81      *
  82      * @param id the active object's id
  83      * @param obj the marshalled form of the object's stub
  84      * @exception UnknownObjectException if object is unknown
  85      * @exception RemoteException if remote call fails
  86      * @since 1.2