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

MarshalledObject

newInstance(ActivationID id, ActivationDesc desc) Creates and instantiate a new remote object.

Method Detail

newInstance

MarshalledObject 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