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
|