org.ten60.netkernel.layer1.nkf
Interface INKFAsyncRequestHandle

All Known Implementing Classes:

NKFAsyncRequestHandleImpl

public interface INKFAsyncRequestHandle

Proxy for issuing of an asynchronous subrequest

Method Summary

IURRepresentation	join() Wait for an asynchronous subrequest to complete and return result - same effect as join(0)
IURRepresentation	join(long aTimeout) Wait for an asynchronous subrequest to complete and return result
void	setListener(INKFAsyncRequestListener aListener) Register a listener to be notified when the result of the request is available.

Method Detail

join

IURRepresentation join()
                       throws NKFException,
                              java.lang.InterruptedException

Wait for an asynchronous subrequest to complete and return result - same effect as join(0)

Returns:

the result of executing the subrequest

Throws:

NKFException - an exception issued in trying to issue the sub request.

java.lang.InterruptedException - thrown if waiting for the request to complete is interrupted

join

IURRepresentation join(long aTimeout)
                       throws NKFException,
                              java.lang.InterruptedException

Wait for an asynchronous subrequest to complete and return result

Returns:

the result of executing the subrequest, or null if a timeout

Throws:

NKFException - an exception issued in trying to issue the sub request.

java.lang.InterruptedException - thrown if waiting for the request to complete is interrupted

setListener

void setListener(INKFAsyncRequestListener aListener)

Register a listener to be notified when the result of the request is available. It is important to note that this method cannot be used to effect the response from an accessor as the callback may be made after the accessor completes. This method is more suitable for asynchronous transports.

Parameters:

aListener -