Package org.jboss.netty.handler.codec.http

Class HttpContentCompressor

java.lang.Object

org.jboss.netty.channel.SimpleChannelHandler

org.jboss.netty.handler.codec.http.HttpContentEncoder

org.jboss.netty.handler.codec.http.HttpContentCompressor

All Implemented Interfaces:

ChannelDownstreamHandler, ChannelHandler, ChannelUpstreamHandler, LifeCycleAwareChannelHandler

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 interface org.jboss.netty.channel.ChannelHandler

ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field	Description
private final int	compressionLevel
private static final int	DEFAULT_JDK_MEM_LEVEL
private static final int	DEFAULT_JDK_WINDOW_SIZE
private static final InternalLogger	logger
private final int	memLevel
private static final boolean	noJdkZlibEncoder
private final int	windowBits

Constructor Summary

Constructors

Constructor	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

Modifier and Type	Method	Description
private static ZlibWrapper	determineWrapper(String acceptEncoding)
protected String	getTargetContentEncoding(String acceptEncoding)	Returns the expected content encoding of the encoded content.
protected EncoderEmbedder<ChannelBuffer>	newContentEncoder(HttpMessage msg, String acceptEncoding)	Returns a new EncoderEmbedder that encodes the HTTP message content.

Methods inherited from class org.jboss.netty.handler.codec.http.HttpContentEncoder

afterAdd, afterRemove, beforeAdd, beforeRemove, channelClosed, messageReceived, writeRequested

Methods inherited from class org.jboss.netty.channel.SimpleChannelHandler

bindRequested, channelBound, channelConnected, channelDisconnected, channelInterestChanged, channelOpen, channelUnbound, childChannelClosed, childChannelOpen, closeRequested, connectRequested, disconnectRequested, exceptionCaught, handleDownstream, handleUpstream, setInterestOpsRequested, unbindRequested, writeComplete

Methods inherited from class java.lang.Object

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

Field Details

logger

private static final InternalLogger logger

DEFAULT_JDK_WINDOW_SIZE

private static final int DEFAULT_JDK_WINDOW_SIZE

See Also:

• Constant Field Values

DEFAULT_JDK_MEM_LEVEL

private static final int DEFAULT_JDK_MEM_LEVEL

See Also:

• Constant Field Values

noJdkZlibEncoder

private static final boolean noJdkZlibEncoder

compressionLevel

private final int compressionLevel

windowBits

private final int windowBits

memLevel

private final int memLevel

Constructor Details

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 Details

newContentEncoder

protected EncoderEmbedder<ChannelBuffer> newContentEncoder(HttpMessage msg,
 String acceptEncoding)
                                                    throws Exception

Description copied from class: HttpContentEncoder

Returns a new EncoderEmbedder that encodes the HTTP message content.

Specified by:

newContentEncoder in class HttpContentEncoder

Parameters:

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

Returns:

a new EncoderEmbedder if there is a supported encoding in acceptEncoding. null otherwise.

Throws:

Exception

getTargetContentEncoding

protected String getTargetContentEncoding(String acceptEncoding)
                                   throws Exception

Description copied from class: HttpContentEncoder

Returns the expected content encoding of the encoded content.

Specified by:

getTargetContentEncoding in class HttpContentEncoder

Parameters:

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

Returns:

the expected content encoding of the new content

Throws:

Exception

determineWrapper

private static ZlibWrapper determineWrapper(String acceptEncoding)