io.netty.handler.codec.http

类 HttpRequestDecoder

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

io.netty.handler.codec.http.HttpObjectDecoder

io.netty.handler.codec.http.HttpRequestDecoder

所有已实现的接口:

ChannelHandler, ChannelInboundHandler

public class HttpRequestDecoder
extends HttpObjectDecoder

Decodes ByteBufs into HttpRequests and HttpContents.

Parameters that prevents excessive memory consumption

Name	Meaning
maxInitialLineLength	The maximum length of the initial line (e.g. "GET / HTTP/1.0") If the length of the initial line exceeds this value, a TooLongHttpLineException will be raised.
maxHeaderSize	The maximum length of all headers. If the sum of the length of each header exceeds this value, a TooLongHttpHeaderException will be raised.
maxChunkSize	The maximum length of the content or each chunk. If the content length exceeds this value, the transfer encoding of the decoded request will be converted to 'chunked' and the content will be split into multiple HttpContents. If the transfer encoding of the HTTP request is 'chunked' already, each chunk will be split into smaller chunks if the length of the chunk exceeds this value. If you prefer not to handle HttpContents in your handler, insert HttpObjectAggregator after this decoder in the ChannelPipeline.

Parameters that control parsing behavior

Name	Default value	Meaning
allowDuplicateContentLengths		When set to false, will reject any messages that contain multiple Content-Length header fields. When set to true, will allow multiple Content-Length headers only if they are all the same decimal value. The duplicated field-values will be replaced with a single valid Content-Length field. See RFC 7230, Section 3.3.2.
allowPartialChunks		If the length of a chunk exceeds the ByteBufs readable bytes and allowPartialChunks is set to true, the chunk will be split into multiple HttpContents. Otherwise, if the chunk size does not exceed maxChunkSize and allowPartialChunks is set to false, the ByteBuf is not decoded into an HttpContent until the readable bytes are greater or equal to the chunk size.

Header Validation

It is recommended to always enable header validation.

Without header validation, your system can become vulnerable to CWE-113: Improper Neutralization of CRLF Sequences in HTTP Headers ('HTTP Response Splitting') .

This recommendation stands even when both peers in the HTTP exchange are trusted, as it helps with defence-in-depth.

嵌套类概要

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

ByteToMessageDecoder.Cumulator

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

ChannelHandler.Sharable

字段概要

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

DEFAULT_ALLOW_DUPLICATE_CONTENT_LENGTHS, DEFAULT_ALLOW_PARTIAL_CHUNKS, DEFAULT_CHUNKED_SUPPORTED, DEFAULT_INITIAL_BUFFER_SIZE, DEFAULT_MAX_CHUNK_SIZE, DEFAULT_MAX_HEADER_SIZE, DEFAULT_MAX_INITIAL_LINE_LENGTH, DEFAULT_VALIDATE_HEADERS, headersFactory, trailersFactory, validateHeaders

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

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

构造器概要

构造器

构造器和说明
HttpRequestDecoder() Creates a new instance with the default maxInitialLineLength (4096), maxHeaderSize (8192), and maxChunkSize (8192).
HttpRequestDecoder(HttpDecoderConfig config) Creates a new instance with the specified configuration.
HttpRequestDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize) Creates a new instance with the specified parameters.
HttpRequestDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize, boolean validateHeaders) 已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.
HttpRequestDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize, boolean validateHeaders, int initialBufferSize) 已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.
HttpRequestDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize, boolean validateHeaders, int initialBufferSize, boolean allowDuplicateContentLengths) 已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.
HttpRequestDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize, boolean validateHeaders, int initialBufferSize, boolean allowDuplicateContentLengths, boolean allowPartialChunks) 已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.

方法概要

