org.glassfish.hk2.utilities.reflection

Class ReflectionHelper

java.lang.Object

org.glassfish.hk2.utilities.reflection.ReflectionHelper

public class ReflectionHelper
extends java.lang.Object

Author:

jwells

Constructor Summary

Constructors

Constructor and Description
ReflectionHelper()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadatas, java.lang.String key, java.lang.String value) Adds a value to the list of values associated with this key
static java.util.Map<java.lang.String,java.util.List<java.lang.String>>	deepCopyMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> copyMe) This method does a deep copy of the incoming meta-data, (which basically means we will also make copies of the value list)
static java.util.Set<java.lang.reflect.Type>	getAdvertisedTypesFromClass(java.lang.reflect.Type type, java.lang.Class<? extends java.lang.annotation.Annotation> markerAnnotation) Returns the set of types this class advertises
static java.util.Set<java.lang.reflect.Type>	getAdvertisedTypesFromObject(java.lang.Object t, java.lang.Class<? extends java.lang.annotation.Annotation> markerAnnotation) Returns the set of types this class advertises
static java.util.Set<java.lang.String>	getContractsFromClass(java.lang.Class<?> clazz, java.lang.Class<? extends java.lang.annotation.Annotation> markerAnnotation) Returns the set of types this class advertises
static java.lang.String	getName(java.lang.Class<?> implClass) Returns the name that should be associated with this class
static java.util.Set<java.lang.annotation.Annotation>	getQualifierAnnotations(java.lang.reflect.AnnotatedElement annotatedGuy) Gets all the qualifier annotations from the object
static java.util.Set<java.lang.String>	getQualifiersFromClass(java.lang.Class<?> clazz) Gets all the qualifiers from the object
static java.util.Set<java.lang.annotation.Annotation>	getQualifiersFromObject(java.lang.Object t) Gets all the qualifiers from the object
static java.lang.Class<?>	getRawClass(java.lang.reflect.Type type) Given the type parameter gets the raw type represented by the type, or null if this has no associated raw class
static java.lang.annotation.Annotation	getScopeAnnotationFromClass(java.lang.Class<?> clazz) Gets the scope annotation from the object
static java.lang.annotation.Annotation	getScopeAnnotationFromObject(java.lang.Object t) Gets the scope annotation from the object
static java.lang.Class<? extends java.lang.annotation.Annotation>	getScopeFromClass(java.lang.Class<?> clazz, java.lang.Class<? extends java.lang.annotation.Annotation> annoDefault) Gets the scope annotation from the object
static java.lang.Class<? extends java.lang.annotation.Annotation>	getScopeFromObject(java.lang.Object t, java.lang.Class<? extends java.lang.annotation.Annotation> annoDefault) Gets the scope annotation from the object
static java.util.Set<java.lang.reflect.Type>	getTypeClosure(java.lang.reflect.Type ofType, java.util.Set<java.lang.String> contracts) Returns the type closure, as restricted by the classes listed in the set of contracts implemented
static java.lang.Object	invoke(java.lang.Object o, java.lang.reflect.Method m, java.lang.Object[] args) This version of invoke is CCL neutral (it will return with the same CCL as what it went in with)
static boolean	isAnnotationAQualifier(java.lang.annotation.Annotation anno) Returns true if the given annotation is a qualifier
static boolean	isStatic(java.lang.reflect.Member member) Returns true if the underlying member is static
static java.lang.Object	makeMe(java.lang.reflect.Constructor<?> c, java.lang.Object[] args) This version of invoke is CCL neutral (it will return with the same CCL as what it went in with)
static void	readMetadataMap(java.lang.String line, java.util.Map<java.lang.String,java.util.List<java.lang.String>> addToMe) Writes a set in a way that can be read from an input stream as well
static void	readSet(java.lang.String line, java.util.Collection<java.lang.String> addToMe) Writes a set in a way that can be read from an input stream as well.
static boolean	removeAllMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadatas, java.lang.String key) Removes all the metadata values associated with key
static boolean	removeMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadatas, java.lang.String key, java.lang.String value) Removes the given value from the given key
static void	setContextClassLoader(java.lang.Thread t, java.lang.ClassLoader l) Sets the context classloader under the privileged of this class
static void	setField(java.lang.reflect.Field field, java.lang.Object instance, java.lang.Object value) Sets the given field to the given value
static java.lang.String	writeMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadata) Used to write the metadata out
static java.lang.String	writeSet(java.util.Set<?> set) Writes a set in a way that can be read from an input stream as well
static java.lang.String	writeSet(java.util.Set<?> set, java.lang.Object excludeMe) Writes a set in a way that can be read from an input stream as well

