io.netty.handler.codec.http2

类 InboundHttp2ToHttpAdapter

java.lang.Object

io.netty.handler.codec.http2.Http2EventAdapter

io.netty.handler.codec.http2.InboundHttp2ToHttpAdapter

所有已实现的接口:

Http2Connection.Listener, Http2FrameListener

@UnstableApi
public class InboundHttp2ToHttpAdapter
extends Http2EventAdapter

This adapter provides just header/data events from the HTTP message flow defined in [RFC 7540], Section 8.1.

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

字段概要

字段

限定符和类型	字段和说明
protected Http2Connection	connection
protected boolean	validateHttpHeaders

构造器概要

构造器

限定符	构造器和说明
protected	InboundHttp2ToHttpAdapter(Http2Connection connection, int maxContentLength, boolean validateHttpHeaders, boolean propagateSettings)

方法概要

限定符和类型	方法和说明
protected void	fireChannelRead(ChannelHandlerContext ctx, FullHttpMessage msg, boolean release, Http2Stream stream) Set final headers and fire a channel read event
protected FullHttpMessage	getMessage(Http2Stream stream) Get the FullHttpMessage associated with stream.
protected FullHttpMessage	newMessage(Http2Stream stream, Http2Headers headers, boolean validateHttpHeaders, ByteBufAllocator alloc) 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.
protected void	onRstStreamRead(Http2Stream stream, FullHttpMessage msg) Called if a RST_STREAM is received but we have some data for that stream.
void	onSettingsRead(ChannelHandlerContext ctx, Http2Settings settings) Handles an inbound SETTINGS frame.
void	onStreamRemoved(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).
protected FullHttpMessage	processHeadersBegin(ChannelHandlerContext ctx, Http2Stream stream, 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	putMessage(Http2Stream stream, FullHttpMessage message) Make message be the state associated with stream.
protected void	removeMessage(Http2Stream stream, boolean release) The stream is out of scope for the HTTP message flow and will no longer be tracked

从类继承的方法 io.netty.handler.codec.http2.Http2EventAdapter

onGoAwayRead, onGoAwayReceived, onGoAwaySent, onPingAckRead, onPingRead, onPriorityRead, onSettingsAckRead, onStreamActive, onStreamAdded, onStreamClosed, onStreamHalfClosed, onUnknownFrame, onWindowUpdateRead

从类继承的方法 java.lang.Object

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

字段详细资料

connection

protected final Http2Connection connection

validateHttpHeaders

protected final boolean validateHttpHeaders

构造器详细资料

InboundHttp2ToHttpAdapter

protected InboundHttp2ToHttpAdapter(Http2Connection connection,
                                    int maxContentLength,
                                    boolean validateHttpHeaders,
                                    boolean propagateSettings)

方法详细资料

removeMessage

protected final void removeMessage(Http2Stream stream,
                                   boolean release)

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

参数:

stream - The stream to remove associated state with

release - true to call release on the value if it is present. false to not call release.

getMessage

protected final FullHttpMessage getMessage(Http2Stream stream)

Get the FullHttpMessage associated with stream.

参数:

stream - The stream to get the associated state from

返回:

The FullHttpMessage associated with stream.

putMessage

protected final void putMessage(Http2Stream stream,
                                FullHttpMessage message)

Make message be the state associated with stream.

参数:

stream - The stream which message is associated with.

message - The message which contains the HTTP semantics.

onStreamRemoved

public void onStreamRemoved(Http2Stream stream)

从接口复制的说明: 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.

If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.

指定者:

onStreamRemoved 在接口中 Http2Connection.Listener

覆盖:

onStreamRemoved 在类中 Http2EventAdapter

fireChannelRead

protected void fireChannelRead(ChannelHandlerContext ctx,
                               FullHttpMessage msg,
                               boolean release,
                               Http2Stream stream)

Set final headers and fire a channel read event

参数:

ctx - The context to fire the event on

msg - The message to send

release - true to call release on the value if it is present. false to not call release.

stream - the stream of the message which is being fired

newMessage

protected FullHttpMessage newMessage(Http2Stream stream,
                                     Http2Headers headers,
                                     boolean validateHttpHeaders,
                                     ByteBufAllocator alloc)
                              throws Http2Exception

Create a new FullHttpMessage based upon the current connection parameters

参数:

stream - The stream to create a message for

headers - The headers associated with stream

validateHttpHeaders -

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

alloc - The ByteBufAllocator to use to generate the content of the message

抛出:

Http2Exception - If there is an error when creating FullHttpMessage from Http2Stream and Http2Headers

processHeadersBegin

protected FullHttpMessage processHeadersBegin(ChannelHandlerContext ctx,
                                              Http2Stream stream,
                                              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.

参数:

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

stream - The stream the headers apply to

headers - The headers to process

endOfStream - true if the stream 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 stream already exists then the headers should be added to the trailing headers.
• false then appends will be done to the initial headers.

返回:

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

抛出:

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

从接口复制的说明: Http2FrameListener

Handles an inbound DATA frame.

指定者:

onDataRead 在接口中 Http2FrameListener

覆盖:

onDataRead 在类中 Http2EventAdapter

参数:

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 - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).

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

返回:

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 Http2LocalFlowController.consumeBytes(Http2Stream, int). The returned value must be >= 0 and <= data.readableBytes() + padding.

抛出:

Http2Exception

onHeadersRead

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

从接口复制的说明: 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).

指定者:

onHeadersRead 在接口中 Http2FrameListener

覆盖:

onHeadersRead 在类中 Http2EventAdapter

参数:

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

streamId - the subject stream for the frame.

headers - the received headers.

padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).

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

抛出:

Http2Exception

onHeadersRead

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

从接口复制的说明: 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).

指定者:

onHeadersRead 在接口中 Http2FrameListener

覆盖:

onHeadersRead 在类中 Http2EventAdapter

参数:

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 - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).

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

抛出:

Http2Exception

onRstStreamRead

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

从接口复制的说明: Http2FrameListener

Handles an inbound RST_STREAM frame.

指定者:

onRstStreamRead 在接口中 Http2FrameListener

覆盖:

onRstStreamRead 在类中 Http2EventAdapter

参数:

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.

抛出:

Http2Exception

onPushPromiseRead

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

从接口复制的说明: Http2FrameListener

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

Promised requests MUST be authoritative, cacheable, and safe. See [RFC 7540], Section 8.2.

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).

指定者:

onPushPromiseRead 在接口中 Http2FrameListener

覆盖:

onPushPromiseRead 在类中 Http2EventAdapter

参数:

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 - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).

抛出:

Http2Exception

onSettingsRead

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

从接口复制的说明: Http2FrameListener

Handles an inbound SETTINGS frame.

指定者:

onSettingsRead 在接口中 Http2FrameListener

覆盖:

onSettingsRead 在类中 Http2EventAdapter

参数:

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

settings - the settings received from the remote endpoint.

抛出:

Http2Exception

onRstStreamRead

protected void onRstStreamRead(Http2Stream stream,
                               FullHttpMessage msg)

Called if a RST_STREAM is received but we have some data for that stream.