de.richtercloud.reflection.form.builder.fieldhandler

Class MappingFieldHandler<T,E extends FieldUpdateEvent<T>,R extends ReflectionFormBuilder,C extends Component>

java.lang.Object

de.richtercloud.reflection.form.builder.fieldhandler.ResettableFieldHandler<T,E,R,C>

de.richtercloud.reflection.form.builder.fieldhandler.MappingFieldHandler<T,E,R,C>

Type Parameters:

T - the type of the field

E - the type of field update event

R - the type of reflection form builder to use for the component production

C - the type of component to produce

All Implemented Interfaces:

ComponentHandler<C>, FieldHandler<T,E,R,C>

public class MappingFieldHandler<T,E extends FieldUpdateEvent<T>,R extends ReflectionFormBuilder,C extends Component>
extends ResettableFieldHandler<T,E,R,C>

In order to KISS TypeHandler mappings are generated by ClassMappingFactorys.

Author:

richter

Constructor Summary

Constructors

Constructor and Description
MappingFieldHandler(Map<Type,FieldHandler<?,?,?,?>> classMapping, Map<Class<?>,FieldHandler<?,?,?,?>> primitiveMapping, de.richtercloud.message.handler.IssueHandler issueHandler) Creates a ClassMappingFieldHandler.

Method Summary

Modifier and Type	Method and Description
Map<Type,FieldHandler<?,?,?,?>>	getClassMapping()
protected org.apache.commons.lang3.tuple.Pair<JComponent,ComponentHandler<?>>	handle0(Field field, Object instance, FieldUpdateListener<E> updateListener, R reflectionFormBuilder) Must never return null, otherwise #handle(java.lang.reflect.Field, java.lang.Object, richtercloud.reflection.form.builder.fieldhandler.FieldUpdateListener, richtercloud.reflection.form.builder.ReflectionFormBuilder) throws IllegalArgumentException.
protected int	retrieveAnyCountRecursively(ParameterizedType type)
protected Type	retrieveClassMappingBestMatch(ParameterizedType fieldParameterizedType) Figures out candidates which the longest common prefix in the fieldParameterizedType chain of (nested) generic types ignoring specifications of AnyType.
FieldHandler	retrieveFieldHandler(Type fieldType, Map<Type,FieldHandler<?,?,?,?>> classMapping)
protected static <K,V> void	validateMapping(List<org.apache.commons.lang3.tuple.Pair<K,V>> mapping, String argumentName)

Methods inherited from class de.richtercloud.reflection.form.builder.fieldhandler.ResettableFieldHandler

handle, reset, retrieveDefaultComponent

Methods inherited from class java.lang.Object

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

Constructor Detail

MappingFieldHandler

public MappingFieldHandler(Map<Type,FieldHandler<?,?,?,?>> classMapping,
                           Map<Class<?>,FieldHandler<?,?,?,?>> primitiveMapping,
                           de.richtercloud.message.handler.IssueHandler issueHandler)

Creates a ClassMappingFieldHandler. It's recommended to generate classMapping with #generateClassMapping(java.lang.String, richtercloud.reflection.form.builder.components.AmountMoneyUsageStatisticsStorage, richtercloud.reflection.form.builder.components.AmountMoneyAdditionalCurrencyStorage, boolean) , #generateClassMappingDefault(java.lang.String) or #generateClassMappingAmountMoneyFieldHandler(richtercloud.reflection.form.builder.components.AmountMoneyUsageStatisticsStorage, richtercloud.reflection.form.builder.components.AmountMoneyAdditionalCurrencyStorage, boolean) .

Parameters:

classMapping - the class mapping

primitiveMapping - the primitive mapping

issueHandler - the issue handler to use

Method Detail

validateMapping

protected static <K,V> void validateMapping(List<org.apache.commons.lang3.tuple.Pair<K,V>> mapping,
                                            String argumentName)

getClassMapping

public Map<Type,FieldHandler<?,?,?,?>> getClassMapping()

handle0

protected org.apache.commons.lang3.tuple.Pair<JComponent,ComponentHandler<?>> handle0(Field field,
                                                                                      Object instance,
                                                                                      FieldUpdateListener<E> updateListener,
                                                                                      R reflectionFormBuilder)
                                                                               throws FieldHandlingException,
                                                                                      ResetException

Must never return null, otherwise #handle(java.lang.reflect.Field, java.lang.Object, richtercloud.reflection.form.builder.fieldhandler.FieldUpdateListener, richtercloud.reflection.form.builder.ReflectionFormBuilder) throws IllegalArgumentException.

Specified by:

handle0 in class ResettableFieldHandler<T,E extends FieldUpdateEvent<T>,R extends ReflectionFormBuilder,C extends Component>

Parameters:

field - the field to handle

instance - the instance to create for

updateListener - the update listener to use

reflectionFormBuilder - the reflection form builder to use

Returns:

the created component

Throws:

FieldHandlingException - wraps all exceptions occuring during read or write access to fields

ResetException - if an exception during resetting the field occurs

retrieveFieldHandler

public FieldHandler retrieveFieldHandler(Type fieldType,
                                         Map<Type,FieldHandler<?,?,?,?>> classMapping)

Parameters:

fieldType - always call with return value of Field.getGenericType() in order to be the correct match

classMapping - the class mapping to use (it might be necessary to use different class mappings for entities and embeddables if components check if field types are entities)

Returns:

the retrieved field handler

retrieveClassMappingBestMatch

protected Type retrieveClassMappingBestMatch(ParameterizedType fieldParameterizedType)

Figures out candidates which the longest common prefix in the fieldParameterizedType chain of (nested) generic types ignoring specifications of AnyType. Then determines the candidates with the smallest number of AnyType specifications in the chain. If there're multiple with the same number of AnyType chooses the first it finds which might lead to random choices.

Parameters:

fieldParameterizedType - the chain of generic types (remember to retrieve this information with Field.getGenericType() instead of Field.getType() from fields)

Returns:

the choice result as described above or null if no candidate exists

retrieveAnyCountRecursively

protected int retrieveAnyCountRecursively(ParameterizedType type)