net.jini.io.context

Interface AcknowledgmentSource

public interface AcknowledgmentSource

A server context element for registering interest in receiving an acknowledgment that the remote call's result data has been delivered to and processed by the client.

Since:

2.0

Author:

Sun Microsystems, Inc.

See Also:

ServerContext.getServerContextElement(java.lang.Class)

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	AcknowledgmentSource.Listener A callback object for registering with an AcknowledgmentSource server context element to handle the receipt of an acknowledgment that the remote call's result data has been processed by the client.

Method Summary

Modifier and Type	Method and Description
boolean	addAcknowledgmentListener(AcknowledgmentSource.Listener listener) Registers the specified listener as interested in receiving an acknowledgment that the remote call's result data has been processed by the client.

Method Detail

addAcknowledgmentListener

boolean addAcknowledgmentListener(AcknowledgmentSource.Listener listener)

Registers the specified listener as interested in receiving an acknowledgment that the remote call's result data has been processed by the client. Multiple listeners may be registered with this object.

The implementation of this interface may refuse a registration, such as if the remote call's result data has already been written. This method returns true if the listener was successfully registered, and false if the registration was refused.

Parameters:

listener - the listener to register

Returns:

true if the listener was successfully registered, and false if the registration was refused

Throws:

NullPointerException - if listener is null