org.glassfish.jersey.server.filter

Class EncodingFilter

java.lang.Object

org.glassfish.jersey.server.filter.EncodingFilter

All Implemented Interfaces:

ContainerResponseFilter

@Priority(value=3000)
public final class EncodingFilter
extends Object
implements ContainerResponseFilter

Container filter that supports encoding-based content negotiation. The filter examines what content encodings are supported by the container (by looking up all the encoders) and decides what encoding should be chosen based on the encodings listed in the Accept-Encoding request header and their associated quality values. If none of the acceptable encodings is supported and identity encoding is explicitly forbidden by the client, the filter generates Response.Status.NOT_ACCEPTABLE response.

The filter also ensures Accept-Encoding is added to the Vary header, for proper interaction with web caches.

Author:

Martin Matula (martin.matula at oracle.com)

Constructor Summary

Constructors

Constructor and Description
EncodingFilter()

Method Summary

Methods

Modifier and Type	Method and Description
static void	enableFor(ResourceConfig rc, Class<? extends ContentEncoder>... encoders) Enables this filter along with the provided encoders for the supplied ResourceConfig.
void	filter(ContainerRequestContext request, ContainerResponseContext response) Filter method called after a response has been provided for a request (either by a request filter or by a matched resource method.

Methods inherited from class java.lang.Object

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

Constructor Detail

EncodingFilter

public EncodingFilter()

Method Detail

enableFor

public static void enableFor(ResourceConfig rc,
             Class<? extends ContentEncoder>... encoders)

Enables this filter along with the provided encoders for the supplied ResourceConfig.

Parameters:

rc - Resource config this filter should be enabled for.

filter

public void filter(ContainerRequestContext request,
          ContainerResponseContext response)
            throws IOException

Description copied from interface: ContainerResponseFilter

Filter method called after a response has been provided for a request (either by a request filter or by a matched resource method.

Filters in the filter chain are ordered according to their javax.annotation.Priority class-level annotation value.

Specified by:

filter in interface ContainerResponseFilter

Parameters:

request - request context.

response - response context.

Throws:

IOException - if an I/O exception occurs.