io.netty.handler.codec.http

Class HttpContentCompressor

java.lang.Object

io.netty.channel.ChannelStateHandlerAdapter

io.netty.channel.ChannelHandlerAdapter

io.netty.handler.codec.MessageToMessageCodec<HttpMessage,HttpMessage,Object,Object>

io.netty.handler.codec.http.HttpContentEncoder

io.netty.handler.codec.http.HttpContentCompressor

All Implemented Interfaces:

io.netty.channel.ChannelHandler, io.netty.channel.ChannelInboundHandler, io.netty.channel.ChannelInboundMessageHandler<HttpMessage>, io.netty.channel.ChannelOperationHandler, io.netty.channel.ChannelOutboundHandler, io.netty.channel.ChannelOutboundMessageHandler<Object>, io.netty.channel.ChannelStateHandler

public class HttpContentCompressor
extends HttpContentEncoder

Compresses an HttpMessage and an HttpChunk in gzip or deflate encoding while respecting the "Accept-Encoding" header. If there is no matching encoding, no compression is done. For more information on how this handler modifies the message, please refer to HttpContentEncoder.

Nested Class Summary

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

HttpContentEncoder.Result

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

io.netty.channel.ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor and Description
HttpContentCompressor() Creates a new handler with the default compression level (6), default window size (15) and default memory level (8).
HttpContentCompressor(int compressionLevel) Creates a new handler with the specified compression level, default window size (15) and default memory level (8).
HttpContentCompressor(int compressionLevel, int windowBits, int memLevel) Creates a new handler with the specified compression level, window size, and memory level..

Method Summary

Methods

Modifier and Type	Method and Description
protected HttpContentEncoder.Result	beginEncode(HttpMessage msg, String acceptEncoding) Prepare to encode the HTTP message content.
protected io.netty.handler.codec.compression.ZlibWrapper	determineWrapper(String acceptEncoding)

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

afterRemove, channelInactive, decode, encode, isDecodable, isEncodable

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

flush, inboundBufferUpdated, newInboundBuffer, newOutboundBuffer

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

bind, close, connect, deregister, disconnect

Methods inherited from class io.netty.channel.ChannelStateHandlerAdapter

afterAdd, beforeAdd, beforeRemove, channelActive, channelRegistered, channelUnregistered, exceptionCaught, userEventTriggered

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.netty.channel.ChannelStateHandler

channelActive, channelRegistered, channelUnregistered

Methods inherited from interface io.netty.channel.ChannelOperationHandler

bind, close, connect, deregister, disconnect

Methods inherited from interface io.netty.channel.ChannelHandler

afterAdd, beforeAdd, beforeRemove, exceptionCaught, userEventTriggered

Constructor Detail

HttpContentCompressor

public HttpContentCompressor()

Creates a new handler with the default compression level (6), default window size (15) and default memory level (8).

HttpContentCompressor

public HttpContentCompressor(int compressionLevel)

Creates a new handler with the specified compression level, default window size (15) and default memory level (8).

Parameters:

compressionLevel - 1 yields the fastest compression and 9 yields the best compression. 0 means no compression. The default compression level is 6.

HttpContentCompressor

public HttpContentCompressor(int compressionLevel,
                     int windowBits,
                     int memLevel)

Creates a new handler with the specified compression level, window size, and memory level..

Parameters:

compressionLevel - 1 yields the fastest compression and 9 yields the best compression. 0 means no compression. The default compression level is 6.

windowBits - The base two logarithm of the size of the history buffer. The value should be in the range 9 to 15 inclusive. Larger values result in better compression at the expense of memory usage. The default value is 15.

memLevel - How much memory should be allocated for the internal compression state. 1 uses minimum memory and 9 uses maximum memory. Larger values result in better and faster compression at the expense of memory usage. The default value is 8

Method Detail

beginEncode

protected HttpContentEncoder.Result beginEncode(HttpMessage msg,
                                    String acceptEncoding)
                                         throws Exception

Description copied from class: HttpContentEncoder

Prepare to encode the HTTP message content.

Specified by:

beginEncode in class HttpContentEncoder

Parameters:

msg - the HTTP message whose content should be encoded

acceptEncoding - the value of the "Accept-Encoding" header

Returns:

the result of preparation, which is composed of the determined target content encoding and a new EncoderEmbedder that encodes the content into the target content encoding. null if acceptEncoding is unsupported or rejected and thus the content should be handled as-is (i.e. no encoding).

Throws:

Exception

determineWrapper

protected io.netty.handler.codec.compression.ZlibWrapper determineWrapper(String acceptEncoding)