public class HttpResponseDecoder extends HttpMessageDecoder
ChannelBuffer
s into HttpResponse
s and
HttpChunk
s.
Name | Meaning |
---|---|
maxInitialLineLength |
The maximum length of the initial line (e.g. "HTTP/1.0 200 OK" )
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 response will be
converted to 'chunked' and the content will be split into multiple
HttpChunk s. If the transfer encoding of the HTTP response 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
HttpChunk s in your handler, insert HttpChunkAggregator
after this decoder in the ChannelPipeline . |
Unlike other HTTP requests, the successful response of a HEAD
request does not have any content even if there is Content-Length
header. Because HttpResponseDecoder
is not able to determine if the
response currently being decoded is associated with a HEAD request,
you must override HttpMessageDecoder.isContentAlwaysEmpty(HttpMessage)
to return
true for the response of the HEAD request.
If you are writing an HTTP client that issues a HEAD request,
please use HttpClientCodec
instead of this decoder. It will perform
additional state management to handle the responses for HEAD
requests correctly.
You also need to do additional state management to handle the response of a CONNECT request properly, like you did for HEAD. One difference is that the decoder should stop decoding completely after decoding the successful 200 response since the connection is not an HTTP connection anymore.
HttpClientCodec
also handles this edge case correctly, so you have to
use HttpClientCodec
if you are writing an HTTP client that issues a
CONNECT request.
HttpMessageDecoder.State
ChannelHandler.Sharable
cumulation, DEFAULT_MAX_COMPOSITEBUFFER_COMPONENTS
Constructor and Description |
---|
HttpResponseDecoder()
Creates a new instance with the default
maxInitialLineLength (4096 }, maxHeaderSize (8192) , and
maxChunkSize (8192) . |
HttpResponseDecoder(int maxInitialLineLength,
int maxHeaderSize,
int maxChunkSize)
Creates a new instance with the specified parameters.
|
Modifier and Type | Method and Description |
---|---|
protected HttpMessage |
createMessage(String[] initialLine) |
protected boolean |
isDecodingRequest() |
decode, isContentAlwaysEmpty
checkpoint, checkpoint, cleanup, decode, decodeLast, decodeLast, getState, internalBuffer, messageReceived, setState
actualReadableBytes, afterAdd, afterRemove, appendToCumulation, beforeAdd, beforeRemove, channelClosed, channelDisconnected, exceptionCaught, getMaxCumulationBufferCapacity, getMaxCumulationBufferComponents, isUnfold, newCumulationBuffer, replace, setMaxCumulationBufferCapacity, setMaxCumulationBufferComponents, setUnfold, unfoldAndFireMessageReceived, updateCumulation
channelBound, channelConnected, channelInterestChanged, channelOpen, channelUnbound, childChannelClosed, childChannelOpen, handleUpstream, writeComplete
public HttpResponseDecoder()
maxInitialLineLength (4096
}, maxHeaderSize (8192)
, and
maxChunkSize (8192)
.public HttpResponseDecoder(int maxInitialLineLength, int maxHeaderSize, int maxChunkSize)
protected HttpMessage createMessage(String[] initialLine)
createMessage
in class HttpMessageDecoder
protected boolean isDecodingRequest()
isDecodingRequest
in class HttpMessageDecoder
Copyright © 2008-2013 The Netty Project. All Rights Reserved.