ej.hoka.http.encoding

Interface TransferEncoding

All Known Implementing Classes:

ChunkedTransferCodingHandler, IdentityTransferEncoding

public interface TransferEncoding

Interface for defining HTTP transfer coding handlers.

The HTTP transfer coding handler decodes data from the body of a HttpRequest and encodes the body of a HttpResponse.

Transfer coding is specified in transfer-encoding HTTP header.

Encoding handlers should be registered in the HttpServer in order to use them.

See Also:

EncodingRegistry.registerTransferEncoding(TransferEncoding)

Method Summary

Modifier and Type	Method and Description
String	getId() Returns the supported encoding id.
InputStream	open(HttpRequest request, InputStream input) Opens an InputStream that can be used to decode message body of the given request.
OutputStream	open(HttpResponse response, OutputStream output) Opens an OutputStream that can be used to encode the message body of the HttpResponse.

Method Detail

getId

String getId()

Returns the supported encoding id.

Returns:

an internal String in lower case format.

open

InputStream open(HttpRequest request,
                 InputStream input)
          throws IOException

Opens an InputStream that can be used to decode message body of the given request. The returned InputStream MUST conforms to the followings:

• The InputStream MUST reach the EOF (i.e. read methods returns -1) when the request body has been completely read.
• The InputStream.close() method MUST read any remaining bytes from the message body (if any) and MUST NOT close the underlying stream.

Parameters:

request - the HttpRequest to be decoded by this transfer coding handler.

input - the InputStream from which encoded message body can be read.

Returns:

the InputStream used to decode message body of the given request.

Throws:

IOException - if any I/O Error occurs.

open

OutputStream open(HttpResponse response,
                  OutputStream output)
           throws IOException

Opens an OutputStream that can be used to encode the message body of the HttpResponse.

Parameters:

response - the HttpResponse to be encoded by this transfer coding handler.

output - the OutputStream where the encoded message body is written.

Returns:

the output stream used to encode message body of the given response.

Throws:

IOException - if any I/O Error occurs.