com.googlecode.xremoting.core.spi
Interface Request

All Known Implementing Classes:

CommonsHttpClientRequest, HttpRequest

public interface Request

Represents a single request/response pair.

The contract mandates the following order of invocation of methods:

1. getOutputStream()
2. commitRequest()
3. getInputStream()
4. releaseRequest()

Each of these methods is to be called maximum once.

releaseRequest() method MUST be called anyway, even if error occurred.

Author:

Roman Puchkovskiy

See Also:

Requester

Method Summary

void	commitRequest() Commits a request.
InputStream	getInputStream() Returns InputStream from which user may get response data.
OutputStream	getOutputStream() Returns OutputStream to which user may send request data.
void	releaseRequest() Releases resources claimed by request (closes connections, etc.).

Method Detail

getOutputStream

OutputStream getOutputStream()
                             throws IOException

Returns OutputStream to which user may send request data.

Returns:

output stream

Throws:

IOException - if i/o error occurs

commitRequest

void commitRequest()
                   throws IOException

Commits a request. That is, changes request state to the one in which no data may be sent to remote side, and data may be got from remote side.

Throws:

IOException - if i/o error occurs

getInputStream

InputStream getInputStream()
                           throws IOException

Returns InputStream from which user may get response data.

Returns:

input stream

Throws:

IOException - if i/o error occurs

releaseRequest

void releaseRequest()

Releases resources claimed by request (closes connections, etc.).