org.jboss.weld.util.reflection

Class Reflections

java.lang.Object

org.jboss.weld.util.reflection.Reflections

public class Reflections
extends java.lang.Object

Utility class for static reflection-type operations

Author:

Pete Muir, Ales Justin, Marko Luksa

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.annotation.Annotation[]	EMPTY_ANNOTATIONS
static java.lang.Class<?>[]	EMPTY_CLASSES
static java.lang.reflect.Type[]	EMPTY_TYPES

Constructor Summary

Constructors

Constructor and Description
Reflections()

Method Summary

Methods

Modifier and Type	Method and Description
static java.util.Map<java.lang.Class<?>,java.lang.reflect.Type>	buildTypeMap(java.util.Set<java.lang.reflect.Type> types)
static <T> T	cast(java.lang.Object obj)
static boolean	containsWildcards(java.lang.reflect.Type[] types)
static java.lang.reflect.Type[]	getActualTypeArguments(java.lang.reflect.Type type) Gets the actual type arguments of a Type
static int	getNesting(java.lang.Class<?> clazz)
static java.lang.Object	getNonPrivateFinalMethodOrType(java.lang.Class<?> type)
static java.lang.String	getPropertyName(java.lang.reflect.Method method) Gets the property name from a getter method.
static <T> java.lang.Class<T>	getRawType(java.lang.reflect.Type type)
static boolean	isAbstract(java.lang.reflect.Method method) Checks if a method is abstract
static boolean	isArrayType(java.lang.Class<?> rawType) Checks if raw type is array type
static boolean	isAssignableFrom(java.util.Set<java.lang.reflect.Type> types1, java.util.Set<java.lang.reflect.Type> types2) Check the assiginability of a set of flattened types.
static boolean	isAssignableFrom(java.util.Set<java.lang.reflect.Type> types1, java.lang.reflect.Type type2) Check the assiginability of a set of flattened types.
static boolean	isAssignableFrom(java.lang.reflect.Type[] types1, java.lang.reflect.Type type2)
static boolean	isAssignableFrom(java.lang.reflect.Type type1, java.util.Set<? extends java.lang.reflect.Type> types2)
static boolean	isAssignableFrom(java.lang.reflect.Type type1, java.lang.reflect.Type type2)
static boolean	isAssignableFrom(java.lang.reflect.Type type1, java.lang.reflect.Type[] types2)
static boolean	isAssignableTo(java.lang.reflect.Type type1, java.lang.reflect.Type[] types2)
static boolean	isBindings(java.lang.annotation.Annotation binding) Deprecated.
static boolean	isCacheable(java.lang.annotation.Annotation[] annotations)
static boolean	isCacheable(java.util.Set<java.lang.annotation.Annotation> annotations)
static boolean	isClassLoadable(java.lang.String className, ResourceLoader resourceLoader)
static boolean	isFinal(java.lang.Class<?> clazz) Checks if class is final
static boolean	isFinal(java.lang.reflect.Member member) Checks if member is final
static boolean	isNonStaticInnerClass(java.lang.Class<?> clazz)
static boolean	isPackagePrivate(int mod)
static boolean	isParamerterizedTypeWithWildcard(java.lang.Class<?> type)
static boolean	isParameterizedType(java.lang.Class<?> type) Checks if type is parameterized type
static boolean	isPrimitive(java.lang.reflect.Type type)
static boolean	isPrivate(java.lang.reflect.Member member) Checks if member is private
static boolean	isSerializable(java.lang.Class<?> clazz)
static boolean	isStatic(java.lang.Class<?> type) Checks if type is static
static boolean	isStatic(java.lang.reflect.Member member) Checks if member is static
static boolean	isTransient(java.lang.reflect.Member member)
static boolean	isTypeInsideBounds(java.lang.reflect.Type type, java.lang.reflect.Type[] lowerBounds, java.lang.reflect.Type[] upperBounds)
static boolean	isTypeOrAnyMethodFinal(java.lang.Class<?> type) Checks if type or member is final
static boolean	matches(java.util.Set<java.lang.reflect.Type> requiredTypes, java.util.Set<java.lang.reflect.Type> beanTypes) Check whether whether any of the requiredTypes matches a type in beanTypes
static boolean	matches(java.lang.reflect.Type requiredType, java.util.Set<? extends java.lang.reflect.Type> beanTypes)
static boolean	matches(java.lang.reflect.Type requiredType, java.lang.reflect.Type beanType)

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_TYPES

public static final java.lang.reflect.Type[] EMPTY_TYPES

EMPTY_ANNOTATIONS

public static final java.lang.annotation.Annotation[] EMPTY_ANNOTATIONS

EMPTY_CLASSES

public static final java.lang.Class<?>[] EMPTY_CLASSES

Constructor Detail

Reflections

public Reflections()

Method Detail

buildTypeMap

public static java.util.Map<java.lang.Class<?>,java.lang.reflect.Type> buildTypeMap(java.util.Set<java.lang.reflect.Type> types)

isCacheable

public static boolean isCacheable(java.util.Set<java.lang.annotation.Annotation> annotations)

isCacheable

public static boolean isCacheable(java.lang.annotation.Annotation[] annotations)

cast

public static <T> T cast(java.lang.Object obj)

getPropertyName

public static java.lang.String getPropertyName(java.lang.reflect.Method method)

Gets the property name from a getter method.

We extend JavaBean conventions, allowing the getter method to have parameters

Parameters:

method - The getter method

Returns:

The name of the property. Returns null if method wasn't JavaBean getter-styled

