109 lines
4.5 KiB
Java
109 lines
4.5 KiB
Java
/*
|
|
* Copyright (c) 1997, 2005, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation. Oracle designates this
|
|
* particular file as subject to the "Classpath" exception as provided
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
package java.rmi.activation;
|
|
|
|
import java.rmi.MarshalledObject;
|
|
import java.rmi.Remote;
|
|
import java.rmi.RemoteException;
|
|
import java.rmi.activation.UnknownGroupException;
|
|
import java.rmi.activation.UnknownObjectException;
|
|
|
|
/**
|
|
* An <code>ActivationMonitor</code> is specific to an
|
|
* <code>ActivationGroup</code> and is obtained when a group is
|
|
* reported active via a call to
|
|
* <code>ActivationSystem.activeGroup</code> (this is done
|
|
* internally). An activation group is responsible for informing its
|
|
* <code>ActivationMonitor</code> when either: its objects become active or
|
|
* inactive, or the group as a whole becomes inactive.
|
|
*
|
|
* @author Ann Wollrath
|
|
* @see Activator
|
|
* @see ActivationSystem
|
|
* @see ActivationGroup
|
|
* @since 1.2
|
|
*/
|
|
public interface ActivationMonitor extends Remote {
|
|
|
|
/**
|
|
* An activation group calls its monitor's
|
|
* <code>inactiveObject</code> method when an object in its group
|
|
* becomes inactive (deactivates). An activation group discovers
|
|
* that an object (that it participated in activating) in its VM
|
|
* is no longer active, via calls to the activation group's
|
|
* <code>inactiveObject</code> method. <p>
|
|
*
|
|
* The <code>inactiveObject</code> call informs the
|
|
* <code>ActivationMonitor</code> that the remote object reference
|
|
* it holds for the object with the activation identifier,
|
|
* <code>id</code>, is no longer valid. The monitor considers the
|
|
* reference associated with <code>id</code> as a stale reference.
|
|
* Since the reference is considered stale, a subsequent
|
|
* <code>activate</code> call for the same activation identifier
|
|
* results in re-activating the remote object.<p>
|
|
*
|
|
* @param id the object's activation identifier
|
|
* @exception UnknownObjectException if object is unknown
|
|
* @exception RemoteException if remote call fails
|
|
* @since 1.2
|
|
*/
|
|
public void inactiveObject(ActivationID id)
|
|
throws UnknownObjectException, RemoteException;
|
|
|
|
/**
|
|
* Informs that an object is now active. An <code>ActivationGroup</code>
|
|
* informs its monitor if an object in its group becomes active by
|
|
* other means than being activated directly (i.e., the object
|
|
* is registered and "activated" itself).
|
|
*
|
|
* @param id the active object's id
|
|
* @param obj the marshalled form of the object's stub
|
|
* @exception UnknownObjectException if object is unknown
|
|
* @exception RemoteException if remote call fails
|
|
* @since 1.2
|
|
*/
|
|
public void activeObject(ActivationID id,
|
|
MarshalledObject<? extends Remote> obj)
|
|
throws UnknownObjectException, RemoteException;
|
|
|
|
/**
|
|
* Informs that the group is now inactive. The group will be
|
|
* recreated upon a subsequent request to activate an object
|
|
* within the group. A group becomes inactive when all objects
|
|
* in the group report that they are inactive.
|
|
*
|
|
* @param id the group's id
|
|
* @param incarnation the group's incarnation number
|
|
* @exception UnknownGroupException if group is unknown
|
|
* @exception RemoteException if remote call fails
|
|
* @since 1.2
|
|
*/
|
|
public void inactiveGroup(ActivationGroupID id,
|
|
long incarnation)
|
|
throws UnknownGroupException, RemoteException;
|
|
|
|
}
|