Methods inherited from class java.lang.Object

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

Constructor Detail

ReflectionHelper

public ReflectionHelper()

Method Detail

getRawClass

public static java.lang.Class<?> getRawClass(java.lang.reflect.Type type)

Given the type parameter gets the raw type represented by the type, or null if this has no associated raw class

Parameters:

type - The type to find the raw class on

Returns:

The raw class associated with this type

getName

public static java.lang.String getName(java.lang.Class<?> implClass)

Returns the name that should be associated with this class

Parameters:

implClass - The class to evaluate

Returns:

The name this class should have

getTypeClosure

public static java.util.Set<java.lang.reflect.Type> getTypeClosure(java.lang.reflect.Type ofType,
                                                   java.util.Set<java.lang.String> contracts)

Returns the type closure, as restricted by the classes listed in the set of contracts implemented

Parameters:

ofType - The type to check

contracts - The contracts this type is allowed to handle

Returns:

The type closure restricted to the contracts

getAdvertisedTypesFromClass

public static java.util.Set<java.lang.reflect.Type> getAdvertisedTypesFromClass(java.lang.reflect.Type type,
                                                                java.lang.Class<? extends java.lang.annotation.Annotation> markerAnnotation)

Returns the set of types this class advertises

Parameters:

type - The outer type to analyze

markerAnnotation - The annotation to use to discover the advertised types

Returns:

The type itself and the contracts it implements

getAdvertisedTypesFromObject

public static java.util.Set<java.lang.reflect.Type> getAdvertisedTypesFromObject(java.lang.Object t,
                                                                 java.lang.Class<? extends java.lang.annotation.Annotation> markerAnnotation)

Returns the set of types this class advertises

Parameters:

t - the object we are analyzing

markerAnnotation - The annotation to use to discover the advertised types

Returns:

The type itself and the contracts it implements

getContractsFromClass

public static java.util.Set<java.lang.String> getContractsFromClass(java.lang.Class<?> clazz,
                                                    java.lang.Class<? extends java.lang.annotation.Annotation> markerAnnotation)

Returns the set of types this class advertises

Parameters:

clazz - the class we are analyzing

markerAnnotation - The annotation to use to discover annotated types

Returns:

The type itself and the contracts it implements

getScopeAnnotationFromObject

public static java.lang.annotation.Annotation getScopeAnnotationFromObject(java.lang.Object t)

Gets the scope annotation from the object

Parameters:

t - The object to analyze

Returns:

The class of the scope annotation

getScopeAnnotationFromClass

public static java.lang.annotation.Annotation getScopeAnnotationFromClass(java.lang.Class<?> clazz)

Gets the scope annotation from the object

Parameters:

clazz - The class to analyze

Returns:

The class of the scope annotation

getScopeFromObject

public static java.lang.Class<? extends java.lang.annotation.Annotation> getScopeFromObject(java.lang.Object t,
                                                                            java.lang.Class<? extends java.lang.annotation.Annotation> annoDefault)

Gets the scope annotation from the object

Parameters:

t - The object to analyze

annoDefault - The default that this should have if no scope could be found

Returns:

The class of the scope annotation

getScopeFromClass

public static java.lang.Class<? extends java.lang.annotation.Annotation> getScopeFromClass(java.lang.Class<?> clazz,
                                                                           java.lang.Class<? extends java.lang.annotation.Annotation> annoDefault)

Gets the scope annotation from the object

Parameters:

clazz - The class to analyze

annoDefault - The scope that should be returned if no scope could be found

Returns:

The class of the scope annotation

isAnnotationAQualifier

public static boolean isAnnotationAQualifier(java.lang.annotation.Annotation anno)

Returns true if the given annotation is a qualifier

Parameters:

anno - The annotation to check

Returns:

true if this is an annotation

getQualifiersFromObject

public static java.util.Set<java.lang.annotation.Annotation> getQualifiersFromObject(java.lang.Object t)

Gets all the qualifiers from the object

Parameters:

t - The object to analyze

Returns:

The set of qualifiers. Will not return null but may return an empty set

getQualifiersFromClass

public static java.util.Set<java.lang.String> getQualifiersFromClass(java.lang.Class<?> clazz)

Gets all the qualifiers from the object

Parameters:

clazz - The class to analyze

Returns:

The set of qualifiers. Will not return null but may return an empty set

getQualifierAnnotations

public static java.util.Set<java.lang.annotation.Annotation> getQualifierAnnotations(java.lang.reflect.AnnotatedElement annotatedGuy)

Gets all the qualifier annotations from the object

