org.foxlabs.util.reflect

Class Types

java.lang.Object

org.foxlabs.util.reflect.Types

public abstract class Types
extends Object

Helper class used for working with java types.

Author:

Fox Mulder

Constructor Summary

Constructors

Constructor and Description
Types()

Method Summary

Methods

Modifier and Type	Method and Description
static <T,E> Class<T>	arrayTypeOf(Class<E> elementType) Returns array type for the specified type of array elements.
static <T> T	cast(Object obj) Casts an object.
static <T> T	defaultValueOf(Class<T> type) Returns default value for the specified type.
static <T> Class<T>	elementTypeOf(Type type) Returns raw element (value) type for the specified generic array, collection or map type.
static int	hashCode(Class<?>... types) Returns a hash code value for the specified array of types.
static boolean	isBoolean(Class<?> type) Determines if the specified type is a boolean type (either primitive or object).
static boolean	isByte(Class<?> type) Determines if the specified type is a byte type (either primitive or object).
static boolean	isDouble(Class<?> type) Determines if the specified type is a double type (either primitive or object).
static boolean	isFloat(Class<?> type) Determines if the specified type is a float type (either primitive or object).
static boolean	isInteger(Class<?> type) Determines if the specified type is an integer type (either primitive or object).
static boolean	isLong(Class<?> type) Determines if the specified type is a long type (either primitive or object).
static boolean	isObject(Class<?> type) Determines if the specified type is an object type (not a primitive, array, enum or annotation).
static boolean	isShort(Class<?> type) Determines if the specified type is a short type (either primitive or object).
static <T> Class<T>	keyTypeOf(Type type) Returns raw key type for the specified generic map type.
static <T,E> T	newArray(Class<E> elementType, int length) Creates a new array for the specified type of array elements.
static <T extends Collection<E>,E> T	newCollection(Class<T> type, int size) Creates a new collection of the specified type.
static <T> T	newInstance(Class<T> type) Creates a new object instance of the specified type.
static <T extends List<E>,E> T	newList(Class<T> type, int size) Creates a new list of the specified type.
static <T extends Map<K,V>,K,V> T	newMap(Class<T> type, int size) Creates a new map of the specified type.
static <T extends Queue<E>,E> T	newQueue(Class<T> type, int size) Creates a new queue of the specified type.
static <T extends Set<E>,E> T	newSet(Class<T> type, int size) Creates a new set of the specified type.
static Class<?>	parameterTypeOf(Class<?> type, Class<?> base, int index) Returns the type of parameter with the specified index for the specified type.
static Class<?>	primitiveTypeOf(Class<?> type) Returns corresponding primitive type for the specified wrapper type.
static <T> Class<T>	rawTypeOf(Type type) Returns raw type for the specified generic type.
static Class<?>	superTypeOf(Class<?>... types) Returns super type for the specified array of types.
static Class<?>	superTypeOf(Class<?> type) Returns super type for the specified type.
static Class<?>	superTypeOf(Class<?> type1, Class<?> type2) Returns super type for the specified two types.
static Class<?>[]	typesOf(Object... objs) Returns array of types for the specified array of objects.
static <T> Class<T>	wrapperTypeOf(Class<T> type) Returns corresponding wrapper type for the specified primitive type.

Methods inherited from class java.lang.Object

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

Constructor Detail

Types

public Types()

Method Detail

cast

public static <T> T cast(Object obj)

Casts an object.

Parameters:

obj - The object to be cast.

Returns:

The object after casting.

typesOf

public static Class<?>[] typesOf(Object... objs)

Returns array of types for the specified array of objects. Note that type for null elements is java.lang.Object type.

Parameters:

objs - Array of objects.

Returns:

Array of types for the specified array of objects.

isBoolean

public static boolean isBoolean(Class<?> type)

Determines if the specified type is a boolean type (either primitive or object).

Parameters:

type - The type to test.

Returns:

true if the specified type is a boolean type; false otherwise.

isByte

public static boolean isByte(Class<?> type)

Determines if the specified type is a byte type (either primitive or object).

Parameters:

type - The type to test.

Returns:

true if the specified type is a byte type; false otherwise.

isShort

public static boolean isShort(Class<?> type)

Determines if the specified type is a short type (either primitive or object).

Parameters:

type - The type to test.

Returns:

true if the specified type is a short type; false otherwise.

isInteger

public static boolean isInteger(Class<?> type)

Determines if the specified type is an integer type (either primitive or object).

Parameters:

type - The type to test.

Returns:

true if the specified type is an integer type; false otherwise.

isLong

public static boolean isLong(Class<?> type)

Determines if the specified type is a long type (either primitive or object).

Parameters:

type - The type to test.

Returns:

true if the specified type is a long type; false otherwise.

isFloat

public static boolean isFloat(Class<?> type)

Determines if the specified type is a float type (either primitive or object).

Parameters:

type - The type to test.

Returns:

true if the specified type is a float type; false otherwise.

isDouble

public static boolean isDouble(Class<?> type)

