io.netty.handler.codec.http2

Class InboundHttp2ToHttpAdapter

java.lang.Object

io.netty.handler.codec.http2.Http2EventAdapter

io.netty.handler.codec.http2.InboundHttp2ToHttpAdapter

All Implemented Interfaces:

Http2Connection.Listener, Http2FrameListener

Direct Known Subclasses:

InboundHttp2ToHttpPriorityAdapter

public class InboundHttp2ToHttpAdapter
extends Http2EventAdapter

This adapter provides just header/data events from the HTTP message flow defined here HTTP/2 Spec Message Flow.

See HttpToHttp2ConnectionHandler to get translation from HTTP/1.x objects to HTTP/2 frames for writes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InboundHttp2ToHttpAdapter.Builder

Field Summary

Fields

Modifier and Type	Field and Description
protected Http2Connection	connection
protected IntObjectMap<FullHttpMessage>	messageMap
protected boolean	validateHttpHeaders

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InboundHttp2ToHttpAdapter(InboundHttp2ToHttpAdapter.Builder builder)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	fireChannelRead(ChannelHandlerContext ctx, FullHttpMessage msg, int streamId) Set final headers and fire a channel read event
protected FullHttpMessage	newMessage(int streamId, Http2Headers headers, boolean validateHttpHeaders) Create a new FullHttpMessage based upon the current connection parameters
int	onDataRead(ChannelHandlerContext ctx, int streamId, ByteBuf data, int padding, boolean endOfStream) Handles an inbound DATA frame.
void	onHeadersRead(ChannelHandlerContext ctx, int streamId, Http2Headers headers, int padding, boolean endOfStream) Handles an inbound HEADERS frame.
void	onHeadersRead(ChannelHandlerContext ctx, int streamId, Http2Headers headers, int streamDependency, short weight, boolean exclusive, int padding, boolean endOfStream) Handles an inbound HEADERS frame with priority information specified.
void	onPushPromiseRead(ChannelHandlerContext ctx, int streamId, int promisedStreamId, Http2Headers headers, int padding) Handles an inbound PUSH_PROMISE frame.
void	onRstStreamRead(ChannelHandlerContext ctx, int streamId, long errorCode) Handles an inbound RST_STREAM frame.
void	onSettingsRead(ChannelHandlerContext ctx, Http2Settings settings) Handles an inbound SETTINGS frame.
protected FullHttpMessage	processHeadersBegin(ChannelHandlerContext ctx, int streamId, Http2Headers headers, boolean endOfStream, boolean allowAppend, boolean appendToTrailer) Provides translation between HTTP/2 and HTTP header objects while ensuring the stream is in a valid state for additional headers.
protected void	removeMessage(int streamId) The streamId is out of scope for the HTTP message flow and will no longer be tracked
void	streamRemoved(Http2Stream stream) Notifies the listener that the given stream has now been removed from the connection and will no longer be returned via Http2Connection.stream(int).

Methods inherited from class io.netty.handler.codec.http2.Http2EventAdapter

goingAway, onGoAwayRead, onPingAckRead, onPingRead, onPriorityRead, onSettingsAckRead, onUnknownFrame, onWeightChanged, onWindowUpdateRead, priorityTreeParentChanged, priorityTreeParentChanging, streamActive, streamAdded, streamHalfClosed, streamInactive

Methods inherited from class java.lang.Object

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

Field Detail

connection

protected final Http2Connection connection

validateHttpHeaders

protected final boolean validateHttpHeaders

messageMap

protected final IntObjectMap<FullHttpMessage> messageMap

Constructor Detail

InboundHttp2ToHttpAdapter

protected InboundHttp2ToHttpAdapter(InboundHttp2ToHttpAdapter.Builder builder)

Method Detail

removeMessage

protected void removeMessage(int streamId)

The streamId is out of scope for the HTTP message flow and will no longer be tracked

Parameters:

streamId - The stream id to remove associated state with

streamRemoved

public void streamRemoved(Http2Stream stream)

Description copied from interface: Http2Connection.Listener

Notifies the listener that the given stream has now been removed from the connection and will no longer be returned via Http2Connection.stream(int). The connection may maintain inactive streams for some time before removing them.

Specified by:

streamRemoved in interface Http2Connection.Listener

Overrides:

