java.rmi.activation
Class ActivationGroupDesc

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.rmi.activation.ActivationGroupDesc
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable

public final class ActivationGroupDesc
extends Object sample code for java.lang.Object definition code for java.lang.Object
implements Serializable sample code for java.io.Serializable definition code for java.io.Serializable

An activation group descriptor contains the information necessary to create/recreate an activation group in which to activate objects. Such a descriptor contains:

The group's class must be a concrete subclass of ActivationGroup. A subclass of ActivationGroup is created/recreated via the ActivationGroup.createGroup static method that invokes a special constructor that takes two arguments:

Since:
1.2
See Also:
ActivationGroup sample code for java.rmi.activation.ActivationGroup definition code for java.rmi.activation.ActivationGroup , ActivationGroupID sample code for java.rmi.activation.ActivationGroupID definition code for java.rmi.activation.ActivationGroupID , Serialized Form

Nested Class Summary
static class ActivationGroupDesc.CommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment definition code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment
          Startup options for ActivationGroup implementations.
 
Constructor Summary
ActivationGroupDesc sample code for java.rmi.activation.ActivationGroupDesc.ActivationGroupDesc(java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment) definition code for java.rmi.activation.ActivationGroupDesc.ActivationGroupDesc(java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment) (Properties sample code for java.util.Properties definition code for java.util.Properties  overrides, ActivationGroupDesc.CommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment definition code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment  cmd)
          Constructs a group descriptor that uses the system defaults for group implementation and code location.
ActivationGroupDesc sample code for java.rmi.activation.ActivationGroupDesc.ActivationGroupDesc(java.lang.String, java.lang.String, java.rmi.MarshalledObject, java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment) definition code for java.rmi.activation.ActivationGroupDesc.ActivationGroupDesc(java.lang.String, java.lang.String, java.rmi.MarshalledObject, java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment) (String sample code for java.lang.String definition code for java.lang.String  className, String sample code for java.lang.String definition code for java.lang.String  location, MarshalledObject sample code for java.rmi.MarshalledObject definition code for java.rmi.MarshalledObject  data, Properties sample code for java.util.Properties definition code for java.util.Properties  overrides, ActivationGroupDesc.CommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment definition code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment  cmd)
          Specifies an alternate group implementation and execution environment to be used for the group.
 
Method Summary
 boolean equals sample code for java.rmi.activation.ActivationGroupDesc.equals(java.lang.Object) definition code for java.rmi.activation.ActivationGroupDesc.equals(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  obj)
          Compares two activation group descriptors for content equality.
 String sample code for java.lang.String definition code for java.lang.String getClassName sample code for java.rmi.activation.ActivationGroupDesc.getClassName() definition code for java.rmi.activation.ActivationGroupDesc.getClassName() ()
          Returns the group's class name (possibly null).
 ActivationGroupDesc.CommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment definition code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment getCommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.getCommandEnvironment() definition code for java.rmi.activation.ActivationGroupDesc.getCommandEnvironment() ()
          Returns the group's command-environment control object.
 MarshalledObject sample code for java.rmi.MarshalledObject definition code for java.rmi.MarshalledObject getData sample code for java.rmi.activation.ActivationGroupDesc.getData() definition code for java.rmi.activation.ActivationGroupDesc.getData() ()
          Returns the group's initialization data.
 String sample code for java.lang.String definition code for java.lang.String getLocation sample code for java.rmi.activation.ActivationGroupDesc.getLocation() definition code for java.rmi.activation.ActivationGroupDesc.getLocation() ()
          Returns the group's code location.
 Properties sample code for java.util.Properties definition code for java.util.Properties getPropertyOverrides sample code for java.rmi.activation.ActivationGroupDesc.getPropertyOverrides() definition code for java.rmi.activation.ActivationGroupDesc.getPropertyOverrides() ()
          Returns the group's property-override list.
 int hashCode sample code for java.rmi.activation.ActivationGroupDesc.hashCode() definition code for java.rmi.activation.ActivationGroupDesc.hashCode() ()
          Produce identical numbers for similar ActivationGroupDescs.
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , toString sample code for java.lang.Object.toString() definition code for java.lang.Object.toString() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Constructor Detail

ActivationGroupDesc sample code for java.rmi.activation.ActivationGroupDesc(java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment) definition code for java.rmi.activation.ActivationGroupDesc(java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment)

public ActivationGroupDesc(Properties sample code for java.util.Properties definition code for java.util.Properties  overrides,
                           ActivationGroupDesc.CommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment definition code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment  cmd)