isFinal

public static boolean isFinal(java.lang.Class<?> clazz)

Checks if class is final

Parameters:

clazz - The class to check

Returns:

True if final, false otherwise

getNesting

public static int getNesting(java.lang.Class<?> clazz)

isNonStaticInnerClass

public static boolean isNonStaticInnerClass(java.lang.Class<?> clazz)

isFinal

public static boolean isFinal(java.lang.reflect.Member member)

Checks if member is final

Parameters:

member - The member to check

Returns:

True if final, false otherwise

isPrivate

public static boolean isPrivate(java.lang.reflect.Member member)

Checks if member is private

Parameters:

member - The member to check

Returns:

True if final, false otherwise

isTypeOrAnyMethodFinal

public static boolean isTypeOrAnyMethodFinal(java.lang.Class<?> type)

Checks if type or member is final

Parameters:

type - Type or member

Returns:

True if final, false otherwise

getNonPrivateFinalMethodOrType

public static java.lang.Object getNonPrivateFinalMethodOrType(java.lang.Class<?> type)

isPackagePrivate

public static boolean isPackagePrivate(int mod)

isStatic

public static boolean isStatic(java.lang.Class<?> type)

Checks if type is static

Parameters:

type - Type to check

Returns:

True if static, false otherwise

isStatic

public static boolean isStatic(java.lang.reflect.Member member)

Checks if member is static

Parameters:

member - Member to check

Returns:

True if static, false otherwise

isTransient

public static boolean isTransient(java.lang.reflect.Member member)

isAbstract

public static boolean isAbstract(java.lang.reflect.Method method)

Checks if a method is abstract

Parameters:

method - the method

Returns:

true if abstract

getActualTypeArguments

public static java.lang.reflect.Type[] getActualTypeArguments(java.lang.reflect.Type type)

Gets the actual type arguments of a Type

Parameters:

type - The type to examine

Returns:

The type arguments

isArrayType

public static boolean isArrayType(java.lang.Class<?> rawType)

Checks if raw type is array type

Parameters:

rawType - The raw type to check

Returns:

True if array, false otherwise

isParameterizedType

public static boolean isParameterizedType(java.lang.Class<?> type)

Checks if type is parameterized type

Parameters:

type - The type to check

Returns:

True if parameterized, false otherwise

isParamerterizedTypeWithWildcard

public static boolean isParamerterizedTypeWithWildcard(java.lang.Class<?> type)

containsWildcards

public static boolean containsWildcards(java.lang.reflect.Type[] types)

isBindings

@Deprecated
public static boolean isBindings(java.lang.annotation.Annotation binding)

Deprecated.

Checks the bindingType to make sure the annotation was declared properly as a binding type (annotated with @BindingType) and that it has a runtime retention policy.

Parameters:

binding - The binding type to check

Returns:

true only if the annotation is really a binding type

isAssignableFrom

public static boolean isAssignableFrom(java.lang.reflect.Type type1,
                       java.util.Set<? extends java.lang.reflect.Type> types2)

matches

public static boolean matches(java.lang.reflect.Type requiredType,
              java.util.Set<? extends java.lang.reflect.Type> beanTypes)

isAssignableTo

public static boolean isAssignableTo(java.lang.reflect.Type type1,
                     java.lang.reflect.Type[] types2)

isAssignableFrom

public static boolean isAssignableFrom(java.lang.reflect.Type type1,
                       java.lang.reflect.Type[] types2)

isAssignableFrom

public static boolean isAssignableFrom(java.lang.reflect.Type type1,
                       java.lang.reflect.Type type2)

matches

public static boolean matches(java.lang.reflect.Type requiredType,
              java.lang.reflect.Type beanType)

isTypeInsideBounds

public static boolean isTypeInsideBounds(java.lang.reflect.Type type,
                         java.lang.reflect.Type[] lowerBounds,
                         java.lang.reflect.Type[] upperBounds)

isAssignableFrom

public static boolean isAssignableFrom(java.util.Set<java.lang.reflect.Type> types1,
                       java.util.Set<java.lang.reflect.Type> types2)

Check the assiginability of a set of flattened types. This algorithm will check whether any of the types1 matches a type in types2

Parameters:

types1 - the types1

types2 - the type2

Returns:

can we assign any type from types1 to types2

matches

public static boolean matches(java.util.Set<java.lang.reflect.Type> requiredTypes,
              java.util.Set<java.lang.reflect.Type> beanTypes)

Check whether whether any of the requiredTypes matches a type in beanTypes

Parameters:

requiredTypes - the requiredTypes

beanTypes - the beanTypes

Returns:

can we assign any type from requiredTypes to beanTypes

isAssignableFrom

public static boolean isAssignableFrom(java.util.Set<java.lang.reflect.Type> types1,
                       java.lang.reflect.Type type2)

Check the assiginability of a set of flattened types. This algorithm will check whether any of the types1 matches a type in types2

Parameters:

types1 - the types1

type2 - the type2

Returns:

can we assign any type from types1 to type2

isAssignableFrom

public static boolean isAssignableFrom(java.lang.reflect.Type[] types1,
                       java.lang.reflect.Type type2)

isSerializable

public static boolean isSerializable(java.lang.Class<?> clazz)

isPrimitive

public static boolean isPrimitive(java.lang.reflect.Type type)

getRawType

public static <T> java.lang.Class<T> getRawType(java.lang.reflect.Type type)

isClassLoadable

public static boolean isClassLoadable(java.lang.String className,
                      ResourceLoader resourceLoader)