org.fabric3.spi.introspection.java

Interface IntrospectionHelper

public interface IntrospectionHelper

Helper service that provides support methods to simplify introspection.

Method Summary

Modifier and Type	Method and Description
JavaTypeInfo	createTypeInfo(java.lang.reflect.Type type, TypeMapping typeMapping) Creates a JavaTypeInfo for a given type based on the class hierarchy the type is used in.
java.lang.Class<?>	getBaseType(java.lang.reflect.Type type, TypeMapping typeMapping) Returns the base type for the supplied type.
java.lang.reflect.Type	getGenericType(java.lang.reflect.Constructor<?> constructor, int index) Returns the generic type of a constructor parameter.
java.lang.reflect.Type	getGenericType(java.lang.reflect.Method setter) Returns the generic type of a setter method.
java.lang.reflect.Type	getGenericType(java.lang.reflect.Method method, int index) Returns the generic type of a method parameter.
java.util.Set<java.lang.Class<?>>	getImplementedInterfaces(java.lang.Class<?> type) Returns all service interfaces directly implemented by a class or any super class.
java.util.Set<java.lang.reflect.Field>	getInjectionFields(java.lang.Class<?> type) Returns method injection sites provided by a class or any super class.
java.util.Set<java.lang.reflect.Method>	getInjectionMethods(java.lang.Class<?> type, java.util.Collection<org.fabric3.api.model.type.component.Service<org.fabric3.api.model.type.component.ComponentType>> services) Returns method injection sites provided by a class or any super class.
java.lang.String	getSiteName(java.lang.reflect.Constructor<?> constructor, int index, java.lang.String override) Derive the name of an injection site from a setter method.
java.lang.String	getSiteName(java.lang.reflect.Field field, java.lang.String override) Derive the name of an injection site from a field.
java.lang.String	getSiteName(java.lang.reflect.Method setter, java.lang.String override) Derive the name of an injection site from a setter method.
org.fabric3.api.model.type.java.InjectableType	inferType(java.lang.reflect.Type type, TypeMapping typeMapping) Heuristically determines the injection type of the field, method, or constructor parameter associated with the given type.
MultiplicityType	introspectMultiplicity(java.lang.reflect.Type type, TypeMapping typeMapping) Introspects the type Returns true if the supplied type should be treated as many-valued.
boolean	isAnnotationPresent(java.lang.Class<?> type, java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Determine if an annotation is present on this interface or any super interface.
java.lang.Class<?>	loadClass(java.lang.String name, java.lang.ClassLoader cl) Load the class using the supplied ClassLoader.
void	processMultiplicity(org.fabric3.api.model.type.component.Reference definition, boolean required, java.lang.reflect.Type type, TypeMapping typeMapping) Add multiplicity metadata to the reference definition, including cardinality and if the multiplicity is keyed.
void	resolveTypeParameters(java.lang.Class<?> type, TypeMapping typeMapping) Resolves the formal parameters of a class, its super class and super interfaces to the concrete types.

Method Detail

loadClass

java.lang.Class<?> loadClass(java.lang.String name,
                             java.lang.ClassLoader cl)
                      throws ImplementationNotFoundException

Load the class using the supplied ClassLoader. The class will be defined so any initializer present will be fired. As the class is being loaded, the Thread context ClassLoader will be set to the supplied classloader.

Parameters:

name - the name of the class to load

cl - the classloader to use to load it

Returns:

the class

Throws:

ImplementationNotFoundException - if the class could not be found

getSiteName

java.lang.String getSiteName(java.lang.reflect.Field field,
                             java.lang.String override)

Derive the name of an injection site from a field.

Parameters:

field - the field to inspect

override - an override specified in an annotation

Returns:

the name of the injection site

getSiteName

java.lang.String getSiteName(java.lang.reflect.Method setter,
                             java.lang.String override)

Derive the name of an injection site from a setter method.

Parameters:

setter - the setter method to inspect

override - an override specified in an annotation

Returns:

the name of the injection site

getSiteName

java.lang.String getSiteName(java.lang.reflect.Constructor<?> constructor,
                             int index,
                             java.lang.String override)

Derive the name of an injection site from a setter method.

Parameters:

constructor - the constructor to inspect

index - the index of the constructor parameter to inspect

override - an override specified in an annotation

Returns:

the name of the injection site

getGenericType

java.lang.reflect.Type getGenericType(java.lang.reflect.Method setter)

Returns the generic type of a setter method.

Parameters:

setter - the method to inspect

Returns:

the type of value the setter method injects

getGenericType

java.lang.reflect.Type getGenericType(java.lang.reflect.Method method,
                                      int index)

Returns the generic type of a method parameter.

Parameters:

method - the method to inspect

index - the parameter index

Returns:

the type of value the method injects

getGenericType

java.lang.reflect.Type getGenericType(java.lang.reflect.Constructor<?> constructor,
                                      int index)

Returns the generic type of a constructor parameter.

Parameters:

constructor - the constructor to inspect

index - the parameter index

Returns:

the type of value the constructor injects

processMultiplicity

void processMultiplicity(org.fabric3.api.model.type.component.Reference definition,
                         boolean required,
                         java.lang.reflect.Type type,
                         TypeMapping typeMapping)

Add multiplicity metadata to the reference definition, including cardinality and if the multiplicity is keyed.

Parameters:

definition - the reference definition

required - whether a value must be supplied (implies 1.. multiplicity)

type - the multiplicity of a type

typeMapping - the current introspection type mapping @return the multiplicity of the type

introspectMultiplicity

MultiplicityType introspectMultiplicity(java.lang.reflect.Type type,
                                        TypeMapping typeMapping)

Introspects the type Returns true if the supplied type should be treated as many-valued. This is generally true for arrays, Collection or Map types.

Parameters:

type - the type to check

typeMapping - the mapping to use to resolve any formal types

Returns:

true if the type should be treated as many-valued

inferType

org.fabric3.api.model.type.java.InjectableType inferType(java.lang.reflect.Type type,
                                                         TypeMapping typeMapping)

Heuristically determines the injection type of the field, method, or constructor parameter associated with the given type.

Parameters:

type - the type to infer

typeMapping - the type mapping for resolved parameters

Returns:

the attribute type

isAnnotationPresent

boolean isAnnotationPresent(java.lang.Class<?> type,
                            java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Determine if an annotation is present on this interface or any super interface. This is similar to the use of @Inherited on classes (given @Inherited does not apply to interfaces).

Parameters:

type - the interface to check

annotationType - the annotation to look for

Returns:

true if the annotation is present

resolveTypeParameters

void resolveTypeParameters(java.lang.Class<?> type,
                           TypeMapping typeMapping)

Resolves the formal parameters of a class, its super class and super interfaces to the concrete types.

Parameters:

type - the class whose parameters should be resolved

typeMapping - the type mapping to update with resolved types

createTypeInfo

JavaTypeInfo createTypeInfo(java.lang.reflect.Type type,
                            TypeMapping typeMapping)

Creates a JavaTypeInfo for a given type based on the class hierarchy the type is used in. For example, the JavaTypeInfo for a field type or method parameter will be introspected using the containing class hierarchy and its generics declarations.

Parameters:

type - the type to introspect

typeMapping - the type mapping to use for introspecting the class hierarchy

Returns:

the TypeInfo

getBaseType

java.lang.Class<?> getBaseType(java.lang.reflect.Type type,
                               TypeMapping typeMapping)

Returns the base type for the supplied type. The base type is the actual type of a property or reference having removed any decoration for arrays or collections.

Parameters:

type - the type of a field or parameter

typeMapping - the mapping to use to resolve any formal types

Returns:

the actual type of the property or reference corresponding to the parameter

getImplementedInterfaces

java.util.Set<java.lang.Class<?>> getImplementedInterfaces(java.lang.Class<?> type)

Returns all service interfaces directly implemented by a class or any super class. Class#getInterfaces only returns interfaces directly implemented by the class. This method returns all interfaces including those implemented by any super classes. It excludes interfaces that are super-interfaces of those implemented by subclasses.

Parameters:

type - the class whose interfaces should be returned

Returns:

the unique interfaces implemented by that class

getInjectionMethods

java.util.Set<java.lang.reflect.Method> getInjectionMethods(java.lang.Class<?> type,
                                                            java.util.Collection<org.fabric3.api.model.type.component.Service<org.fabric3.api.model.type.component.ComponentType>> services)

Returns method injection sites provided by a class or any super class. Methods that are part of any service contract are excluded.

Parameters:

type - the class whose method sites should be returned

services - the services implemented by the class

Returns:

the method injection sites for the class

getInjectionFields

java.util.Set<java.lang.reflect.Field> getInjectionFields(java.lang.Class<?> type)

Returns method injection sites provided by a class or any super class. Methods that are part of any service contract are excluded.

Parameters:

type - the class whose field injection sites should be returned

Returns:

the setter injection sites for the class