Constructs a group descriptor that uses the system defaults for group implementation and code location. Properties specify Java environment overrides (which will override system properties in the group implementation's VM). The command environment can control the exact command/options used in starting the child VM, or can be null to accept rmid's default.

This constructor will create an ActivationGroupDesc with a null group class name, which indicates the system's default ActivationGroup implementation.

Parameters:
overrides - the set of properties to set when the group is recreated.
cmd - the controlling options for executing the VM in another process (or null).
Since:
1.2

ActivationGroupDesc sample code for java.rmi.activation.ActivationGroupDesc(java.lang.String, java.lang.String, java.rmi.MarshalledObject, java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment) definition code for java.rmi.activation.ActivationGroupDesc(java.lang.String, java.lang.String, java.rmi.MarshalledObject, java.util.Properties, java.rmi.activation.ActivationGroupDesc.CommandEnvironment)

public ActivationGroupDesc(String sample code for java.lang.String definition code for java.lang.String  className,
                           String sample code for java.lang.String definition code for java.lang.String  location,
                           MarshalledObject sample code for java.rmi.MarshalledObject definition code for java.rmi.MarshalledObject  data,
                           Properties sample code for java.util.Properties definition code for java.util.Properties  overrides,
                           ActivationGroupDesc.CommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment definition code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment  cmd)
Specifies an alternate group implementation and execution environment to be used for the group.

Parameters:
className - the group's package qualified class name or null. A null group class name indicates the system's default ActivationGroup implementation.
location - the location from where to load the group's class
data - the group's initialization data contained in marshalled form (could contain properties, for example)
overrides - a properties map which will override those set by default in the subprocess environment (will be translated into -D options), or null.
cmd - the controlling options for executing the VM in another process (or null).
Since:
1.2
Method Detail

getClassName sample code for java.rmi.activation.ActivationGroupDesc.getClassName() definition code for java.rmi.activation.ActivationGroupDesc.getClassName()

public String sample code for java.lang.String definition code for java.lang.String  getClassName()
Returns the group's class name (possibly null). A null group class name indicates the system's default ActivationGroup implementation.

Returns:
the group's class name
Since:
1.2

getLocation sample code for java.rmi.activation.ActivationGroupDesc.getLocation() definition code for java.rmi.activation.ActivationGroupDesc.getLocation()

public String sample code for java.lang.String definition code for java.lang.String  getLocation()
Returns the group's code location.

Returns:
the group's code location
Since:
1.2

getData sample code for java.rmi.activation.ActivationGroupDesc.getData() definition code for java.rmi.activation.ActivationGroupDesc.getData()

public MarshalledObject sample code for java.rmi.MarshalledObject definition code for java.rmi.MarshalledObject  getData()
Returns the group's initialization data.

Returns:
the group's initialization data
Since:
1.2

getPropertyOverrides sample code for java.rmi.activation.ActivationGroupDesc.getPropertyOverrides() definition code for java.rmi.activation.ActivationGroupDesc.getPropertyOverrides()

public Properties sample code for java.util.Properties definition code for java.util.Properties  getPropertyOverrides()
Returns the group's property-override list.

Returns:
the property-override list, or null
Since:
1.2

getCommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.getCommandEnvironment() definition code for java.rmi.activation.ActivationGroupDesc.getCommandEnvironment()

public ActivationGroupDesc.CommandEnvironment sample code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment definition code for java.rmi.activation.ActivationGroupDesc.CommandEnvironment  getCommandEnvironment()
Returns the group's command-environment control object.

Returns:
the command-environment object, or null
Since:
1.2

equals sample code for java.rmi.activation.ActivationGroupDesc.equals(java.lang.Object) definition code for java.rmi.activation.ActivationGroupDesc.equals(java.lang.Object)

public boolean equals(Object sample code for java.lang.Object definition code for java.lang.Object  obj)
Compares two activation group descriptors for content equality.

Overrides:
equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) in class Object sample code for java.lang.Object definition code for java.lang.Object
Parameters:
obj - the Object to compare with
Returns:
true if these Objects are equal; false otherwise.
Since:
1.2
See Also:
Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable

hashCode sample code for java.rmi.activation.ActivationGroupDesc.hashCode() definition code for java.rmi.activation.ActivationGroupDesc.hashCode()

public int hashCode()
Produce identical numbers for similar ActivationGroupDescs.

Overrides:
hashCode sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() in class Object sample code for java.lang.Object definition code for java.lang.Object
Returns:
an integer
See Also:
Hashtable sample code for java.util.Hashtable definition code for java.util.Hashtable