org.apache.river.start.group

Interface SharedGroup

All Superinterfaces:

Remote

public interface SharedGroup
extends Remote

The service starter supported interface for shared group objects. Shared group objects are used to destroy the VM in which they are placed.

Author:

Sun Microsystems, Inc.

Method Summary

Modifier and Type	Method and Description
void	destroyVM() Cause the hosting VM to exit.

Method Detail

destroyVM

void destroyVM()
        throws RemoteException,
               ActivationException

Cause the hosting VM to exit. This method should (in effect) spawn a separate thread to do the actual work asynchronously, and make a reasonable attempt to let this remote call return successfully. As such, a successful return from this method does not mean that the VM has been destroyed. Although the service should make a reasonable attempt to let this remote call return successfully, the service must not wait indefinitely for other (in-progress and subsequent) remote calls to finish before proceeding to destroy its hosting VM. Once this method has been called, the service can, but need not, reject all other (in-progress and subsequent) remote calls to the service.

Throws:

RemoteException - if there was a problem communicating with the shared group object

ActivationException - if there was a problem creating an activatable shared group instance