java.rmi.activation

Interface ActivationInstantiator

All Superinterfaces:

Remote

All Known Implementing Classes:

ActivationGroup, ActivationGroup_Stub

public interface ActivationInstantiator
extends Remote

The implementation of this interface creates (instantiates) the new remote objects in response to the activation request. The instantiator is returned by the ActivationGroup that calls ActivationSystem.activeGroup(ActivationGroupID, ActivationInstantiator, long).

Method Summary

Methods

Modifier and Type	Method and Description
MarshalledObject<? extends Remote>	newInstance(ActivationID id, ActivationDesc desc) Creates and instantiate a new remote object.

Method Detail

newInstance

MarshalledObject<? extends Remote> newInstance(ActivationID id,
                                             ActivationDesc desc)
                                               throws ActivationException,
                                                      RemoteException

Creates and instantiate a new remote object. This method performs the following tasks:

• Finds and loads (if not already loaded) the class of the object being instantiated
• Creates an instance of the object using its special two parameter activation constructor, the first parameter being the ActivationID and the second the MarshalledObject.

Parameters:

id - the id of the object being instantiated

desc - the activation descriptor being instantiated

Returns:

the MarshalledObject, containing the stub to the newly created object.

Throws:

ActivationException - if the activation fails

RemoteException - if the remote call fails