java.rmi.activation
Class ActivationGroupDesc

java.lang.Object
  extended by java.rmi.activation.ActivationGroupDesc
All Implemented Interfaces:
Serializable

public final class ActivationGroupDesc
extends Object
implements Serializable

Contains information, necessary to create of recreate the activation objects. The group descriptor contains:

The groups are created by the ActivationGroup.createGroup(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc, long) method that expectes the group class to have the two parameter constructor, the first parameter being the ActivationGroupID and the second the MarshalledObject.

See Also:
Serialized Form

Nested Class Summary
static class ActivationGroupDesc.CommandEnvironment
          Contains the startup options for the ActivationGroup implementations.
 
Constructor Summary
ActivationGroupDesc(Properties aProperties, ActivationGroupDesc.CommandEnvironment environment)
          Create the new activation group descriptor that will use the default activation group implementation with the given properties and environment.
ActivationGroupDesc(String aClassName, String aLocation, MarshalledObject<?> aData, Properties aProperties, ActivationGroupDesc.CommandEnvironment environment)
          Create the new activation group descriptor.
 
Method Summary
 boolean equals(Object obj)
          Compare for the content equality.
 String getClassName()
          Get the activation group class name.
 ActivationGroupDesc.CommandEnvironment getCommandEnvironment()
          Get the group command environment, containing path to the jre executable and startup options.
 MarshalledObject<?> getData()
          Get the group intialization data.
 String getLocation()
          Get the location, from where the group class will be loaded
 Properties getPropertyOverrides()
          Get the overridded system properties.
 int hashCode()
          Return the hashcode.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ActivationGroupDesc

public ActivationGroupDesc(Properties aProperties,
                           ActivationGroupDesc.CommandEnvironment environment)
Create the new activation group descriptor that will use the default activation group implementation with the given properties and environment.

Parameters:
aProperties - the properties that override the system properties
environment - the command line (and parameters), indicating, where to find the jre executable and with that parameters to call it. May be null if the default executable should be used. In this case, the activation group with the null name (the system default group) will be created.

ActivationGroupDesc

public ActivationGroupDesc(String aClassName,
                           String aLocation,
                           MarshalledObject<?> aData,
                           Properties aProperties,
                           ActivationGroupDesc.CommandEnvironment environment)
Create the new activation group descriptor.

Parameters:
aClassName - the name of the group implementation class. The null value indicates the default implementation.
aLocation - the location, from where the group implementation class should be loaded (ignored for the system default implementation).
aData - the group intialization data
aProperties - the properties that will override the system properties of the new group. These properties will be translated into -D options.
environment - the record, containing path to the jre executable and start options for the jre or null for using the default jre and options.
Method Detail

getClassName

public String getClassName()
Get the activation group class name.

Returns:
the activation group class name (null for default implementation)

getLocation

public String getLocation()
Get the location, from where the group class will be loaded

Returns:
the location, from where the implementation should be loaded (null for the default implementation)

getData

public MarshalledObject<?> getData()
Get the group intialization data.

Returns:
the group intialization data in the marshalled form.

getPropertyOverrides

public Properties getPropertyOverrides()
Get the overridded system properties.

Returns:
the overridden group system properties.

getCommandEnvironment

public ActivationGroupDesc.CommandEnvironment getCommandEnvironment()
Get the group command environment, containing path to the jre executable and startup options.

Returns:
the command environment or null if the default environment should be used.

equals

public boolean equals(Object obj)
Compare for the content equality.

Overrides:
equals in class Object
Parameters:
obj - the Object to compare to
Returns:
whether this Object is semantically equal to another
See Also:
Object.hashCode()

hashCode

public int hashCode()
Return the hashcode.

Overrides:
hashCode in class Object
Returns:
the hash code for this Object
See Also:
Object.equals(Object), System.identityHashCode(Object)