44  * @see         ActivationMonitor
  45  * @since       1.2
  46  */
  47 public interface ActivationSystem extends Remote {
  48 
  49     /** The port to lookup the activation system. */
  50     public static final int SYSTEM_PORT = 1098;
  51 
  52     /**
  53      * The <code>registerObject</code> method is used to register an
  54      * activation descriptor, <code>desc</code>, and obtain an
  55      * activation identifier for a activatable remote object. The
  56      * <code>ActivationSystem</code> creates an
  57      * <code>ActivationID</code> (a activation identifier) for the
  58      * object specified by the descriptor, <code>desc</code>, and
  59      * records, in stable storage, the activation descriptor and its
  60      * associated identifier for later use. When the <code>Activator</code>
  61      * receives an <code>activate</code> request for a specific identifier, it
  62      * looks up the activation descriptor (registered previously) for
  63      * the specified identifier and uses that information to activate
  64      * the object. <p>
  65      *
  66      * @param desc the object's activation descriptor
  67      * @return the activation id that can be used to activate the object
  68      * @exception ActivationException if registration fails (e.g., database
  69      * update failure, etc).
  70      * @exception UnknownGroupException if group referred to in
  71      * <code>desc</code> is not registered with this system
  72      * @exception RemoteException if remote call fails
  73      * @since 1.2
  74      */
  75     public ActivationID registerObject(ActivationDesc desc)
  76         throws ActivationException, UnknownGroupException, RemoteException;
  77 
  78     /**
  79      * Remove the activation id and associated descriptor previously
  80      * registered with the <code>ActivationSystem</code>; the object
  81      * can no longer be activated via the object's activation id.
  82      *
  83      * @param id the object's activation id (from previous registration)
  84      * @exception ActivationException if unregister fails (e.g., database

  44  * @see         ActivationMonitor
  45  * @since       1.2
  46  */
  47 public interface ActivationSystem extends Remote {
  48 
  49     /** The port to lookup the activation system. */
  50     public static final int SYSTEM_PORT = 1098;
  51 
  52     /**
  53      * The <code>registerObject</code> method is used to register an
  54      * activation descriptor, <code>desc</code>, and obtain an
  55      * activation identifier for a activatable remote object. The
  56      * <code>ActivationSystem</code> creates an
  57      * <code>ActivationID</code> (a activation identifier) for the
  58      * object specified by the descriptor, <code>desc</code>, and
  59      * records, in stable storage, the activation descriptor and its
  60      * associated identifier for later use. When the <code>Activator</code>
  61      * receives an <code>activate</code> request for a specific identifier, it
  62      * looks up the activation descriptor (registered previously) for
  63      * the specified identifier and uses that information to activate
  64      * the object.
  65      *
  66      * @param desc the object's activation descriptor
  67      * @return the activation id that can be used to activate the object
  68      * @exception ActivationException if registration fails (e.g., database
  69      * update failure, etc).
  70      * @exception UnknownGroupException if group referred to in
  71      * <code>desc</code> is not registered with this system
  72      * @exception RemoteException if remote call fails
  73      * @since 1.2
  74      */
  75     public ActivationID registerObject(ActivationDesc desc)
  76         throws ActivationException, UnknownGroupException, RemoteException;
  77 
  78     /**
  79      * Remove the activation id and associated descriptor previously
  80      * registered with the <code>ActivationSystem</code>; the object
  81      * can no longer be activated via the object's activation id.
  82      *
  83      * @param id the object's activation id (from previous registration)
  84      * @exception ActivationException if unregister fails (e.g., database