net.artima.place
Interface ActivationClient

public interface ActivationClient

Interface implemented by an object that is notified when a link activation completes, either with success, failure, or as a result of being aborted. Only one of the methods in this interface will be invoked (only once) for each link activation.

Method Summary

void	activationAborted() Invoked when a Link activation fails because of being aborted.
void	activationFailed(java.lang.String message, java.lang.Throwable exception) Invoked when a Link activation fails for any reason except being aborted.
void	activationSucceeded(net.jini.core.lookup.ServiceItem si) Invoked when a Link activation succeeds.

Method Detail

activationSucceeded

public void activationSucceeded(net.jini.core.lookup.ServiceItem si)

Invoked when a Link activation succeeds. The client recieves the ServiceItem that resulted from the link activation as a parameter of this method.

activationFailed

public void activationFailed(java.lang.String message,
                             java.lang.Throwable exception)

Invoked when a Link activation fails for any reason except being aborted. If the passed String is not null, then it represents a description of the problem that caused the activation to fail, suitable for presenting to users or writing to a log that will be read by administrators, and may be localized where appropriate. If the passed Throwable is not null, it represents an exception that caused the failure to occur.

activationAborted

public void activationAborted()

Invoked when a Link activation fails because of being aborted. Because a client indicates they wish to abort an activation by invoking abort on the LinkActivation returned by the activate method, a client may request abort just as the activation succeeds or fails. So after a client invokes abort, this method will likely be invoked on the ActivationListener, but either of the other two methods in this interface may alternatively be invoked.