streamRemoved in class Http2EventAdapter

fireChannelRead

protected void fireChannelRead(ChannelHandlerContext ctx,
                   FullHttpMessage msg,
                   int streamId)

Set final headers and fire a channel read event

Parameters:

ctx - The context to fire the event on

msg - The message to send

streamId - the streamId of the message which is being fired

newMessage

protected FullHttpMessage newMessage(int streamId,
                         Http2Headers headers,
                         boolean validateHttpHeaders)
                              throws Http2Exception

Create a new FullHttpMessage based upon the current connection parameters

Parameters:

streamId - The stream id to create a message for

headers - The headers associated with streamId

validateHttpHeaders -

• true to validate HTTP headers in the http-codec
• false not to validate HTTP headers in the http-codec

Throws:

Http2Exception

processHeadersBegin

protected FullHttpMessage processHeadersBegin(ChannelHandlerContext ctx,
                                  int streamId,
                                  Http2Headers headers,
                                  boolean endOfStream,
                                  boolean allowAppend,
                                  boolean appendToTrailer)
                                       throws Http2Exception

Provides translation between HTTP/2 and HTTP header objects while ensuring the stream is in a valid state for additional headers.

Parameters:

ctx - The context for which this message has been received. Used to send informational header if detected.

streamId - The stream id the headers apply to

headers - The headers to process

endOfStream - true if the streamId has received the end of stream flag

allowAppend -

• true if headers will be appended if the stream already exists.
• if false and the stream already exists this method returns null.

appendToTrailer -

• true if a message streamId already exists then the headers should be added to the trailing headers.
• false then appends will be done to the initial headers.

Returns:

The object used to track the stream corresponding to streamId. null if allowAppend is false and the stream already exists.

Throws:

Http2Exception - If the stream id is not in the correct state to process the headers request

onDataRead

public int onDataRead(ChannelHandlerContext ctx,
             int streamId,
             ByteBuf data,
             int padding,
             boolean endOfStream)
               throws Http2Exception

Description copied from interface: Http2FrameListener

Handles an inbound DATA frame.

Specified by:

onDataRead in interface Http2FrameListener

Overrides:

onDataRead in class Http2EventAdapter

Parameters:

ctx - the context from the handler where the frame was read.

streamId - the subject stream for the frame.

data - payload buffer for the frame. This buffer will be released by the codec.

padding - the number of padding bytes found at the end of the frame.

endOfStream - Indicates whether this is the last frame to be sent from the remote endpoint for this stream.

Returns:

the number of bytes that have been processed by the application. The returned bytes are used by the inbound flow controller to determine the appropriate time to expand the inbound flow control window (i.e. send WINDOW_UPDATE). Returning a value equal to the length of data + padding will effectively opt-out of application-level flow control for this frame. Returning a value less than the length of data + padding will defer the returning of the processed bytes, which the application must later return via Http2InboundFlowState#returnProcessedBytes(ChannelHandlerContext, int). The returned value must be >= 0 and <= data.readableBytes() + padding.

Throws:

Http2Exception

onHeadersRead

public void onHeadersRead(ChannelHandlerContext ctx,
                 int streamId,
                 Http2Headers headers,
                 int padding,
                 boolean endOfStream)
                   throws Http2Exception

Description copied from interface: Http2FrameListener

Handles an inbound HEADERS frame.

Only one of the following methods will be called for each HEADERS frame sequence. One will be called when the END_HEADERS flag has been received.

• Http2FrameListener.onHeadersRead(ChannelHandlerContext, int, Http2Headers, int, boolean)
• Http2FrameListener.onHeadersRead(ChannelHandlerContext, int, Http2Headers, int, short, boolean, int, boolean)
• Http2FrameListener.onPushPromiseRead(ChannelHandlerContext, int, int, Http2Headers, int)

To say it another way; the Http2Headers will contain all of the headers for the current message exchange step (additional queuing is not necessary).

Specified by:

onHeadersRead in interface Http2FrameListener

Overrides:

onHeadersRead in class Http2EventAdapter

Parameters:

ctx - the context from the handler where the frame was read.

streamId - the subject stream for the frame.

headers - the received headers.

padding - the number of padding bytes found at the end of the frame.

endOfStream - Indicates whether this is the last frame to be sent from the remote endpoint for this stream.

