org.glassfish.jersey.client.filter
Class EncodingFeature

java.lang.Object
  org.glassfish.jersey.client.filter.EncodingFeature

All Implemented Interfaces:

Feature

public class EncodingFeature
extends java.lang.Object
implements Feature

Feature that configures support for content encodings on the client side. This feature registers EncodingFilter and the specified set of encoding providers to the client configuration. It also allows setting the value of ClientProperties.USE_ENCODING property.

Author:

Martin Matula (martin.matula at oracle.com)

Constructor Summary

EncodingFeature(java.lang.Class<? extends ContentEncoder>... encodingProviders)
Create a new instance of the feature.

EncodingFeature(java.lang.String useEncoding, java.lang.Class<? extends ContentEncoder>... encoders)
Create a new instance of the feature specifying the default value for the ClientProperties.USE_ENCODING property.

Method Summary

boolean

configure(Configurable configuration) A call-back method called when the feature is to be enabled in a given configurable scope.

Methods inherited from class java.lang.Object

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

Constructor Detail

EncodingFeature

public EncodingFeature(java.lang.Class<? extends ContentEncoder>... encodingProviders)

Create a new instance of the feature.

Parameters:

encodingProviders - Encoding providers to be registered in the client configuration.

EncodingFeature

public EncodingFeature(java.lang.String useEncoding,
                       java.lang.Class<? extends ContentEncoder>... encoders)

Create a new instance of the feature specifying the default value for the ClientProperties.USE_ENCODING property. Unless the value is set in the client configuration properties at the time when this feature gets enabled, the provided value will be used.

Parameters:

useEncoding - Default value of ClientProperties.USE_ENCODING property.

encoders - Encoders to be registered in the client configuration.

Method Detail

configure

public boolean configure(Configurable configuration)

Description copied from interface: Feature

A call-back method called when the feature is to be enabled in a given configurable scope. The responsibility of the feature is to properly update the supplied configurable context and return true if the feature was successfully enabled or false otherwise.

Note that under some circumstances the feature may decide not to enable itself, which is indicated by returning false. In such case the configurable context does not internally register the feature in the collection of enabled features and the attempt to enable the feature is ignored.

Specified by:

configure in interface Feature

Parameters:

configuration - configurable context in which the feature should be enabled.

Returns:

true if the feature was successfully enabled, false otherwise.