ActivationInstantiator (Java 2 Platform SE v1.4.1_"07")

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.rmi.activation
Interface ActivationInstantiator

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
`MarshalledObject` | `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

    public MarshalledObject 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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.