org.eclipse.jetty.servlets.gzip

Class GzipHandler

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.handler.AbstractHandler

org.eclipse.jetty.server.handler.AbstractHandlerContainer

org.eclipse.jetty.server.handler.HandlerWrapper

org.eclipse.jetty.servlets.gzip.GzipHandler

All Implemented Interfaces:

Handler, HandlerContainer, Container, Destroyable, Dumpable, LifeCycle

public class GzipHandler
extends HandlerWrapper

GZIP Handler This handler will gzip the content of a response if:

• The handler is mapped to a matching path
• The response status code is >=200 and <300
• The content length is unknown or more than the minGzipSize initParameter or the minGzipSize is 0(default)
• The content-type matches one of the set of mimetypes to be compressed
• The content-type does NOT match one of the set of mimetypes AND setExcludeMimeTypes is true
• No content-encoding is specified by the resource

Compressing the content can greatly improve the network bandwidth usage, but at a cost of memory and CPU cycles. If this handler is used for static content, then use of efficient direct NIO may be prevented, thus use of the gzip mechanism of the org.eclipse.jetty.servlet.DefaultServlet is advised instead.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Field Summary

Fields

Modifier and Type	Field and Description
protected int	_bufferSize
protected Set<String>	_excludedUA
protected boolean	_excludeMimeTypes
protected Set<String>	_mimeTypes
protected int	_minGzipSize
protected String	_vary

Fields inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

_handler

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
GzipHandler() Instantiates a new gzip handler.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doStart() Starts the managed lifecycle beans in the order they were added.
int	getBufferSize() Get the buffer size.
Set<String>	getExcluded() Get the excluded user agents.
Set<String>	getMimeTypes() Get the mime types.
int	getMinGzipSize() Get the minimum reponse size.
String	getVary()
void	handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response) Handle a request.
protected CompressedResponseWrapper	newGzipResponseWrapper(HttpServletRequest request, HttpServletResponse response) Allows derived implementations to replace ResponseWrapper implementation.
protected PrintWriter	newWriter(OutputStream out, String encoding) Allows derived implementations to replace PrintWriter implementation.
void	setBufferSize(int bufferSize) Set the buffer size.
void	setExcluded(Set<String> excluded) Set the excluded user agents.
void	setExcluded(String excluded) Set the excluded user agents.
void	setExcludeMimeTypes(boolean exclude) Set the mime types.
void	setMimeTypes(Set<String> mimeTypes) Set the mime types.
void	setMimeTypes(String mimeTypes) Set the mime types.
void	setMinGzipSize(int minGzipSize) Set the minimum reponse size.
void	setVary(String vary) Set the value of the Vary header sent with responses that could be compressed.

Methods inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

destroy, expandChildren, getHandler, getHandlers, setHandler, setServer

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandlerContainer

expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler

doStop, dumpThis, getServer

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Field Detail

_mimeTypes

protected final Set<String> _mimeTypes

_excludeMimeTypes

protected boolean _excludeMimeTypes

_excludedUA

protected Set<String> _excludedUA

_bufferSize

protected int _bufferSize

_minGzipSize

protected int _minGzipSize

_vary

protected String _vary

Constructor Detail

GzipHandler

public GzipHandler()

Instantiates a new gzip handler.

Method Detail

getMimeTypes

public Set<String> getMimeTypes()

Get the mime types.

Returns:

mime types to set

setMimeTypes

public void setMimeTypes(Set<String> mimeTypes)

Set the mime types.

Parameters:

mimeTypes - the mime types to set

setMimeTypes

public void setMimeTypes(String mimeTypes)

Set the mime types.

Parameters:

mimeTypes - the mime types to set

setExcludeMimeTypes

public void setExcludeMimeTypes(boolean exclude)

Set the mime types.

getExcluded

public Set<String> getExcluded()

Get the excluded user agents.

Returns:

excluded user agents

setExcluded

public void setExcluded(Set<String> excluded)

Set the excluded user agents.

Parameters:

excluded - excluded user agents to set

setExcluded

public void setExcluded(String excluded)

Set the excluded user agents.

Parameters:

excluded - excluded user agents to set

getVary

public String getVary()

Returns:

The value of the Vary header set if a response can be compressed.

setVary

public void setVary(String vary)

Set the value of the Vary header sent with responses that could be compressed.

By default it is set to 'Accept-Encoding, User-Agent' since IE6 is excluded by default from the excludedAgents. If user-agents are not to be excluded, then this can be set to 'Accept-Encoding'. Note also that shared caches may cache many copies of a resource that is varied by User-Agent - one per variation of the User-Agent, unless the cache does some normalization of the UA string.

Parameters:

vary - The value of the Vary header set if a response can be compressed.

getBufferSize

public int getBufferSize()

Get the buffer size.

Returns:

the buffer size

setBufferSize

public void setBufferSize(int bufferSize)

Set the buffer size.

Parameters:

bufferSize - buffer size to set

getMinGzipSize

public int getMinGzipSize()

Get the minimum reponse size.

Returns:

minimum reponse size

setMinGzipSize

public void setMinGzipSize(int minGzipSize)

Set the minimum reponse size.

Parameters:

minGzipSize - minimum reponse size

doStart

protected void doStart()
                throws Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class AbstractHandler

Throws:

Exception

handle

public void handle(String target,
          Request baseRequest,
          HttpServletRequest request,
          HttpServletResponse response)
            throws IOException,
                   ServletException

Description copied from interface: Handler

Handle a request.

Specified by:

handle in interface Handler

Overrides:

handle in class HandlerWrapper

Parameters:

target - The target of the request - either a URI or a name.

baseRequest - The original unwrapped request object.

request - The request either as the Request object or a wrapper of that request. The HttpChannel.getCurrentHttpChannel() method can be used access the Request object if required.

response - The response as the Response object or a wrapper of that request. The HttpChannel.getCurrentHttpChannel() method can be used access the Response object if required.

Throws:

IOException

ServletException

See Also:

HandlerWrapper.handle(java.lang.String, org.eclipse.jetty.server.Request, javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)

newGzipResponseWrapper

protected CompressedResponseWrapper newGzipResponseWrapper(HttpServletRequest request,
                                               HttpServletResponse response)

Allows derived implementations to replace ResponseWrapper implementation.

Parameters:

request - the request

response - the response

Returns:

the gzip response wrapper

newWriter

protected PrintWriter newWriter(OutputStream out,
                    String encoding)
                         throws UnsupportedEncodingException

Allows derived implementations to replace PrintWriter implementation.

Parameters:

out - the out

encoding - the encoding

Returns:

the prints the writer

Throws:

UnsupportedEncodingException