org.jeesy.classinfo

Class Types

java.lang.Object

org.jeesy.classinfo.Types

public class Types
extends Object

Static methods for working with types that we aren't publishing in the public Types API.

Author:

jessewilson@google.com (Jesse Wilson)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Types.GenericArrayTypeImpl
static class	Types.ParameterizedTypeImpl
static class	Types.WildcardTypeImpl The WildcardType interface supports multiple upper bounds and multiple lower bounds.

Field Summary

Fields

Modifier and Type	Field and Description
static Type[]	EMPTY_TYPE_ARRAY

Method Summary

Methods

Modifier and Type	Method and Description
static GenericArrayType	arrayOf(Type componentType) Returns an array type whose elements are all instances of componentType.
static Type	canonicalize(Type type) Returns a type that is functionally equal but not necessarily equal according to Object.equals().
static void	checkIdenticalTypes(Class expected, Class actual)
static boolean	equals(Type a, Type b) Returns true if a and b are equal.
static Type	getGenericSupertype(Type type, Class<?> rawType, Class<?> toResolve) Returns the generic supertype for type.
static Class<?>	getRawType(Type type)
static ParameterizedType	listOf(Type elementType) Returns a type modelling a List whose elements are of type elementType.
static ParameterizedType	mapOf(Type keyType, Type valueType) Returns a type modelling a Map whose keys are of type keyType and whose values are of type valueType.
static ParameterizedType	newParameterizedType(Type rawType, Type... typeArguments) Returns a new parameterized type, applying typeArguments to rawType.
static ParameterizedType	newParameterizedTypeWithOwner(Type ownerType, Type rawType, Type... typeArguments) Returns a new parameterized type, applying typeArguments to rawType and enclosed by ownerType.
static Type	resolveTypeVariable(Type type, Class<?> rawType, TypeVariable unknown)
static ParameterizedType	setOf(Type elementType) Returns a type modelling a Set whose elements are of type elementType.
static WildcardType	subtypeOf(Type bound) Returns a type that represents an unknown type that extends bound.
static WildcardType	supertypeOf(Type bound) Returns a type that represents an unknown supertype of bound.
static String	typeToString(Type type)

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_TYPE_ARRAY

public static final Type[] EMPTY_TYPE_ARRAY

Method Detail

canonicalize

public static Type canonicalize(Type type)

Returns a type that is functionally equal but not necessarily equal according to Object.equals(). The returned type is Serializable.

getRawType

public static Class<?> getRawType(Type type)

equals

public static boolean equals(Type a,
             Type b)

Returns true if a and b are equal.

typeToString

public static String typeToString(Type type)

getGenericSupertype

public static Type getGenericSupertype(Type type,
                       Class<?> rawType,
                       Class<?> toResolve)

Returns the generic supertype for type. For example, given a class IntegerSet, the result for when supertype is Set.class is Set<Integer> and the result when the supertype is Collection.class is Collection<Integer>.

resolveTypeVariable

public static Type resolveTypeVariable(Type type,
                       Class<?> rawType,
                       TypeVariable unknown)

newParameterizedType

public static ParameterizedType newParameterizedType(Type rawType,
                                     Type... typeArguments)

Returns a new parameterized type, applying typeArguments to rawType. The returned type does not have an owner type.

Returns:

a serializable parameterized type.

newParameterizedTypeWithOwner

public static ParameterizedType newParameterizedTypeWithOwner(Type ownerType,
                                              Type rawType,
                                              Type... typeArguments)

Returns a new parameterized type, applying typeArguments to rawType and enclosed by ownerType.

Returns:

a serializable parameterized type.

arrayOf

public static GenericArrayType arrayOf(Type componentType)

Returns an array type whose elements are all instances of componentType.

Returns:

a serializable generic array type.

subtypeOf

public static WildcardType subtypeOf(Type bound)

Returns a type that represents an unknown type that extends bound. For example, if bound is CharSequence.class, this returns ? extends CharSequence. If bound is Object.class, this returns ?, which is shorthand for ? extends Object.

supertypeOf

public static WildcardType supertypeOf(Type bound)

Returns a type that represents an unknown supertype of bound. For example, if bound is String.class, this returns ? super String.

listOf

public static ParameterizedType listOf(Type elementType)

Returns a type modelling a List whose elements are of type elementType.

Returns:

a serializable parameterized type.

setOf

public static ParameterizedType setOf(Type elementType)

Returns a type modelling a Set whose elements are of type elementType.

Returns:

a serializable parameterized type.

mapOf

public static ParameterizedType mapOf(Type keyType,
                      Type valueType)

Returns a type modelling a Map whose keys are of type keyType and whose values are of type valueType.

Returns:

a serializable parameterized type.

checkIdenticalTypes

public static void checkIdenticalTypes(Class expected,
                       Class actual)