io.cdap.http

Class BodyConsumer

java.lang.Object

io.cdap.http.BodyConsumer

public abstract class BodyConsumer
extends Object

HttpHandler would extend this abstract class and implement methods to stream the body directly. chunk method would receive the http-chunks of the body and finished would be called on receipt of the last chunk.

Constructor Summary

Constructors

Constructor and Description
BodyConsumer()

Method Summary

Modifier and Type	Method and Description
abstract void	chunk(io.netty.buffer.ByteBuf request, HttpResponder responder) Http request content will be streamed directly to this method.
abstract void	finished(HttpResponder responder) This is called on the receipt of the last HttpChunk.
abstract void	handleError(Throwable cause) When there is exception on netty while streaming, it will be propagated to handler so the handler can do the cleanup.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BodyConsumer

public BodyConsumer()

Method Detail

chunk

public abstract void chunk(io.netty.buffer.ByteBuf request,
                           HttpResponder responder)

Http request content will be streamed directly to this method.

Parameters:

request - the next chunk to be consumed

responder - a HttpResponder for sending response back to client.

finished

public abstract void finished(HttpResponder responder)

This is called on the receipt of the last HttpChunk.

Parameters:

responder - a HttpResponder for sending response back to client.

handleError

public abstract void handleError(Throwable cause)

When there is exception on netty while streaming, it will be propagated to handler so the handler can do the cleanup. Implementations should not write to an HttpResponder. Instead, use a ExceptionHandler.

Parameters:

cause - the reaons of the failure.