A strange behavior of this method is that if the annotatedGuy is a field and that field has the Named annotation on it with no value, then that Named annotation will NOT be added to the return list. This is because we have no access at this level to AnnotationLiteral, and hence cannot create a NamedImpl with which to fix the annotation. It is the responsibility of the caller of this method to add in the NamedImpl in that circumstance

Parameters:

annotatedGuy - The thing to analyze

Returns:

The set of qualifiers. Will not return null but may return an empty set

writeSet

public static java.lang.String writeSet(java.util.Set<?> set)

Writes a set in a way that can be read from an input stream as well

Parameters:

set - The set to write

Returns:

a representation of a list

writeSet

public static java.lang.String writeSet(java.util.Set<?> set,
                        java.lang.Object excludeMe)

Writes a set in a way that can be read from an input stream as well

Parameters:

set - The set to write

excludeMe - An object to exclude from the list of things written

Returns:

a representation of a list

readSet

public static void readSet(java.lang.String line,
           java.util.Collection<java.lang.String> addToMe)
                    throws java.io.IOException

Writes a set in a way that can be read from an input stream as well. The values in the set may not contain the characters "{},"

Parameters:

line - The line to read

addToMe - The set to add the strings to

Throws:

java.io.IOException - On a failure

readMetadataMap

public static void readMetadataMap(java.lang.String line,
                   java.util.Map<java.lang.String,java.util.List<java.lang.String>> addToMe)
                            throws java.io.IOException

Writes a set in a way that can be read from an input stream as well

Parameters:

line - The line to read

addToMe - The set to add the strings to

Throws:

java.io.IOException - On a failure

writeMetadata

public static java.lang.String writeMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadata)

Used to write the metadata out

Parameters:

metadata - The metadata to externalize

Returns:

The metadata in an externalizable format

addMetadata

public static void addMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadatas,
               java.lang.String key,
               java.lang.String value)

Adds a value to the list of values associated with this key

Parameters:

metadatas - The base metadata object

key - The key to which to add the value. May not be null

value - The value to add. May not be null

removeMetadata

public static boolean removeMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadatas,
                     java.lang.String key,
                     java.lang.String value)

Removes the given value from the given key

Parameters:

metadatas - The base metadata object

key - The key of the value to remove. May not be null

value - The value to remove. May not be null

Returns:

true if the value was removed

removeAllMetadata

public static boolean removeAllMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> metadatas,
                        java.lang.String key)

Removes all the metadata values associated with key

Parameters:

metadatas - The base metadata object

key - The key of the metadata values to remove

Returns:

true if any value was removed

deepCopyMetadata

public static java.util.Map<java.lang.String,java.util.List<java.lang.String>> deepCopyMetadata(java.util.Map<java.lang.String,java.util.List<java.lang.String>> copyMe)

This method does a deep copy of the incoming meta-data, (which basically means we will also make copies of the value list)

Parameters:

copyMe - The guy to copy (if null, null will be returned)

Returns:

A deep copy of the metadata

setField

public static void setField(java.lang.reflect.Field field,
            java.lang.Object instance,
            java.lang.Object value)
                     throws java.lang.Throwable

Sets the given field to the given value

Parameters:

field - The non-null field to set

instance - The non-null instance to set into

value - The value to which the field should be set

Throws:

java.lang.Throwable

invoke

public static java.lang.Object invoke(java.lang.Object o,
                      java.lang.reflect.Method m,
                      java.lang.Object[] args)
                               throws java.lang.Throwable

This version of invoke is CCL neutral (it will return with the same CCL as what it went in with)

Parameters:

m - the method to invoke

o - the object on which to invoke it

args - The arguments to invoke (may not be null)

Returns:

The return from the invocation

Throws:

java.lang.Throwable - The unwrapped throwable thrown by the method

isStatic

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

Returns true if the underlying member is static

Parameters:

member - The non-null member to test

Returns:

true if the member is static

setContextClassLoader

public static void setContextClassLoader(java.lang.Thread t,
                         java.lang.ClassLoader l)

Sets the context classloader under the privileged of this class

Parameters:

t - The thread on which to set the classloader

l - The classloader to set

makeMe

public static java.lang.Object makeMe(java.lang.reflect.Constructor<?> c,
                      java.lang.Object[] args)
                               throws java.lang.Throwable

This version of invoke is CCL neutral (it will return with the same CCL as what it went in with)

Parameters:

c - the constructor to call

args - The arguments to invoke (may not be null)

Returns:

The return from the invocation

Throws:

java.lang.Throwable - The unwrapped throwable thrown by the method