org.codehaus.jackson.map.type
Class TypeFactory

java.lang.Object
  org.codehaus.jackson.map.type.TypeFactory

public class TypeFactory
extends Object

Class that knows how construct JavaType instances, given various inputs.

Field Summary

protected HashMap<String,JavaType>	_commonTypeCache To optimize a common use case, we will use a lookup cache to map straight from raw (type erased) Class instances to matching types, for common simple classes.
static TypeFactory	instance

Constructor Summary

protected

TypeFactory()

Method Summary

protected JavaType	_fromArrayType(GenericArrayType type, JavaType context)
protected JavaType	_fromClass(Class<?> clz, Map<String,JavaType> genericParams)
protected JavaType	_fromParamType(ParameterizedType type, JavaType context) This method deals with parameterized types, that is, first class generic classes.
JavaType	_fromType(Type type, JavaType context) Factory method that can be used if type information is passed as Java typing returned from getGenericXxx methods (usually for a return or argument type).
protected JavaType	_fromVariable(TypeVariable<?> type, JavaType context)
protected JavaType	_fromWildcard(WildcardType type, JavaType context)
static JavaType	fromClass(Class<?> clz) Factory method that can be used if only type information available is of type Class.
static JavaType	fromType(Type type) Factory method that can be used if type information is passed as Java typing returned from getGenericXxx methods (usually for a return or argument type).
static JavaType	fromType(Type type, JavaType context)
static JavaType	fromTypeReference(TypeReference<?> ref) Factory method that can be used if the full generic type has been passed using TypeReference.

Methods inherited from class java.lang.Object

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

Field Detail

instance

public static final TypeFactory instance

_commonTypeCache

protected final HashMap<String,JavaType> _commonTypeCache

To optimize a common use case, we will use a lookup cache to map straight from raw (type erased) Class instances to matching types, for common simple classes. Not that this lookup Map must not contain anything that could accidentally mask real typed information; specifically, no Map or Collection types are allowed to be added, and similarly only those Array typed where element type can not be a parameterized type. Also: only those classes that are always loaded by the bootstrap class loader (i.e. JDK core classes) can be mapped this way, since we do not include class loader information.

Constructor Detail

TypeFactory

protected TypeFactory()

Method Detail

fromClass

public static JavaType fromClass(Class<?> clz)

Factory method that can be used if only type information available is of type Class. This means that there will not be generic type information due to type erasure, but at least it will be possible to recognize array types and non-typed container types. And for other types (primitives/wrappers, beans), this is all that is needed.

fromTypeReference

public static JavaType fromTypeReference(TypeReference<?> ref)

Factory method that can be used if the full generic type has been passed using TypeReference. This only needs to be done if the root type to bind to is generic; but if so, it must be done to get proper typing.

fromType

public static JavaType fromType(Type type)

Factory method that can be used if type information is passed as Java typing returned from getGenericXxx methods (usually for a return or argument type).

fromType

public static JavaType fromType(Type type,
                                JavaType context)

Parameters:

context - Type context that can be used for binding named formal type parameters, if any (if null, no context is used)

_fromClass

protected JavaType _fromClass(Class<?> clz,
                              Map<String,JavaType> genericParams)

Parameters:

genericParams - Mapping of formal parameter declarations (for generic types) into actual types

_fromType

public JavaType _fromType(Type type,
                          JavaType context)

Factory method that can be used if type information is passed as Java typing returned from getGenericXxx methods (usually for a return or argument type).

_fromParamType

protected JavaType _fromParamType(ParameterizedType type,
                                  JavaType context)

This method deals with parameterized types, that is, first class generic classes. We actually only care about generics iff they are of type Map or Collection -- otherwise we'll just use the raw type. This because we have no idea how to handle genericized classes in, well, generic fashion. For other types we will then just fall back to using "raw" class information.

_fromArrayType

protected JavaType _fromArrayType(GenericArrayType type,
                                  JavaType context)

_fromVariable

protected JavaType _fromVariable(TypeVariable<?> type,
                                 JavaType context)

_fromWildcard

protected JavaType _fromWildcard(WildcardType type,
                                 JavaType context)