io.netty.handler.codec.http2

类 DefaultHttp2HeadersDecoder

java.lang.Object

io.netty.handler.codec.http2.DefaultHttp2HeadersDecoder

所有已实现的接口:

Http2HeadersDecoder, Http2HeadersDecoder.Configuration

@UnstableApi
public class DefaultHttp2HeadersDecoder
extends java.lang.Object
implements Http2HeadersDecoder, Http2HeadersDecoder.Configuration

嵌套类概要

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

Http2HeadersDecoder.Configuration

构造器概要

构造器

构造器和说明
DefaultHttp2HeadersDecoder()
DefaultHttp2HeadersDecoder(boolean validateHeaders) Create a new instance.
DefaultHttp2HeadersDecoder(boolean validateHeaders, boolean validateHeaderValues) Create a new instance.
DefaultHttp2HeadersDecoder(boolean validateHeaders, boolean validateHeaderValues, long maxHeaderListSize) Create a new instance.
DefaultHttp2HeadersDecoder(boolean validateHeaders, long maxHeaderListSize) Create a new instance.
DefaultHttp2HeadersDecoder(boolean validateHeaders, long maxHeaderListSize, int initialHuffmanDecodeCapacity) Create a new instance.

方法概要

限定符和类型	方法和说明
Http2HeadersDecoder.Configuration	configuration() Get the Http2HeadersDecoder.Configuration for this Http2HeadersDecoder
Http2Headers	decodeHeaders(int streamId, ByteBuf headerBlock) Decodes the given headers block and returns the headers.
long	maxHeaderListSize() Represents the value for SETTINGS_MAX_HEADER_LIST_SIZE.
void	maxHeaderListSize(long max, long goAwayMax) Configure the maximum allowed size in bytes of each set of headers.
long	maxHeaderListSizeGoAway() Represents the upper bound in bytes for a set of headers before a GO_AWAY should be sent.
long	maxHeaderTableSize() Represents the value for SETTINGS_HEADER_TABLE_SIZE.
void	maxHeaderTableSize(long max) Represents the value for SETTINGS_HEADER_TABLE_SIZE.
protected Http2Headers	newHeaders() Create a new Http2Headers object which will store the results of the decode operation.
protected int	numberOfHeadersGuess() A weighted moving average estimating how many headers are expected during the decode process.
protected boolean	validateHeaders() Determines if the headers should be validated as a result of the decode operation.
protected boolean	validateHeaderValues() Determines if the header values should be validated as a result of the decode operation.

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

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

构造器详细资料

DefaultHttp2HeadersDecoder

public DefaultHttp2HeadersDecoder()

DefaultHttp2HeadersDecoder

public DefaultHttp2HeadersDecoder(boolean validateHeaders)

Create a new instance.

参数:

validateHeaders - true to validate headers are valid according to the RFC.

DefaultHttp2HeadersDecoder

public DefaultHttp2HeadersDecoder(boolean validateHeaders,
                                  boolean validateHeaderValues)

Create a new instance.

参数:

validateHeaders - true to validate headers are valid according to the RFC. This validates everything except header values.

validateHeaderValues - true to validate that header values are valid according to the RFC. Since this is potentially expensive, it can be enabled separately from validateHeaders.

DefaultHttp2HeadersDecoder

public DefaultHttp2HeadersDecoder(boolean validateHeaders,
                                  long maxHeaderListSize)

Create a new instance.

参数:

validateHeaders - true to validate headers are valid according to the RFC.

maxHeaderListSize - This is the only setting that can be configured before notifying the peer. This is because SETTINGS_MAX_HEADER_LIST_SIZE allows a lower than advertised limit from being enforced, and the default limit is unlimited (which is dangerous).

DefaultHttp2HeadersDecoder

public DefaultHttp2HeadersDecoder(boolean validateHeaders,
                                  boolean validateHeaderValues,
                                  long maxHeaderListSize)

Create a new instance.

参数:

validateHeaders - true to validate headers are valid according to the RFC. This validates everything except header values.

validateHeaderValues - true to validate that header values are valid according to the RFC. Since this is potentially expensive, it can be enabled separately from validateHeaders.

maxHeaderListSize - This is the only setting that can be configured before notifying the peer. This is because SETTINGS_MAX_HEADER_LIST_SIZE allows a lower than advertised limit from being enforced, and the default limit is unlimited (which is dangerous).

DefaultHttp2HeadersDecoder

