io.netty.handler.codec.http2

Class Http2MultiplexCodec

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.channel.ChannelDuplexHandler

io.netty.handler.codec.http2.Http2MultiplexCodec

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler, ChannelOutboundHandler

public final class Http2MultiplexCodec
extends ChannelDuplexHandler

An HTTP/2 handler that creates child channels for each stream. Creating outgoing streams is not yet supported. Server-side HTTP to HTTP/2 upgrade is supported in conjunction with Http2ServerUpgradeCodec; the necessary HTTP-to-HTTP/2 conversion is performed automatically.

This API is very immature. The Http2Connection-based API is currently preferred over this API. This API is targeted to eventually replace or reduce the need for the Http2Connection-based API.

This handler notifies the pipeline of channel events, such as Http2GoAwayFrame. It is also capable of writing such messages. Directly writing Http2StreamFrames for this handler is unsupported.

Child Channels

When a new stream is created, a new Channel is created for it. Applications send and receive Http2StreamFrames on the created channel. The Http2StreamFrame.stream() is expected to be null, but the channel can use the field for its own bookkeeping. 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.

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

Nested Class Summary

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

ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor and Description
Http2MultiplexCodec(boolean server, ChannelHandler streamHandler) Construct a new handler whose child channels run in the same event loop as this handler.
Http2MultiplexCodec(boolean server, ChannelHandler streamHandler, EventLoopGroup streamGroup) Construct a new handler whose child channels run in a different event loop.

Method Summary

Methods

Modifier and Type	Method and Description
void	channelReadComplete(ChannelHandlerContext ctx) Notifies any child streams of the read completion.
void	handlerAdded(ChannelHandlerContext ctx) Save context and load any dependencies.
void	handlerRemoved(ChannelHandlerContext ctx) Clean up any dependencies.
void	userEventTriggered(ChannelHandlerContext ctx, Object evt) Handles the cleartext HTTP upgrade event.
void	write(ChannelHandlerContext ctx, Object msg, ChannelPromise promise) Processes all Http2Frames.

Methods inherited from class io.netty.channel.ChannelDuplexHandler

bind, close, connect, deregister, disconnect, flush, read

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelInactive, channelRead, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

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

Constructor Detail

Http2MultiplexCodec

public Http2MultiplexCodec(boolean server,
                   ChannelHandler streamHandler)

Construct a new handler whose child channels run in the same event loop as this handler.

Parameters:

server - true this is a server

streamHandler - the handler added to channels for remotely-created streams. It must be ChannelHandler.Sharable.

Http2MultiplexCodec

public Http2MultiplexCodec(boolean server,
                   ChannelHandler streamHandler,
                   EventLoopGroup streamGroup)

Construct a new handler whose child channels run in a different event loop.

Parameters:

server - true this is a server

streamHandler - the handler added to channels for remotely-created streams. It must be ChannelHandler.Sharable.

streamGroup - event loop for registering child channels

Method Detail

handlerAdded

public void handlerAdded(ChannelHandlerContext ctx)
                  throws Exception

Save context and load any dependencies.

Specified by:

handlerAdded in interface ChannelHandler

Overrides:

handlerAdded in class ChannelHandlerAdapter

Throws:

Exception

handlerRemoved

public void handlerRemoved(ChannelHandlerContext ctx)
                    throws Exception

Clean up any dependencies.

Specified by:

handlerRemoved in interface ChannelHandler

Overrides:

handlerRemoved in class ChannelHandlerAdapter

Throws:

Exception

userEventTriggered

public void userEventTriggered(ChannelHandlerContext ctx,
                      Object evt)
                        throws Exception

Handles the cleartext HTTP upgrade event. If an upgrade occurred, sends a simple response via HTTP/2 on stream 1 (the stream specifically reserved for cleartext HTTP upgrade).

Specified by:

userEventTriggered in interface ChannelInboundHandler

Overrides:

userEventTriggered in class ChannelInboundHandlerAdapter

Throws:

Exception

write

public void write(ChannelHandlerContext ctx,
         Object msg,
         ChannelPromise promise)
           throws Exception

Processes all Http2Frames. Http2StreamFrames may only originate in child streams.

Specified by:

write in interface ChannelOutboundHandler

Overrides:

write in class ChannelDuplexHandler

Parameters:

ctx - the ChannelHandlerContext for which the write operation is made

msg - the message to write

promise - the ChannelPromise to notify once the operation completes

Throws:

Exception - thrown if an error accour

channelReadComplete

public void channelReadComplete(ChannelHandlerContext ctx)

Notifies any child streams of the read completion.

Specified by:

channelReadComplete in interface ChannelInboundHandler

Overrides:

channelReadComplete in class ChannelInboundHandlerAdapter