ActivationInstantiator (Java Platform SE 7 b138)

All Superinterfaces:

Remote

All Known Implementing Classes:

ActivationGroup, ActivationGroup_Stub
```
public interface ActivationInstantiator
extends Remote
```
An ActivationInstantiator is responsible for creating instances of "activatable" objects. A concrete subclass of ActivationGroup implements the newInstance method to handle creating objects within the group.

Since:

1.2

See Also:
ActivationGroup

Method Summary

Methods
Modifier and Type	Method and Description
`MarshalledObject<? extends Remote>`	`newInstance(ActivationID id, ActivationDesc desc)` The activator calls an instantiator's `newInstance` method in order to recreate in that group an object with the activation identifier, `id`, and descriptor, `desc`.

- Method Detail
  - newInstance
```
MarshalledObject<? extends Remote> newInstance(ActivationID id,
                                             ActivationDesc desc)
                                               throws ActivationException,
                                                      RemoteException
```
    The activator calls an instantiator's newInstance method in order to recreate in that group an object with the activation identifier, id, and descriptor, desc. The instantiator is responsible for:
    - determining the class for the object using the descriptor's getClassName method,
    - loading the class from the code location obtained from the descriptor (using the getLocation method),
    - creating an instance of the class by invoking the special "activation" constructor of the object's class that takes two arguments: the object's ActivationID, and the MarshalledObject containing object specific initialization data, and
    - returning a MarshalledObject containing the stub for the remote object it created
    Parameters:
    id - the object's activation identifier
    desc - the object's descriptor
    
    Returns:
    a marshalled object containing the serialized representation of remote object's stub
    
    Throws:
    
    ActivationException - if object activation fails
    
    RemoteException - if remote call fails
    Since:
    
    1.2

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138

Interface ActivationInstantiator

Method Summary

Method Detail

newInstance