public DefaultHttp2HeadersDecoder(boolean validateHeaders,
                                  long maxHeaderListSize,
                                  @Deprecated
                                  int initialHuffmanDecodeCapacity)

Create a new instance.

参数:

validateHeaders - true to validate headers are valid according to the RFC. This validates everything except header values.

maxHeaderListSize - This is the only setting that can be configured before notifying the peer. This is because SETTINGS_MAX_HEADER_LIST_SIZE allows a lower than advertised limit from being enforced, and the default limit is unlimited (which is dangerous).

initialHuffmanDecodeCapacity - Does nothing, do not use.

方法详细资料

maxHeaderTableSize

public void maxHeaderTableSize(long max)
                        throws Http2Exception

从接口复制的说明: Http2HeadersDecoder.Configuration

Represents the value for SETTINGS_HEADER_TABLE_SIZE. This method should only be called by Netty (not users) as a result of a receiving a SETTINGS frame.

指定者:

maxHeaderTableSize 在接口中 Http2HeadersDecoder.Configuration

抛出:

Http2Exception

maxHeaderTableSize

public long maxHeaderTableSize()

从接口复制的说明: Http2HeadersDecoder.Configuration

Represents the value for SETTINGS_HEADER_TABLE_SIZE. The initial value returned by this method must be Http2CodecUtil.DEFAULT_HEADER_TABLE_SIZE.

指定者:

maxHeaderTableSize 在接口中 Http2HeadersDecoder.Configuration

maxHeaderListSize

public void maxHeaderListSize(long max,
                              long goAwayMax)
                       throws Http2Exception

从接口复制的说明: Http2HeadersDecoder.Configuration

Configure the maximum allowed size in bytes of each set of headers.

This method should only be called by Netty (not users) as a result of a receiving a SETTINGS frame.

指定者:

maxHeaderListSize 在接口中 Http2HeadersDecoder.Configuration

参数:

max - SETTINGS_MAX_HEADER_LIST_SIZE. If this limit is exceeded the implementation should attempt to keep the HPACK header tables up to date by processing data from the peer, but a RST_STREAM frame will be sent for the offending stream.

goAwayMax - Must be >= max. A GO_AWAY frame will be generated if this limit is exceeded for any particular stream.

抛出:

Http2Exception - if limits exceed the RFC's boundaries or max > goAwayMax.

maxHeaderListSize

public long maxHeaderListSize()

从接口复制的说明: Http2HeadersDecoder.Configuration

Represents the value for SETTINGS_MAX_HEADER_LIST_SIZE.

指定者:

maxHeaderListSize 在接口中 Http2HeadersDecoder.Configuration

maxHeaderListSizeGoAway

public long maxHeaderListSizeGoAway()

从接口复制的说明: Http2HeadersDecoder.Configuration

Represents the upper bound in bytes for a set of headers before a GO_AWAY should be sent. This will be <= SETTINGS_MAX_HEADER_LIST_SIZE.

指定者:

maxHeaderListSizeGoAway 在接口中 Http2HeadersDecoder.Configuration

configuration

public Http2HeadersDecoder.Configuration configuration()

从接口复制的说明: Http2HeadersDecoder

Get the Http2HeadersDecoder.Configuration for this Http2HeadersDecoder

指定者:

configuration 在接口中 Http2HeadersDecoder

decodeHeaders

public Http2Headers decodeHeaders(int streamId,
                                  ByteBuf headerBlock)
                           throws Http2Exception

从接口复制的说明: Http2HeadersDecoder

Decodes the given headers block and returns the headers.

指定者:

decodeHeaders 在接口中 Http2HeadersDecoder

抛出:

Http2Exception

numberOfHeadersGuess

protected final int numberOfHeadersGuess()

A weighted moving average estimating how many headers are expected during the decode process.

返回:

an estimate of how many headers are expected during the decode process.

validateHeaders

protected final boolean validateHeaders()

Determines if the headers should be validated as a result of the decode operation.

Note: This does not include validation of header values, since that is potentially expensive to do. Value validation is instead enabled separately.

返回:

true if the headers should be validated as a result of the decode operation.

validateHeaderValues

protected boolean validateHeaderValues()

Determines if the header values should be validated as a result of the decode operation.

Note: This only validates the values of headers. All other header validations are instead enabled separately.

返回:

true if the header values should be validated as a result of the decode operation.

newHeaders

protected Http2Headers newHeaders()

Create a new Http2Headers object which will store the results of the decode operation.

返回:

a new Http2Headers object which will store the results of the decode operation.