Module java.rmi
Package java.rmi.activation

Class ActivationGroupDesc

  • All Implemented Interfaces:
    Serializable

    public final class ActivationGroupDesc
extends Object
implements 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 name,
    • the group's code ___location (the ___location of the group's class), and
    • a "marshalled" object that can contain group specific initialization data.

    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:

    • the group's ActivationGroupID, and
    • the group's initialization data (in a java.rmi.MarshalledObject)
    Since:
    1.2
    See Also:
    ActivationGroup, ActivationGroupID, Serialized Form

    • Constructor Detail

      • ActivationGroupDesc

        public ActivationGroupDesc​(Properties overrides,
                           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

        public ActivationGroupDesc​(String className,
                           String ___location,
                           MarshalledObject<?> data,
                           Properties overrides,
                           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

        public 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

        public String getLocation​()
        Returns the group's code ___location.
        Returns:
        the group's code ___location
        Since:
        1.2

      • getData

        public MarshalledObject<?> getData​()
        Returns the group's initialization data.
        Returns:
        the group's initialization data
        Since:
        1.2

      • getPropertyOverrides

        public Properties getPropertyOverrides​()
        Returns the group's property-override list.
        Returns:
        the property-override list, or null
        Since:
        1.2

      • getCommandEnvironment

        public ActivationGroupDesc.CommandEnvironment getCommandEnvironment​()
        Returns the group's command-environment control object.
        Returns:
        the command-environment object, or null
        Since:
        1.2

      • equals

        public boolean equals​(Object obj)
        Compares two activation group descriptors for content equality.
        Overrides:
        equals in class Object
        Parameters:
        obj - the Object to compare with
        Returns:
        true if these Objects are equal; false otherwise.
        Since:
        1.2
        See Also:
        Hashtable

      • hashCode

        public int hashCode​()
        Produce identical numbers for similar ActivationGroupDescs.
        Overrides:
        hashCode in class Object
        Returns:
        an integer
        See Also:
        Hashtable