org.objectweb.jonathan.apis.protocols
Interface ReplyInterface

public interface ReplyInterface

A ReplyInterface holds the reply to a request. Reply interfaces are created two-ways invocations are performed.

Method Summary

boolean	available() Returns true if a (possibly exceptional) reply has arrived.
UnMarshaller	listen() Returns a message containing the reply to the request.

Method Detail

listen

public UnMarshaller listen()
                    throws ServerException,
                           ForwardException,
                           JonathanException

Returns a message containing the reply to the request.

This method blocks until the reply is available. It is the responsibility of the caller to make sure that the returned message will be properly {@ UnMarshaller#close() closed}.

Returns:

a message containing the reply to the request.

Throws:

ServerException - if the server has thrown an application level exception;

ForwardException - if the server has moved;

JonathanException - if another exception has been raised.

available

public boolean available()

Returns true if a (possibly exceptional) reply has arrived.

If available returns true, a call to listen is non-blocking.

Returns:

true if a (possibly exceptional) reply has arrived.