org.eclipse.jetty.server.handler

## Class GzipHandler

- java.lang.Object
- - org.eclipse.jetty.util.component.AbstractLifeCycle
  - - org.eclipse.jetty.util.component.AggregateLifeCycle
    - - org.eclipse.jetty.server.handler.AbstractHandler
      - - org.eclipse.jetty.server.handler.AbstractHandlerContainer
        - - org.eclipse.jetty.server.handler.HandlerWrapper
          - - org.eclipse.jetty.server.handler.GzipHandler

- All Implemented Interfaces:
    Handler, HandlerContainer, Destroyable, Dumpable, LifeCycle

      public class GzipHandler
      extends HandlerWrapper

  GZIP Handler This handler will gzip the content of a response if:
  - The filter 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 is in the comma separated list of mimeTypes set in the `mimeTypes` initParameter or if no mimeTypes are defined the content-type is not "application/gzip"
  - 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`

  - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `protected int` | `_bufferSize`
    `protected Set<String>` | `_excluded`
    `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

      `_listeners, 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
    --- | ---
    `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, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)` Handle a request.
    `protected CompressedResponseWrapper` | `newGzipResponseWrapper(javax.servlet.http.HttpServletRequest request, javax.servlet.http.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` | `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, doStart, doStop, expandChildren, getHandler, getHandlers, getNestedHandlerByClass, setHandler, setServer`

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

      `dump, expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass`

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

      `dumpThis, getServer`

    - ### Methods inherited from class org.eclipse.jetty.util.component.AggregateLifeCycle

      `addBean, addBean, contains, dump, dump, dump, dump, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, unmanage`

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

      `addLifeCycleListener, getState, getState, 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 Set<String> _mimeTypes

    - #### _excluded

          protected Set<String> _excluded

    - #### _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

    - #### 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

    - #### handle

          public void handle(String target,
                    Request baseRequest,
                    javax.servlet.http.HttpServletRequest request,
                    javax.servlet.http.HttpServletResponse response)
                      throws IOException,
                             javax.servlet.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 `AbstractHttpConnection.getCurrentConnection()` method can be used access the Request object if required.
        `response` - The response as the `Response` object or a wrapper of that request. The `AbstractHttpConnection.getCurrentConnection()` method can be used access the Response object if required.
      Throws:
        `IOException`
        `javax.servlet.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(javax.servlet.http.HttpServletRequest request,
                                                         javax.servlet.http.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`

Copyright © 1995-2013 Mort Bay Consulting. All Rights Reserved.