io.netty.handler.codec.http2

类 Http2MultiplexCodec

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

io.netty.handler.codec.http2.Http2ConnectionHandler

io.netty.handler.codec.http2.Http2FrameCodec

io.netty.handler.codec.http2.Http2MultiplexCodec

所有已实现的接口:

ChannelHandler, ChannelInboundHandler, ChannelOutboundHandler, Http2LifecycleManager

已过时。

use Http2FrameCodecBuilder together with Http2MultiplexHandler.

@Deprecated
 @UnstableApi
public class Http2MultiplexCodec
extends Http2FrameCodec

An HTTP/2 handler that creates child channels for each stream.

When a new stream is created, a new Channel is created for it. Applications send and receive Http2StreamFrames on the created channel. ByteBufs cannot be processed by the channel; all writes that reach the head of the pipeline must be an instance of Http2StreamFrame. Writes that reach the head of the pipeline are processed directly by this handler and cannot be intercepted.

The child channel will be notified of user events that impact the stream, such as Http2GoAwayFrame and Http2ResetFrame, as soon as they occur. Although Http2GoAwayFrame and Http2ResetFrame signify that the remote is ignoring further communication, closing of the channel is delayed until any inbound queue is drained with Channel.read(), which follows the default behavior of channels in Netty. Applications are free to close the channel in response to such events if they don't have use for any queued messages. Any connection level events like Http2SettingsFrame and Http2GoAwayFrame will be processed internally and also propagated down the pipeline for other handlers to act on.

Outbound streams are supported via the Http2StreamChannelBootstrap.

ChannelConfig.setMaxMessagesPerRead(int) and ChannelConfig.setAutoRead(boolean) are supported.

Reference Counting

Some Http2StreamFrames implement the ReferenceCounted interface, as they carry reference counted objects (e.g. ByteBufs). The multiplex codec will call ReferenceCounted.retain() before propagating a reference counted object through the pipeline, and thus an application handler needs to release such an object after having consumed it. For more information on reference counting take a look at https://netty.io/wiki/reference-counted-objects.html

Channel Events

A child channel becomes active as soon as it is registered to an EventLoop. Therefore, an active channel does not map to an active HTTP/2 stream immediately. Only once a Http2HeadersFrame has been successfully sent or received, does the channel map to an active HTTP/2 stream. In case it is not possible to open a new HTTP/2 stream (i.e. due to the maximum number of active streams being exceeded), the child channel receives an exception indicating the cause and is closed immediately thereafter.

Writability and Flow Control

A child channel observes outbound/remote flow control via the channel's writability. A channel only becomes writable when it maps to an active HTTP/2 stream and the stream's flow control window is greater than zero. A child channel does not know about the connection-level flow control window. ChannelHandlers are free to ignore the channel's writability, in which case the excessive writes will be buffered by the parent channel. It's important to note that only Http2DataFrames are subject to HTTP/2 flow control.

嵌套类概要

从类继承的嵌套类/接口 io.netty.handler.codec.ByteToMessageDecoder

ByteToMessageDecoder.Cumulator

从接口继承的嵌套类/接口 io.netty.channel.ChannelHandler

ChannelHandler.Sharable

字段概要

从类继承的字段 io.netty.handler.codec.http2.Http2FrameCodec

streamKey

从类继承的字段 io.netty.handler.codec.ByteToMessageDecoder

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

方法概要

限定符和类型	方法和说明
void	channelRead(ChannelHandlerContext ctx, java.lang.Object msg) 已过时。 Calls ChannelHandlerContext.fireChannelRead(Object) to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	channelReadComplete(ChannelHandlerContext ctx) 已过时。 Notifies any child streams of the read completion.
void	channelWritabilityChanged(ChannelHandlerContext ctx) 已过时。 Calls ChannelHandlerContext.fireChannelWritabilityChanged() to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	handlerAdded0(ChannelHandlerContext ctx) 已过时。
void	handlerRemoved0(ChannelHandlerContext ctx) 已过时。 Gets called after the ByteToMessageDecoder was removed from the actual context and it doesn't handle events anymore.
void	onHttpClientUpgrade() 已过时。 Handles the client-side (cleartext) upgrade from HTTP to HTTP/2.

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

handlerAdded, isGracefulShutdownComplete, onConnectionError, onStreamError, userEventTriggered, write

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

bind, channelActive, channelInactive, close, closeStream, closeStreamLocal, closeStreamRemote, connect, connection, decode, decoder, deregister, disconnect, encoder, exceptionCaught, flush, frameWriter, goAway, gracefulShutdownTimeoutMillis, gracefulShutdownTimeoutMillis, handleServerHeaderDecodeSizeError, onError, onHttpServerUpgrade, read, resetStream

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

actualReadableBytes, callDecode, decodeLast, discardSomeReadBytes, handlerRemoved, internalBuffer, isSingleDecode, setCumulator, setDiscardAfterReads, setSingleDecode

从类继承的方法 io.netty.channel.ChannelInboundHandlerAdapter

channelRegistered, channelUnregistered

从类继承的方法 io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, isSharable

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

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

从接口继承的方法 io.netty.channel.ChannelHandler

handlerRemoved

方法详细资料

onHttpClientUpgrade

public void onHttpClientUpgrade()
                         throws Http2Exception

已过时。

从类复制的说明: Http2ConnectionHandler

Handles the client-side (cleartext) upgrade from HTTP to HTTP/2. Reserves local stream 1 for the HTTP/2 response.

覆盖:

onHttpClientUpgrade 在类中 Http2ConnectionHandler

抛出:

Http2Exception

handlerAdded0

public final void handlerAdded0(ChannelHandlerContext ctx)
                         throws java.lang.Exception

已过时。

抛出:

java.lang.Exception

handlerRemoved0

public final void handlerRemoved0(ChannelHandlerContext ctx)
                           throws java.lang.Exception

已过时。

从类复制的说明: ByteToMessageDecoder

Gets called after the ByteToMessageDecoder was removed from the actual context and it doesn't handle events anymore.

覆盖:

handlerRemoved0 在类中 Http2ConnectionHandler

抛出:

java.lang.Exception

channelReadComplete

public final void channelReadComplete(ChannelHandlerContext ctx)
                               throws java.lang.Exception

已过时。

Notifies any child streams of the read completion.

指定者:

channelReadComplete 在接口中 ChannelInboundHandler

覆盖:

channelReadComplete 在类中 Http2ConnectionHandler

抛出:

java.lang.Exception

channelRead

public final void channelRead(ChannelHandlerContext ctx,
                              java.lang.Object msg)
                       throws java.lang.Exception

已过时。

从类复制的说明: ChannelInboundHandlerAdapter

Calls ChannelHandlerContext.fireChannelRead(Object) to forward to the next ChannelInboundHandler in the ChannelPipeline. Sub-classes may override this method to change behavior.

指定者:

channelRead 在接口中 ChannelInboundHandler

覆盖:

channelRead 在类中 ByteToMessageDecoder

抛出:

java.lang.Exception

channelWritabilityChanged

public final void channelWritabilityChanged(ChannelHandlerContext ctx)
                                     throws java.lang.Exception

已过时。

从类复制的说明: ChannelInboundHandlerAdapter

Calls ChannelHandlerContext.fireChannelWritabilityChanged() to forward to the next ChannelInboundHandler in the ChannelPipeline. Sub-classes may override this method to change behavior.

指定者:

channelWritabilityChanged 在接口中 ChannelInboundHandler

覆盖:

channelWritabilityChanged 在类中 Http2ConnectionHandler

抛出:

java.lang.Exception