rmi/activation/Activatable.java

26 package java.rmi.activation;
32 import java.rmi.activation.UnknownGroupException;
33 import java.rmi.activation.UnknownObjectException;
63      * an activation descriptor (with the specified location, data, and
71      * atomic.  Instead, an application should register an activation
79      * will return the activation identifier returned from the call to
87      * either the activator is restarted or the object's activation group
90      * <code>true</code> does not force an initial immediate activation of
91      * a newly registered object;  initial activation is lazy.
94      * a) registering the object with the activation system or b) exporting
96      * @exception UnsupportedOperationException if and only if activation is
112      * an activation descriptor (with the specified location, data, and
120      * atomic.  Instead, an application should register an activation
128      * Subsequent calls to {@link #getID} will return the activation
134      * either the activator is restarted or the object's activation group
137      * <code>true</code> does not force an initial immediate activation of
138      * a newly registered object;  initial activation is lazy.
146      * a) registering the object with the activation system or b) exporting
148      * @exception UnsupportedOperationException if and only if activation is
168      * <li>the object's activation identifier (<code>ActivationID</code>), and
178      * @param id activation identifier for the object
182      * @exception UnsupportedOperationException if and only if activation is
198      * <li>the object's activation identifier (<code>ActivationID</code>), and
208      * @param id activation identifier for the object
215      * @exception UnsupportedOperationException if and only if activation is
230      * Returns the object's activation identifier.  The method is
233      * @return the object's activation identifier
247      * is not registered with the activation system
248      * @exception ActivationException if activation system is not running
250      * @exception UnsupportedOperationException if and only if activation is
264      * Informs the system that the object with the corresponding activation
276      * @param id the object's activation identifier
286      * @exception UnsupportedOperationException if and only if activation is
297      * Revokes previous registration for the activation descriptor
301      * @param id the object's activation identifier
303      * @exception ActivationException if activation system is not running
304      * @exception RemoteException if remote call to activation system fails
305      * @exception UnsupportedOperationException if and only if activation is
316      * Registers an activation descriptor (with the specified location,
325      * register an activation descriptor and export a remote object
332      * server socket factories, and then returns the resulting activation
339      * either the activator is restarted or the object's activation group
342      * <code>true</code> does not force an initial immediate activation of
343      * a newly registered object;  initial activation is lazy.
346      * @return the activation identifier obtained from registering the
347      * descriptor, <code>desc</code>, with the activation system
349      * @exception ActivationException if activation group is not active
351      * @exception UnsupportedOperationException if and only if activation is
366      * Registers an activation descriptor (with the specified location,
376      * register an activation descriptor and export a remote object
379      * <p>This method first registers an activation descriptor for the
380      * specified object as follows. It obtains the activation system by
383      * ActivationID} for the object by invoking the activation system's
387      * an exception occurs obtaining the activation system or registering
388      * the activation descriptor, that exception is thrown to the caller.
393      * activation identifier obtained from registration, the specified
396      * unregister the activation identifier (obtained from registration) by
397      * invoking the activation system's {@link
399      * activation identifier.  If an exception occurs unregistering the
404      * ActivationGroup#activeObject activeObject} method on the activation
405      * group in this VM with the activation identifier and the specified
406      * remote object, and returns the activation identifier to the caller.
412      * either the activator is restarted or the object's activation group
415      * <code>true</code> does not force an initial immediate activation of
416      * a newly registered object;  initial activation is lazy.
422      * @return the activation identifier obtained from registering the
423      * descriptor with the activation system
424      * @exception ActivationException if activation group is not active
426      * @exception UnsupportedOperationException if and only if activation is
454              * Attempt to unregister activation descriptor because export
482      * During activation, this <code>exportObject</code> method should
490      * @param id the object's  activation identifier
494      * @exception UnsupportedOperationException if and only if activation is
511      * During activation, this <code>exportObject</code> method should
519      * @param id the object's  activation identifier
526      * @exception UnsupportedOperationException if and only if activation is
556      * @exception UnsupportedOperationException if and only if activation is