net.sf.mmm.util.reflect.base

Class ReflectionUtilLimitedImpl

java.lang.Object

net.sf.mmm.util.component.base.AbstractComponent

net.sf.mmm.util.component.base.AbstractLoggableComponent

net.sf.mmm.util.reflect.base.ReflectionUtilLimitedImpl

All Implemented Interfaces:

GenericTypeFactory, ReflectionUtilLimited

Direct Known Subclasses:

ReflectionUtilImpl

public class ReflectionUtilLimitedImpl
extends AbstractLoggableComponent
implements ReflectionUtilLimited

This is the implementation of the ReflectionUtilLimited interface. It is strictly GWT compatible.

Since:

3.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields

Modifier and Type	Field and Description
private static ReflectionUtilLimited	INSTANCE

Fields inherited from interface net.sf.mmm.util.reflect.api.ReflectionUtilLimited

NO_ARGUMENTS, NO_PARAMETERS

Constructor Summary

Constructors

Constructor and Description
ReflectionUtilLimitedImpl() The constructor.

Method Summary

Modifier and Type	Method and Description
<T> GenericType<T>	createGenericType(Class<T> type) This method creates the GenericType representing the given type.
GenericType<?>	createGenericType(Type type) This method creates the GenericType representing the given type.
GenericType<?>	createGenericType(Type type, Class<?> definingType) This method creates the GenericType representing the given type in the context of the given definingType.
GenericType<?>	createGenericType(Type type, GenericType<?> definingType) This method creates the GenericType representing the given type in the context of the given definingType.
<E> GenericType<List<E>>	createGenericTypeOfList(GenericType<E> elementType)
<K,V> GenericType<Map<K,V>>	createGenericTypeOfMap(GenericType<K> keyType, GenericType<V> valueType)
<E> GenericType<Set<E>>	createGenericTypeOfSet(GenericType<E> elementType)
static ReflectionUtilLimited	getInstance()
<T> Class<T>	getNonPrimitiveType(Class<T> type) This method gets the according non-primitive type for the class given by type.

Methods inherited from class net.sf.mmm.util.component.base.AbstractLoggableComponent

createLogger, doInitialize, getLogger

Methods inherited from class net.sf.mmm.util.component.base.AbstractComponent

doInitialized, getInitializationState, initialize

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

private static final ReflectionUtilLimited INSTANCE

Constructor Detail

ReflectionUtilLimitedImpl

public ReflectionUtilLimitedImpl()

The constructor.

Method Detail

getInstance

public static ReflectionUtilLimited getInstance()

Returns:

the instance

getNonPrimitiveType

public <T> Class<T> getNonPrimitiveType(Class<T> type)

Description copied from interface: ReflectionUtilLimited

This method gets the according non-primitive type for the class given by type.
E.g. getNonPrimitiveType(int.class) will return Integer.class.

Specified by:

getNonPrimitiveType in interface ReflectionUtilLimited

Type Parameters:

T - is the generic type of the given type Class.

Parameters:

type - is the (potentially) primitive type.

Returns:

the according object-type for the given type. This will be the given type itself if it is NOT primitive.

See Also:

Class.isPrimitive()

createGenericType

public <T> GenericType<T> createGenericType(Class<T> type)

Description copied from interface: GenericTypeFactory

This method creates the GenericType representing the given type.
The type, lower bound and upper bound of the returned GenericType will all be identical to the given type.
ATTENTION:
If you know the Type where the given type was defined you should use GenericTypeFactory.createGenericType(Type, GenericType) instead to get a more precise result.

Specified by:

createGenericType in interface GenericTypeFactory

Type Parameters:

T - is the generic type of the Class to convert.

Parameters:

type - is the Type to represent.

Returns:

the according GenericType.

createGenericType

public GenericType<?> createGenericType(Type type)

Description copied from interface: GenericTypeFactory

This method creates the GenericType representing the given type.
If the given type is a Class, the methods behaves like GenericTypeFactory.createGenericType(Class).
ATTENTION:
If you know the Type where the given type was defined (e.g. the Class where you retrieved the given type from as parameter, return-type or field-type) you should use GenericTypeFactory.createGenericType(Type, GenericType) instead to get a more precise result.

Specified by:

createGenericType in interface GenericTypeFactory

Parameters:

type - is the Type to represent.

Returns:

the according GenericType.

createGenericType

public GenericType<?> createGenericType(Type type,
                                        GenericType<?> definingType)

Description copied from interface: GenericTypeFactory

This method creates the GenericType representing the given type in the context of the given definingType.
Here is some typical example of how to use this:

 ReflectionUtil util = ReflectionUtilImpl.getInstance();
 Class<?> myClass = getSomeClass();
 GenericType definingType = util.createGenericType(myClass);
 Method myMethod = findSomeMethod(myClass);
 Type returnType = myMethod.getGenericReturnType();
 GenericType type = util.createGenericType(returnType, definingType);
 Class<?> returnClass = type.GenericType.getRetrievalClass();
 

Now if you ask your self why all this instead of just using myMethod. getReturnType()? Read the javadoc of GenericType to get the answer.
NOTE:
Please look at mmm-util-pojo which allows to use this features at a higher level and therefore much easier.

Specified by:

createGenericType in interface GenericTypeFactory

Parameters:

type - is the Type to represent.

definingType - is the GenericType where the given type is defined in. It is needed to resolve TypeVariables.

Returns:

the according GenericType.

See Also:

GenericTypeFactory.createGenericType(Type, Class)

createGenericType

public GenericType<?> createGenericType(Type type,
                                        Class<?> definingType)

Description copied from interface: GenericTypeFactory

This method creates the GenericType representing the given type in the context of the given definingType.
It is a convenience method for createGenericType(type, createGenericType(definingType))

Specified by:

createGenericType in interface GenericTypeFactory

Parameters:

type - is the Type to represent.

definingType - is the Class where the given type is defined in. It is needed to resolve TypeVariables.

Returns:

the according GenericType.

createGenericTypeOfList

public <E> GenericType<List<E>> createGenericTypeOfList(GenericType<E> elementType)

Specified by:

createGenericTypeOfList in interface GenericTypeFactory

Type Parameters:

E - the generic type of the List elements.

Parameters:

elementType - the GenericType to be bound for <E>.

Returns:

the according GenericType.

createGenericTypeOfMap

public <K,V> GenericType<Map<K,V>> createGenericTypeOfMap(GenericType<K> keyType,
                                                          GenericType<V> valueType)

Specified by:

createGenericTypeOfMap in interface GenericTypeFactory

Type Parameters:

K - the generic type of the Map keys.

V - the generic type of the Map values.

Parameters:

keyType - the GenericType to be bound for <K>.

valueType - the GenericType to be bound for <V>.

Returns:

the according GenericType.

createGenericTypeOfSet

public <E> GenericType<Set<E>> createGenericTypeOfSet(GenericType<E> elementType)

Specified by:

createGenericTypeOfSet in interface GenericTypeFactory

Type Parameters:

E - the generic type of the Set elements.

Parameters:

elementType - the GenericType to be bound for <E>.

Returns:

the according GenericType.