Determines if the specified type is a double type (either primitive or object).

Parameters:

type - The type to test.

Returns:

true if the specified type is a double type; false otherwise.

isObject

public static boolean isObject(Class<?> type)

Determines if the specified type is an object type (not a primitive, array, enum or annotation).

Parameters:

type - The type to test.

Returns:

true if the specified type is an object type; false otherwise.

wrapperTypeOf

public static <T> Class<T> wrapperTypeOf(Class<T> type)

Returns corresponding wrapper type for the specified primitive type. This method has no effect if the specified type is not primitive type.

Parameters:

type - Primitive type.

Returns:

Wrapper type for the specified primitive type.

primitiveTypeOf

public static Class<?> primitiveTypeOf(Class<?> type)

Returns corresponding primitive type for the specified wrapper type. This method has no effect if the specified type is not wrapper type.

Parameters:

type - Wrapper type.

Returns:

Primitive type for the specified wrapper type.

defaultValueOf

public static <T> T defaultValueOf(Class<T> type)

Returns default value for the specified type. Note that this method can return default value for primitive types only. For other types it returns null.

Parameters:

type - The type for which default value should be returned.

Returns:

Default value for the specified type.

superTypeOf

public static Class<?> superTypeOf(Class<?> type)

Returns super type for the specified type. Actually, this method just checks if the specified type is null and returns java.lang.Object type if so.

Parameters:

type - The type to test.

Returns:

Super type for the specified type.

superTypeOf

public static Class<?> superTypeOf(Class<?> type1,
                   Class<?> type2)

Returns super type for the specified two types.

Parameters:

type1 - First type.

type2 - Second type.

Returns:

Super type for the specified two types.

superTypeOf

public static Class<?> superTypeOf(Class<?>... types)

Returns super type for the specified array of types.

Parameters:

types - Array of types.

Returns:

Super type for the specified array of types.

rawTypeOf

public static <T> Class<T> rawTypeOf(Type type)

Returns raw type for the specified generic type.

Parameters:

type - Generic type.

Returns:

Raw type for the specified generic type.

arrayTypeOf

public static <T,E> Class<T> arrayTypeOf(Class<E> elementType)

Returns array type for the specified type of array elements.

Parameters:

elementType - Type of array elements.

Returns:

Array type for the specified type of array elements.

elementTypeOf

public static <T> Class<T> elementTypeOf(Type type)

Returns raw element (value) type for the specified generic array, collection or map type. Note that this method returns null if the specified type is not array, collection or map type.

Parameters:

type - Generic array, collection or map type.

Returns:

Raw element (value) type for the specified type.

keyTypeOf

public static <T> Class<T> keyTypeOf(Type type)

Returns raw key type for the specified generic map type. Note that this method returns null if the specified type is not map type.

Parameters:

type - Generic map type.

Returns:

Raw key type for the specified type.

parameterTypeOf

public static Class<?> parameterTypeOf(Class<?> type,
                       Class<?> base,
                       int index)

Returns the type of parameter with the specified index for the specified type.

Parameters:

type - Subtype.

base - Base super type.

index - Parameter index.

Returns:

The type of parameter with the specified index for the specified type.

newInstance

public static <T> T newInstance(Class<T> type)

Creates a new object instance of the specified type.

Parameters:

type - The type of object to be created.

Returns:

A new object instance of the specified type.

Throws:

RuntimeException - if object instantiation fails.

newArray

public static <T,E> T newArray(Class<E> elementType,
               int length)

Creates a new array for the specified type of array elements.

Parameters:

elementType - The type of array elements.

length - Length of the new array.

Returns:

A new array for the specified type of array elements.

newCollection

public static <T extends Collection<E>,E> T newCollection(Class<T> type,
                                          int size)

Creates a new collection of the specified type.

Parameters:

type - The type of collection to be created.

size - Initial size of the new collection.

Returns:

A new collection of the specified type.

newList

public static <T extends List<E>,E> T newList(Class<T> type,
                              int size)

Creates a new list of the specified type.

Parameters:

type - The type of list to be created.

size - Initial size of the new list.

Returns:

A new list of the specified type.

newSet

public static <T extends Set<E>,E> T newSet(Class<T> type,
                            int size)

Creates a new set of the specified type.

Parameters:

type - The type of set to be created.

size - Initial size of the new set.

Returns:

A new set of the specified type.

newQueue

public static <T extends Queue<E>,E> T newQueue(Class<T> type,
                                int size)

Creates a new queue of the specified type.

Parameters:

type - The type of queue to be created.

size - Initial size of the new queue.

Returns:

A new queue of the specified type.

newMap

public static <T extends Map<K,V>,K,V> T newMap(Class<T> type,
                                int size)

Creates a new map of the specified type.

Parameters:

type - The type of map to be created.

size - Initial size of the new map.

Returns:

A new map of the specified type.

hashCode

public static int hashCode(Class<?>... types)

Returns a hash code value for the specified array of types.

Parameters:

types - Array of types.

Returns:

A hash code value for the specified array of types.