org.glassfish.jersey.internal.inject

Class ParamConverterFactory

java.lang.Object

org.glassfish.jersey.internal.inject.ParamConverterFactory

All Implemented Interfaces:

ParamConverterProvider

@Singleton
public class ParamConverterFactory
extends Object
implements ParamConverterProvider

An aggregate param converter provider that loads all the registered ParamConverterProvider implementations.

When invoked, the provider iterates through the registered implementations until it finds the first implementation that returns a non-null param converter, which is subsequently returned from the factory. In case no non-null string reader instance is found, null is returned from the factory. Custom providers are iterated first, so that user registered providers are preferred against internal jersey providers.

Author:

Paul Sandoz, Marek Potociar, Miroslav Fuksa

Constructor Summary

Constructors

Constructor and Description
ParamConverterFactory(Set<ParamConverterProvider> providers, Set<ParamConverterProvider> customProviders)

Method Summary

Modifier and Type	Method and Description
<T> ParamConverter<T>	getConverter(Class<T> rawType, Type genericType, Annotation[] annotations) Obtain a ParamConverter that can provide from/to string conversion for an instance of a particular Java type.

Methods inherited from class java.lang.Object

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

Constructor Detail

ParamConverterFactory

public ParamConverterFactory(Set<ParamConverterProvider> providers,
                             Set<ParamConverterProvider> customProviders)

Method Detail

getConverter

public <T> ParamConverter<T> getConverter(Class<T> rawType,
                                          Type genericType,
                                          Annotation[] annotations)

Description copied from interface: ParamConverterProvider

Obtain a ParamConverter that can provide from/to string conversion for an instance of a particular Java type.

Specified by:

getConverter in interface ParamConverterProvider

Type Parameters:

T - the supported Java type convertible to/from a String format.

Parameters:

rawType - the raw type of the object to be converted.

genericType - the type of object to be converted. E.g. if an String value representing the injected request parameter is to be converted into a method parameter, this will be the formal type of the method parameter as returned by Class.getGenericParameterTypes.

annotations - an array of the annotations associated with the convertible parameter instance. E.g. if a string value is to be converted into a method parameter, this would be the annotations on that parameter as returned by Method.getParameterAnnotations().

Returns:

the string converter, otherwise null.