限定符和类型	方法和说明
protected HttpMessage	createInvalidMessage()
protected HttpMessage	createMessage(java.lang.String[] initialLine)
protected boolean	isContentAlwaysEmpty(HttpMessage msg)
protected boolean	isDecodingRequest()
protected java.lang.String	splitFirstWordInitialLine(byte[] sb, int start, int length)
protected AsciiString	splitHeaderName(byte[] sb, int start, int length)
protected java.lang.String	splitThirdWordInitialLine(byte[] sb, int start, int length)

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

decode, decodeLast, handlerRemoved0, handleTransferEncodingChunkedWithContentLength, isSwitchingToNonHttp1Protocol, isValidating, reset, splitSecondWordInitialLine, userEventTriggered

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

actualReadableBytes, callDecode, channelInactive, channelRead, channelReadComplete, discardSomeReadBytes, handlerRemoved, internalBuffer, isSingleDecode, setCumulator, setDiscardAfterReads, setSingleDecode

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

channelActive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught

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

ensureNotSharable, handlerAdded, isSharable

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

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

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

handlerAdded

构造器详细资料

HttpRequestDecoder

public HttpRequestDecoder()

Creates a new instance with the default maxInitialLineLength (4096), maxHeaderSize (8192), and maxChunkSize (8192).

HttpRequestDecoder

public HttpRequestDecoder(int maxInitialLineLength,
                          int maxHeaderSize,
                          int maxChunkSize)

Creates a new instance with the specified parameters.

HttpRequestDecoder

@Deprecated
public HttpRequestDecoder(int maxInitialLineLength,
                                       int maxHeaderSize,
                                       int maxChunkSize,
                                       boolean validateHeaders)

已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.

HttpRequestDecoder

@Deprecated
public HttpRequestDecoder(int maxInitialLineLength,
                                       int maxHeaderSize,
                                       int maxChunkSize,
                                       boolean validateHeaders,
                                       int initialBufferSize)

已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.

HttpRequestDecoder

@Deprecated
public HttpRequestDecoder(int maxInitialLineLength,
                                       int maxHeaderSize,
                                       int maxChunkSize,
                                       boolean validateHeaders,
                                       int initialBufferSize,
                                       boolean allowDuplicateContentLengths)

已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.

HttpRequestDecoder

@Deprecated
public HttpRequestDecoder(int maxInitialLineLength,
                                       int maxHeaderSize,
                                       int maxChunkSize,
                                       boolean validateHeaders,
                                       int initialBufferSize,
                                       boolean allowDuplicateContentLengths,
                                       boolean allowPartialChunks)

已过时。 Prefer the HttpRequestDecoder(HttpDecoderConfig) constructor, to always have header validation enabled.

HttpRequestDecoder

public HttpRequestDecoder(HttpDecoderConfig config)

Creates a new instance with the specified configuration.

方法详细资料

createMessage

protected HttpMessage createMessage(java.lang.String[] initialLine)
                             throws java.lang.Exception

指定者:

createMessage 在类中 HttpObjectDecoder

抛出:

java.lang.Exception

splitHeaderName

protected AsciiString splitHeaderName(byte[] sb,
                                      int start,
                                      int length)

覆盖:

splitHeaderName 在类中 HttpObjectDecoder

splitFirstWordInitialLine

protected java.lang.String splitFirstWordInitialLine(byte[] sb,
                                                     int start,
                                                     int length)

覆盖:

splitFirstWordInitialLine 在类中 HttpObjectDecoder

splitThirdWordInitialLine

protected java.lang.String splitThirdWordInitialLine(byte[] sb,
                                                     int start,
                                                     int length)

覆盖:

splitThirdWordInitialLine 在类中 HttpObjectDecoder

createInvalidMessage

protected HttpMessage createInvalidMessage()

指定者:

createInvalidMessage 在类中 HttpObjectDecoder

isDecodingRequest

protected boolean isDecodingRequest()

指定者:

isDecodingRequest 在类中 HttpObjectDecoder

isContentAlwaysEmpty

protected boolean isContentAlwaysEmpty(HttpMessage msg)

覆盖:

isContentAlwaysEmpty 在类中 HttpObjectDecoder