Package io.netty.handler.codec.http3

Class Http3RequestStreamInboundHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.http3.Http3RequestStreamInboundHandler

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler

Direct Known Subclasses:

Http3FrameToHttpObjectCodec

public abstract class Http3RequestStreamInboundHandler
extends ChannelInboundHandlerAdapter

ChannelInboundHandlerAdapter which makes it easy to handle HTTP3 request streams.

Nested Class Summary

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

ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor	Description
Http3RequestStreamInboundHandler()

Method Summary

Modifier and Type	Method	Description
protected abstract void	channelInputClosed(ChannelHandlerContext ctx)	Called once the input is closed and so no more inbound data is received on it.
protected abstract void	channelRead(ChannelHandlerContext ctx, Http3DataFrame frame)	Called once a Http3DataFrame is ready for this stream to process.
protected abstract void	channelRead(ChannelHandlerContext ctx, Http3HeadersFrame frame)	Called once a Http3HeadersFrame is ready for this stream to process.
protected void	channelRead(ChannelHandlerContext ctx, Http3UnknownFrame frame)	Called once a Http3UnknownFrame is ready for this stream to process.
void	channelRead(ChannelHandlerContext ctx, java.lang.Object msg)	Calls ChannelHandlerContext.fireChannelRead(Object) to forward to the next ChannelInboundHandler in the ChannelPipeline.
protected @Nullable QuicStreamChannel	controlStream(ChannelHandlerContext ctx)	Return the local control stream for this HTTP/3 connection.
void	exceptionCaught(ChannelHandlerContext ctx, java.lang.Throwable cause)	Calls ChannelHandlerContext.fireExceptionCaught(Throwable) to forward to the next ChannelHandler in the ChannelPipeline.
protected void	handleHttp3Exception(ChannelHandlerContext ctx, Http3Exception exception)	Called once a Http3Exception should be handled.
protected void	handleQuicException(ChannelHandlerContext ctx, QuicException exception)	Called once a QuicException should be handled.
void	userEventTriggered(ChannelHandlerContext ctx, java.lang.Object evt)	Calls ChannelHandlerContext.fireUserEventTriggered(Object) to forward to the next ChannelInboundHandler in the ChannelPipeline.

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelInactive, channelReadComplete, channelRegistered, channelUnregistered, channelWritabilityChanged

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

handlerAdded, handlerRemoved

Constructor Detail

Http3RequestStreamInboundHandler

public Http3RequestStreamInboundHandler()

Method Detail

channelRead

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

Description copied from class: ChannelInboundHandlerAdapter

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

Specified by:

channelRead in interface ChannelInboundHandler

Overrides:

channelRead in class ChannelInboundHandlerAdapter

Throws:

java.lang.Exception

userEventTriggered

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

Description copied from class: ChannelInboundHandlerAdapter

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

Specified by:

userEventTriggered in interface ChannelInboundHandler

Overrides:

userEventTriggered in class ChannelInboundHandlerAdapter

Throws:

java.lang.Exception

exceptionCaught

public void exceptionCaught(ChannelHandlerContext ctx,
                            java.lang.Throwable cause)

Description copied from class: ChannelInboundHandlerAdapter

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

Specified by:

exceptionCaught in interface ChannelHandler

Specified by:

exceptionCaught in interface ChannelInboundHandler

Overrides:

exceptionCaught in class ChannelInboundHandlerAdapter

channelRead

protected abstract void channelRead(ChannelHandlerContext ctx,
                                    Http3HeadersFrame frame)
                             throws java.lang.Exception

Called once a Http3HeadersFrame is ready for this stream to process.

Parameters:

ctx - the ChannelHandlerContext of this handler.

frame - the Http3HeadersFrame that was read

Throws:

java.lang.Exception - thrown if an error happens during processing.

channelRead

protected abstract void channelRead(ChannelHandlerContext ctx,
                                    Http3DataFrame frame)
                             throws java.lang.Exception

Called once a Http3DataFrame is ready for this stream to process.

Parameters:

ctx - the ChannelHandlerContext of this handler.

frame - the Http3DataFrame that was read

Throws:

java.lang.Exception - thrown if an error happens during processing.

channelInputClosed

protected abstract void channelInputClosed(ChannelHandlerContext ctx)
                                    throws java.lang.Exception

Called once the input is closed and so no more inbound data is received on it.

Parameters:

ctx - the ChannelHandlerContext of this handler.

Throws:

java.lang.Exception - thrown if an error happens during processing.

channelRead

protected void channelRead(ChannelHandlerContext ctx,
                           Http3UnknownFrame frame)

Called once a Http3UnknownFrame is ready for this stream to process. By default these frames are just released and so dropped on the floor as stated in the RFC. That said you may want to override this method if you use some custom frames which are not part of the main spec.

Parameters:

ctx - the ChannelHandlerContext of this handler.

frame - the Http3UnknownFrame that was read

handleQuicException

protected void handleQuicException(ChannelHandlerContext ctx,
                                   QuicException exception)

Called once a QuicException should be handled.

Parameters:

ctx - the ChannelHandlerContext of this handler.

exception - the QuicException that caused the error.

handleHttp3Exception

protected void handleHttp3Exception(ChannelHandlerContext ctx,
                                    Http3Exception exception)

Called once a Http3Exception should be handled.

Parameters:

ctx - the ChannelHandlerContext of this handler.

exception - the Http3Exception that caused the error.

controlStream

@Nullable
protected final @Nullable QuicStreamChannel controlStream(ChannelHandlerContext ctx)

Return the local control stream for this HTTP/3 connection. This can be used to send Http3ControlStreamFrames to the remote peer.

Parameters:

ctx - the ChannelHandlerContext of this handler.

Returns:

the control stream.