public abstract class HttpContentDecoder extends SimpleChannelUpstreamHandler
HttpRequest and HttpChunk.
The original content is replaced with the new content decoded by the
DecoderEmbedder, which is created by newContentDecoder(String).
Once decoding is finished, the value of the 'Content-Encoding'
header is set to the target content encoding, as returned by getTargetContentEncoding(String).
Also, the 'Content-Length' header is updated to the length of the
decoded content. If the content encoding of the original is not supported
by the decoder, newContentDecoder(String) should return null
so that no decoding occurs (i.e. pass-through).
Please note that this is an abstract class. You have to extend this class
and implement newContentDecoder(String) properly to make this class
functional. For example, refer to the source code of HttpContentDecompressor.
This handler must be placed after HttpMessageDecoder in the pipeline
so that this handler can intercept HTTP requests after HttpMessageDecoder
converts ChannelBuffers into HTTP requests.
ChannelHandler.Sharable| Modifier | Constructor and Description |
|---|---|
protected |
HttpContentDecoder()
Creates a new instance.
|
| Modifier and Type | Method and Description |
|---|---|
protected String |
getTargetContentEncoding(String contentEncoding)
Returns the expected content encoding of the decoded content.
|
void |
messageReceived(ChannelHandlerContext ctx,
MessageEvent e)
Invoked when a message object (e.g:
ChannelBuffer) was received
from a remote peer. |
protected abstract DecoderEmbedder<ChannelBuffer> |
newContentDecoder(String contentEncoding)
Returns a new
DecoderEmbedder that decodes the HTTP message
content encoded in the specified contentEncoding. |
channelBound, channelClosed, channelConnected, channelDisconnected, channelInterestChanged, channelOpen, channelUnbound, childChannelClosed, childChannelOpen, exceptionCaught, handleUpstream, writeCompletepublic void messageReceived(ChannelHandlerContext ctx, MessageEvent e) throws Exception
SimpleChannelUpstreamHandlerChannelBuffer) was received
from a remote peer.messageReceived in class SimpleChannelUpstreamHandlerExceptionprotected abstract DecoderEmbedder<ChannelBuffer> newContentDecoder(String contentEncoding) throws Exception
DecoderEmbedder that decodes the HTTP message
content encoded in the specified contentEncoding.contentEncoding - the value of the "Content-Encoding" headerDecoderEmbedder if the specified encoding is supported.
null otherwise (alternatively, you can throw an exception
to block unknown encoding).Exceptionprotected String getTargetContentEncoding(String contentEncoding) throws Exception
"identity" by default, which is the case for
most decoders.contentEncoding - the value of the "Content-Encoding" headerExceptionCopyright © 2008-2012 JBoss, a division of Red Hat, Inc.. All Rights Reserved.