public abstract class HttpContentDecoder extends SimpleChannelUpstreamHandler implements LifeCycleAwareChannelHandler
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 ChannelBuffer
s into HTTP requests.
ChannelHandler.Sharable
限定符 | 构造器和说明 |
---|---|
protected |
HttpContentDecoder()
Creates a new instance.
|
限定符和类型 | 方法和说明 |
---|---|
void |
afterAdd(ChannelHandlerContext ctx) |
void |
afterRemove(ChannelHandlerContext ctx) |
void |
beforeAdd(ChannelHandlerContext ctx) |
void |
beforeRemove(ChannelHandlerContext ctx) |
void |
channelClosed(ChannelHandlerContext ctx,
ChannelStateEvent e)
Invoked when a
Channel was closed and all its related resources
were released. |
protected java.lang.String |
getTargetContentEncoding(java.lang.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(java.lang.String contentEncoding)
Returns a new
DecoderEmbedder that decodes the HTTP message
content encoded in the specified contentEncoding. |
channelBound, channelConnected, channelDisconnected, channelInterestChanged, channelOpen, channelUnbound, childChannelClosed, childChannelOpen, exceptionCaught, handleUpstream, writeComplete
public void messageReceived(ChannelHandlerContext ctx, MessageEvent e) throws java.lang.Exception
SimpleChannelUpstreamHandler
ChannelBuffer
) was received
from a remote peer.messageReceived
在类中 SimpleChannelUpstreamHandler
java.lang.Exception
public void channelClosed(ChannelHandlerContext ctx, ChannelStateEvent e) throws java.lang.Exception
SimpleChannelUpstreamHandler
Channel
was closed and all its related resources
were released.channelClosed
在类中 SimpleChannelUpstreamHandler
java.lang.Exception
protected abstract DecoderEmbedder<ChannelBuffer> newContentDecoder(java.lang.String contentEncoding) throws java.lang.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).java.lang.Exception
protected java.lang.String getTargetContentEncoding(java.lang.String contentEncoding) throws java.lang.Exception
"identity"
by default, which is the case for
most decoders.contentEncoding
- the value of the "Content-Encoding"
headerjava.lang.Exception
public void beforeAdd(ChannelHandlerContext ctx) throws java.lang.Exception
beforeAdd
在接口中 LifeCycleAwareChannelHandler
java.lang.Exception
public void afterAdd(ChannelHandlerContext ctx) throws java.lang.Exception
afterAdd
在接口中 LifeCycleAwareChannelHandler
java.lang.Exception
public void beforeRemove(ChannelHandlerContext ctx) throws java.lang.Exception
beforeRemove
在接口中 LifeCycleAwareChannelHandler
java.lang.Exception
public void afterRemove(ChannelHandlerContext ctx) throws java.lang.Exception
afterRemove
在接口中 LifeCycleAwareChannelHandler
java.lang.Exception