de.richtercloud.reflection.form.builder.fieldhandler

Interface FieldHandler<T,E extends FieldUpdateEvent<T>,R extends ReflectionFormBuilder,C extends Component>

Type Parameters:

T - the type of the managed field

E - the type of event emitted on field updates

R - the type of reflection form builder to use

C - the type of component to produce

All Superinterfaces:

ComponentHandler<C>

All Known Implementing Classes:

AbstractListFieldHandler, AmountMoneyFieldHandler, BooleanFieldHandler, BooleanListFieldHandler, BooleanPrimitiveFieldHandler, DateFieldHandler, DoubleFieldHandler, DoublePrimitiveFieldHandler, FloatFieldHandler, FloatPrimitiveFieldHandler, IntegerFieldHandler, IntegerListFieldHandler, IntegerPrimitiveFieldHandler, LongFieldHandler, LongPrimitiveFieldHandler, MappingFieldHandler, NumberFieldHandler, ResettableFieldHandler, SimpleEntityListFieldHandler, SqlDateFieldHandler, StringFieldHandler, StringListFieldHandler

public interface FieldHandler<T,E extends FieldUpdateEvent<T>,R extends ReflectionFormBuilder,C extends Component>
extends ComponentHandler<C>

This interface specifies information which allow you to write custom field handlers.Due to the fact that #handle(java.lang.reflect.Field, java.lang.Object, java.lang.String, java.lang.Class, richtercloud.reflection.form.builder.FieldUpdateListener, richtercloud.reflection.form.builder.ReflectionFormBuilder) provides information about the handled field you can retrieve information as good and as easily as the Java Reflection API allows you.

Author:

richter

Method Summary

Modifier and Type	Method and Description
JComponent	handle(Field field, Object instance, FieldUpdateListener<E> updateListener, R reflectionFormBuilder) Information about the field value can be retrieved with Field.get(java.lang.Object) and instance, about the field name with Field.getName() and about the declaring class with Field.getDeclaringClass().

Methods inherited from interface de.richtercloud.reflection.form.builder.ComponentHandler

reset

Method Detail

handle

JComponent handle(Field field,
                  Object instance,
                  FieldUpdateListener<E> updateListener,
                  R reflectionFormBuilder)
           throws FieldHandlingException,
                  ResetException

Information about the field value can be retrieved with Field.get(java.lang.Object) and instance, about the field name with Field.getName() and about the declaring class with Field.getDeclaringClass().

Parameters:

field - the Field to be handled

instance - the instance to handle

updateListener - an FieldUpdateListener to notify on updates

reflectionFormBuilder - a ReflectionFormBuilder used for recursion

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