java.rmi.activation

Interface ActivationMonitor

All Superinterfaces:
Remote
Known Implementing Classes:
ActivationSystemTransient

public interface ActivationMonitor
extends Remote

The activation and inactivation event listener. The group obtains this listener via ActivationSystem.activeGroup(ActivationGroupID,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, 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 Details

activeObject

public void activeObject(ActivationID id,
                         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

inactiveGroup

public 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

inactiveObject

public 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

ActivationMonitor.java -- the RMI activation/inactivation event listener Copyright (c) 1996, 1997, 1998, 1999, 2004, 2006 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath 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 for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.