io.netty.handler.codec.http2

Class DefaultHttp2FrameReader

java.lang.Object

io.netty.handler.codec.http2.DefaultHttp2FrameReader

All Implemented Interfaces:

Http2FrameReader, Http2FrameReader.Configuration, Http2FrameSizePolicy, Closeable, AutoCloseable

@UnstableApi
public class DefaultHttp2FrameReader
extends Object
implements Http2FrameReader, Http2FrameSizePolicy, Http2FrameReader.Configuration

A Http2FrameReader that supports all frame types defined by the HTTP/2 specification.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DefaultHttp2FrameReader.HeadersBlockBuilder Utility class to help with construction of the headers block that may potentially span multiple frames.

Nested classes/interfaces inherited from interface io.netty.handler.codec.http2.Http2FrameReader

Http2FrameReader.Configuration

Constructor Summary

Constructors

Constructor and Description
DefaultHttp2FrameReader() Create a new instance.
DefaultHttp2FrameReader(boolean validateHeaders) Create a new instance.
DefaultHttp2FrameReader(Http2HeadersDecoder headersDecoder)

Method Summary

Modifier and Type	Method and Description
void	close() Closes this reader and frees any allocated resources.
Http2FrameReader.Configuration	configuration() Get the configuration related elements for this Http2FrameReader
Http2FrameSizePolicy	frameSizePolicy() Get the Http2FrameSizePolicy for this Http2FrameReader
Http2HeadersDecoder.Configuration	headersConfiguration() Get the Http2HeadersDecoder.Configuration for this Http2FrameReader
int	maxFrameSize() Gets the maximum allowed frame size.
void	maxFrameSize(int max) Sets the maximum allowed frame size.
void	readFrame(ChannelHandlerContext ctx, ByteBuf input, Http2FrameListener listener) Attempts to read the next frame from the input buffer.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultHttp2FrameReader

public DefaultHttp2FrameReader()

Create a new instance.

Header names will be validated.

DefaultHttp2FrameReader

public DefaultHttp2FrameReader(boolean validateHeaders)

Create a new instance.

Parameters:

validateHeaders - true to validate headers. false to not validate headers.

See Also:

DefaultHttp2HeadersDecoder(boolean)

DefaultHttp2FrameReader

public DefaultHttp2FrameReader(Http2HeadersDecoder headersDecoder)

Method Detail

headersConfiguration

public Http2HeadersDecoder.Configuration headersConfiguration()

Description copied from interface: Http2FrameReader.Configuration

Get the Http2HeadersDecoder.Configuration for this Http2FrameReader

Specified by:

headersConfiguration in interface Http2FrameReader.Configuration

configuration

public Http2FrameReader.Configuration configuration()

Description copied from interface: Http2FrameReader

Get the configuration related elements for this Http2FrameReader

Specified by:

configuration in interface Http2FrameReader

frameSizePolicy

public Http2FrameSizePolicy frameSizePolicy()

Description copied from interface: Http2FrameReader.Configuration

Get the Http2FrameSizePolicy for this Http2FrameReader

Specified by:

frameSizePolicy in interface Http2FrameReader.Configuration

maxFrameSize

public void maxFrameSize(int max)
                  throws Http2Exception

Description copied from interface: Http2FrameSizePolicy

Sets the maximum allowed frame size. Attempts to write frames longer than this maximum will fail.

This value is used to represent SETTINGS_MAX_FRAME_SIZE. This method should only be called by Netty (not users) as a result of a receiving a SETTINGS frame.

Specified by:

maxFrameSize in interface Http2FrameSizePolicy

Throws:

Http2Exception

maxFrameSize

public int maxFrameSize()

Description copied from interface: Http2FrameSizePolicy

Gets the maximum allowed frame size.

This value is used to represent SETTINGS_MAX_FRAME_SIZE. The initial value defined by the RFC is unlimited but enforcing a lower limit is generally permitted. Http2CodecUtil.DEFAULT_MAX_FRAME_SIZE can be used as a more conservative default.

Specified by:

maxFrameSize in interface Http2FrameSizePolicy

close

public void close()

Description copied from interface: Http2FrameReader

Closes this reader and frees any allocated resources.

Specified by:

close in interface Http2FrameReader

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

readFrame

public void readFrame(ChannelHandlerContext ctx,
                      ByteBuf input,
                      Http2FrameListener listener)
               throws Http2Exception

Description copied from interface: Http2FrameReader

Attempts to read the next frame from the input buffer. If enough data is available to fully read the frame, notifies the listener of the read frame.

Specified by:

readFrame in interface Http2FrameReader

Throws:

Http2Exception