io.netty.handler.codec.http

Class HttpRequestDecoder

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

io.netty.handler.codec.http.HttpObjectDecoder

io.netty.handler.codec.http.HttpRequestDecoder

All Implemented Interfaces:

ChannelHandler

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 TooLongFrameException will be raised.
maxHeaderSize	The maximum length of all headers. If the sum of the length of each header exceeds this value, a TooLongFrameException 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.

Nested Class Summary

Nested classes/interfaces inherited from class io.netty.handler.codec.ByteToMessageDecoder

ByteToMessageDecoder.Cumulator

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

ChannelHandler.Sharable, ChannelHandler.Skip

Field Summary

Fields inherited from class io.netty.handler.codec.http.HttpObjectDecoder

validateHeaders

Fields inherited from class io.netty.handler.codec.ByteToMessageDecoder

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

Constructor Summary

Constructors

Constructor and Description
HttpRequestDecoder() Creates a new instance with the default maxInitialLineLength (4096), maxHeaderSize (8192), and maxChunkSize (8192).
HttpRequestDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize) Creates a new instance with the specified parameters.
HttpRequestDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize, boolean validateHeaders)

Method Summary

Methods

Modifier and Type	Method and Description
protected HttpMessage	createInvalidMessage()
protected HttpMessage	createMessage(String[] initialLine)
protected boolean	isDecodingRequest()

Methods inherited from class io.netty.handler.codec.http.HttpObjectDecoder

decode, decodeLast, isContentAlwaysEmpty, reset

Methods inherited from class io.netty.handler.codec.ByteToMessageDecoder

actualReadableBytes, callDecode, channelInactive, channelRead, channelReadComplete, handlerRemoved, handlerRemoved0, internalBuffer, isSingleDecode, setCumulator, setSingleDecode

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

bind, channelActive, channelRegistered, channelUnregistered, channelWritabilityChanged, close, connect, deregister, disconnect, exceptionCaught, flush, handlerAdded, isSharable, read, userEventTriggered, write

Methods inherited from class java.lang.Object

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

Constructor Detail

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

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

Method Detail

createMessage

protected HttpMessage createMessage(String[] initialLine)
                             throws Exception

Specified by:

createMessage in class HttpObjectDecoder

Throws:

Exception

createInvalidMessage

protected HttpMessage createInvalidMessage()

Specified by:

createInvalidMessage in class HttpObjectDecoder

isDecodingRequest

protected boolean isDecodingRequest()

Specified by:

isDecodingRequest in class HttpObjectDecoder