Throws:

Http2Exception

onHeadersRead

public void onHeadersRead(ChannelHandlerContext ctx,
                 int streamId,
                 Http2Headers headers,
                 int streamDependency,
                 short weight,
                 boolean exclusive,
                 int padding,
                 boolean endOfStream)
                   throws Http2Exception

Description copied from interface: Http2FrameListener

Handles an inbound HEADERS frame with priority information specified. Only called if END_HEADERS encountered.

Only one of the following methods will be called for each HEADERS frame sequence. One will be called when the END_HEADERS flag has been received.

• Http2FrameListener.onHeadersRead(ChannelHandlerContext, int, Http2Headers, int, boolean)
• Http2FrameListener.onHeadersRead(ChannelHandlerContext, int, Http2Headers, int, short, boolean, int, boolean)
• Http2FrameListener.onPushPromiseRead(ChannelHandlerContext, int, int, Http2Headers, int)

To say it another way; the Http2Headers will contain all of the headers for the current message exchange step (additional queuing is not necessary).

Specified by:

onHeadersRead in interface Http2FrameListener

Overrides:

onHeadersRead in class Http2EventAdapter

Parameters:

ctx - the context from the handler where the frame was read.

streamId - the subject stream for the frame.

headers - the received headers.

streamDependency - the stream on which this stream depends, or 0 if dependent on the connection.

weight - the new weight for the stream.

exclusive - whether or not the stream should be the exclusive dependent of its parent.

padding - the number of padding bytes found at the end of the frame.

endOfStream - Indicates whether this is the last frame to be sent from the remote endpoint for this stream.

Throws:

Http2Exception

onRstStreamRead

public void onRstStreamRead(ChannelHandlerContext ctx,
                   int streamId,
                   long errorCode)
                     throws Http2Exception

Description copied from interface: Http2FrameListener

Handles an inbound RST_STREAM frame.

Specified by:

onRstStreamRead in interface Http2FrameListener

Overrides:

onRstStreamRead in class Http2EventAdapter

Parameters:

ctx - the context from the handler where the frame was read.

streamId - the stream that is terminating.

errorCode - the error code identifying the type of failure.

Throws:

Http2Exception

onPushPromiseRead

public void onPushPromiseRead(ChannelHandlerContext ctx,
                     int streamId,
                     int promisedStreamId,
                     Http2Headers headers,
                     int padding)
                       throws Http2Exception

Description copied from interface: Http2FrameListener

Handles an inbound PUSH_PROMISE frame. Only called if END_HEADERS encountered.

Promised requests MUST be cacheable (see [RFC7231], Section 4.2.3) and MUST be safe (see [RFC7231], Section 4.2.1). If these conditions do not hold the application MUST throw a Http2Exception.StreamException with error type Http2Error.PROTOCOL_ERROR.

Only one of the following methods will be called for each HEADERS frame sequence. One will be called when the END_HEADERS flag has been received.

• Http2FrameListener.onHeadersRead(ChannelHandlerContext, int, Http2Headers, int, boolean)
• Http2FrameListener.onHeadersRead(ChannelHandlerContext, int, Http2Headers, int, short, boolean, int, boolean)
• Http2FrameListener.onPushPromiseRead(ChannelHandlerContext, int, int, Http2Headers, int)

To say it another way; the Http2Headers will contain all of the headers for the current message exchange step (additional queuing is not necessary).

Specified by:

onPushPromiseRead in interface Http2FrameListener

Overrides:

onPushPromiseRead in class Http2EventAdapter

Parameters:

ctx - the context from the handler where the frame was read.

streamId - the stream the frame was sent on.

promisedStreamId - the ID of the promised stream.

headers - the received headers.

padding - the number of padding bytes found at the end of the frame.

Throws:

Http2Exception

onSettingsRead

public void onSettingsRead(ChannelHandlerContext ctx,
                  Http2Settings settings)
                    throws Http2Exception

Description copied from interface: Http2FrameListener

Handles an inbound SETTINGS frame.

Specified by:

onSettingsRead in interface Http2FrameListener

Overrides:

onSettingsRead in class Http2EventAdapter

Parameters:

ctx - the context from the handler where the frame was read.

settings - the settings received from the remote endpoint.

Throws:

Http2Exception