software.amazon.awssdk.http.nio.netty.internal.nrs

Class HttpStreamsClientHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.channel.ChannelDuplexHandler

software.amazon.awssdk.http.nio.netty.internal.nrs.HttpStreamsClientHandler

All Implemented Interfaces:

io.netty.channel.ChannelHandler, io.netty.channel.ChannelInboundHandler, io.netty.channel.ChannelOutboundHandler

public class HttpStreamsClientHandler
extends io.netty.channel.ChannelDuplexHandler

Handler that converts written StreamedHttpRequest messages into HttpRequest messages followed by HttpContent messages and reads HttpResponse messages followed by HttpContent messages and produces StreamedHttpResponse messages. This allows request and response bodies to be handled using reactive streams. There are two types of messages that this handler accepts for writing, StreamedHttpRequest and FullHttpRequest. Writing any other messages may potentially lead to HTTP message mangling. There are two types of messages that this handler will send down the chain, StreamedHttpResponse, and FullHttpResponse. If ChannelOption.AUTO_READ is false for the channel, then any StreamedHttpResponse messages must be subscribed to consume the body, otherwise it's possible that no read will be done of the messages. As long as messages are returned in the order that they arrive, this handler implicitly supports HTTP pipelining. This class contains source imported from https://github.com/playframework/netty-reactive-streams, licensed under the Apache License 2.0, available at the time of the fork (1/31/2020) here: https://github.com/playframework/netty-reactive-streams/blob/master/LICENSE.txt All original source licensed under the Apache License 2.0 by playframework. All modifications are licensed under the Apache License 2.0 by Amazon Web Services.

Nested Class Summary

Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler

io.netty.channel.ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor and Description
HttpStreamsClientHandler()

Method Summary

Modifier and Type	Method and Description
protected void	bodyRequested(io.netty.channel.ChannelHandlerContext ctx) Invoked every time a read of the incoming body is requested by the subscriber.
void	channelRead(io.netty.channel.ChannelHandlerContext ctx, Object msg)
void	channelReadComplete(io.netty.channel.ChannelHandlerContext ctx)
void	close(io.netty.channel.ChannelHandlerContext ctx, io.netty.channel.ChannelPromise future)
protected void	consumedInMessage(io.netty.channel.ChannelHandlerContext ctx) Invoked when an incoming message is fully consumed.
protected io.netty.handler.codec.http.HttpResponse	createEmptyMessage(io.netty.handler.codec.http.HttpResponse response) Create an empty incoming message.
protected io.netty.handler.codec.http.HttpResponse	createStreamedMessage(io.netty.handler.codec.http.HttpResponse response, org.reactivestreams.Publisher<io.netty.handler.codec.http.HttpContent> stream) Create a streamed incoming message with the given stream.
protected boolean	hasBody(io.netty.handler.codec.http.HttpResponse response) Whether the given incoming message has a body.
protected void	receivedInMessage(io.netty.channel.ChannelHandlerContext ctx) Invoked when an incoming message is first received.
protected void	receivedOutMessage(io.netty.channel.ChannelHandlerContext ctx) Invoked when an outgoing message is first received.
protected void	sentOutMessage(io.netty.channel.ChannelHandlerContext ctx) Invoked when an outgoing message is fully sent.
protected void	subscribeSubscriberToStream(StreamedHttpMessage msg, org.reactivestreams.Subscriber<io.netty.handler.codec.http.HttpContent> subscriber) Subscribe the given subscriber to the given streamed message.
protected void	unbufferedWrite(io.netty.channel.ChannelHandlerContext ctx, software.amazon.awssdk.http.nio.netty.internal.nrs.HttpStreamsHandler.Outgoing out)
void	write(io.netty.channel.ChannelHandlerContext ctx, Object msg, io.netty.channel.ChannelPromise promise)

Methods inherited from class io.netty.channel.ChannelDuplexHandler

bind, connect, deregister, disconnect, flush, read

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelInactive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught, userEventTriggered

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, handlerAdded, handlerRemoved, isSharable

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.netty.channel.ChannelHandler

exceptionCaught, handlerAdded, handlerRemoved

Constructor Detail

HttpStreamsClientHandler

public HttpStreamsClientHandler()

Method Detail

hasBody

protected boolean hasBody(io.netty.handler.codec.http.HttpResponse response)

Whether the given incoming message has a body.

close

public void close(io.netty.channel.ChannelHandlerContext ctx,
                  io.netty.channel.ChannelPromise future)
           throws Exception

Specified by:

close in interface io.netty.channel.ChannelOutboundHandler

Overrides:

close in class io.netty.channel.ChannelDuplexHandler

Throws:

Exception

consumedInMessage

protected void consumedInMessage(io.netty.channel.ChannelHandlerContext ctx)

Invoked when an incoming message is fully consumed. Overridden by sub classes for state tracking.

receivedOutMessage

protected void receivedOutMessage(io.netty.channel.ChannelHandlerContext ctx)

Invoked when an outgoing message is first received. Overridden by sub classes for state tracking.

sentOutMessage

protected void sentOutMessage(io.netty.channel.ChannelHandlerContext ctx)

Invoked when an outgoing message is fully sent. Overridden by sub classes for state tracking.

createEmptyMessage

protected io.netty.handler.codec.http.HttpResponse createEmptyMessage(io.netty.handler.codec.http.HttpResponse response)

Create an empty incoming message. This must be of type FullHttpMessage, and is invoked when we've determined that an incoming message can't have a body, so we send it on as a FullHttpMessage.

createStreamedMessage

protected io.netty.handler.codec.http.HttpResponse createStreamedMessage(io.netty.handler.codec.http.HttpResponse response,
                                                                         org.reactivestreams.Publisher<io.netty.handler.codec.http.HttpContent> stream)

Create a streamed incoming message with the given stream.

subscribeSubscriberToStream

protected void subscribeSubscriberToStream(StreamedHttpMessage msg,
                                           org.reactivestreams.Subscriber<io.netty.handler.codec.http.HttpContent> subscriber)

Subscribe the given subscriber to the given streamed message. Provided so that the client subclass can intercept this to hold off sending the body of an expect 100 continue request.

channelRead

public void channelRead(io.netty.channel.ChannelHandlerContext ctx,
                        Object msg)
                 throws Exception

Specified by:

channelRead in interface io.netty.channel.ChannelInboundHandler

Throws:

Exception

receivedInMessage

protected void receivedInMessage(io.netty.channel.ChannelHandlerContext ctx)

Invoked when an incoming message is first received. Overridden by sub classes for state tracking.

bodyRequested

protected void bodyRequested(io.netty.channel.ChannelHandlerContext ctx)

Invoked every time a read of the incoming body is requested by the subscriber. Provided so that the server subclass can intercept this to send a 100 continue response.

channelReadComplete

public void channelReadComplete(io.netty.channel.ChannelHandlerContext ctx)
                         throws Exception

Specified by:

channelReadComplete in interface io.netty.channel.ChannelInboundHandler

Overrides:

channelReadComplete in class io.netty.channel.ChannelInboundHandlerAdapter

Throws:

Exception

write

public void write(io.netty.channel.ChannelHandlerContext ctx,
                  Object msg,
                  io.netty.channel.ChannelPromise promise)
           throws Exception

Specified by:

write in interface io.netty.channel.ChannelOutboundHandler

Overrides:

write in class io.netty.channel.ChannelDuplexHandler

Throws:

Exception

unbufferedWrite

protected void unbufferedWrite(io.netty.channel.ChannelHandlerContext ctx,
                               software.amazon.awssdk.http.nio.netty.internal.nrs.HttpStreamsHandler.Outgoing out)