Package uk.co.jemos.podam.typeManufacturers

Class TypeManufacturerUtil

java.lang.Object

uk.co.jemos.podam.typeManufacturers.TypeManufacturerUtil

public abstract class TypeManufacturerUtil
extends Object

Type Manufacturer utility class. Created by tedonema on 01/07/2015.

Since:

6.0.0.RELEASE

Field Summary

Fields

Modifier and Type	Field	Description
private static org.slf4j.Logger	LOG	The application logger

Constructor Summary

Constructors

Constructor	Description
TypeManufacturerUtil()

Method Summary

Modifier and Type	Method	Description
static Type[]	fillTypeArgMap(Map<String,Type> typeArgsMap, Class<?> pojoClass, Type[] genericTypeArgs)	Fills type agruments map
static AttributeStrategy<?>	findAttributeStrategy(DataProviderStrategy strategy, List<Annotation> annotations, Class<?> attributeType)	It returns a AttributeStrategy if one was specified in annotations, or null otherwise.
static Integer	findCollectionSize(DataProviderStrategy strategy, List<Annotation> annotations, Class<?> collectionElementType, Holder<AttributeStrategy<?>> elementStrategyHolder, Holder<AttributeStrategy<?>> keyStrategyHolder)	Searches for annotation with information about collection/map size and filling strategies
static Method[]	findSuitableConstructors(Class<?> factoryClass, Class<?> pojoClass)	Finds suitable static constructors for POJO instantiation
static Type[]	mergeActualAndSuppliedGenericTypes(Class<?> attributeType, Type genericAttributeType, Type[] suppliedTypes, Map<String,Type> typeArgsMap)	Utility to merge actual types with supplied array of generic type substitutions
static Class<?>	resolveGenericParameter(Type paramType, Map<String,Type> typeArgsMap, AtomicReference<Type[]> methodGenericTypeArgs)	It resolves generic parameter type
static Object	returnAttributeDataStrategyValue(Class<?> attributeType, List<Annotation> annotations, AttributeStrategy<?> attributeStrategy)	It retrieves the value for the PodamStrategyValue annotation with which the attribute was annotated

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

The application logger

Constructor Detail

TypeManufacturerUtil

public TypeManufacturerUtil()

Method Detail

findAttributeStrategy

public static AttributeStrategy<?> findAttributeStrategy(DataProviderStrategy strategy,
                                                         List<Annotation> annotations,
                                                         Class<?> attributeType)
                                                  throws InstantiationException,
                                                         IllegalAccessException,
                                                         SecurityException,
                                                         IllegalArgumentException,
                                                         InvocationTargetException

It returns a AttributeStrategy if one was specified in annotations, or null otherwise.

Parameters:

strategy - The data provider strategy

annotations - The list of annotations, irrelevant annotations will be removed

attributeType - Type of attribute expected to be returned

Returns:

AttributeStrategy, if PodamStrategyValue or bean validation constraint annotation was found among annotations

Throws:

IllegalAccessException - if attribute strategy cannot be instantiated

InstantiationException - if attribute strategy cannot be instantiated

SecurityException - if access security is violated

InvocationTargetException - if invocation failed

IllegalArgumentException - if illegal argument provided to a constructor

findSuitableConstructors

public static Method[] findSuitableConstructors(Class<?> factoryClass,
                                                Class<?> pojoClass)

Finds suitable static constructors for POJO instantiation

This method places required and provided types for object creation into a map, which will be used for type mapping.

Parameters:

factoryClass - Factory class to produce the POJO

pojoClass - Typed class

Returns:

an array of suitable static constructors found

fillTypeArgMap

public static Type[] fillTypeArgMap(Map<String,Type> typeArgsMap,
                                    Class<?> pojoClass,
                                    Type[] genericTypeArgs)

Fills type agruments map

This method places required and provided types for object creation into a map, which will be used for type mapping.

Parameters:

typeArgsMap - a map to fill

pojoClass - Typed class

genericTypeArgs - Type arguments provided for a generics object by caller

Returns:

Array of unused provided generic type arguments

Throws:

IllegalStateException - If number of typed parameters doesn't match number of provided generic types

findCollectionSize

public static Integer findCollectionSize(DataProviderStrategy strategy,
                                         List<Annotation> annotations,
                                         Class<?> collectionElementType,
                                         Holder<AttributeStrategy<?>> elementStrategyHolder,
                                         Holder<AttributeStrategy<?>> keyStrategyHolder)
                                  throws InstantiationException,
                                         IllegalAccessException

Searches for annotation with information about collection/map size and filling strategies

Parameters:

strategy - a data provider strategy

annotations - a list of annotations to inspect

collectionElementType - a collection element type

elementStrategyHolder - a holder to pass found element strategy back to the caller, can be null

keyStrategyHolder - a holder to pass found key strategy back to the caller, can be null

Returns:

A number of element in collection or null, if no annotation was found

Throws:

InstantiationException - A strategy cannot be instantiated

IllegalAccessException - A strategy cannot be instantiated

mergeActualAndSuppliedGenericTypes

public static Type[] mergeActualAndSuppliedGenericTypes(Class<?> attributeType,
                                                        Type genericAttributeType,
                                                        Type[] suppliedTypes,
                                                        Map<String,Type> typeArgsMap)

Utility to merge actual types with supplied array of generic type substitutions

Parameters:

attributeType - actual type of object

genericAttributeType - generic type of object

suppliedTypes - an array of supplied types for generic type substitution

typeArgsMap - a map relating the generic class arguments ("<T, V>" for example) with their actual types

Returns:

An array of merged actual and supplied types with generic types resolved

resolveGenericParameter

public static Class<?> resolveGenericParameter(Type paramType,
                                               Map<String,Type> typeArgsMap,
                                               AtomicReference<Type[]> methodGenericTypeArgs)

It resolves generic parameter type

Parameters:

paramType - The generic parameter type

typeArgsMap - A map of resolved types

methodGenericTypeArgs - Return value posible generic types of the generic parameter type

Returns:

value for class representing the generic parameter type

returnAttributeDataStrategyValue

public static Object returnAttributeDataStrategyValue(Class<?> attributeType,
                                                      List<Annotation> annotations,
                                                      AttributeStrategy<?> attributeStrategy)
                                               throws IllegalArgumentException

It retrieves the value for the PodamStrategyValue annotation with which the attribute was annotated

Parameters:

attributeType - The attribute type, used for type checking

annotations - Annotations attached to the attribute

attributeStrategy - The AttributeStrategy to use

Returns:

The value for the PodamStrategyValue annotation with which the attribute was annotated

Throws:

IllegalArgumentException - If the type of the data strategy defined for the PodamStrategyValue annotation is not assignable to the annotated attribute. This de facto guarantees type safety.