net.sf.mmm.client.ui.base.binding

Class UiDataBindingPojo<VALUE>

java.lang.Object

net.sf.mmm.client.ui.base.feature.AbstractUiFeatureValueAndValidation<VALUE>

net.sf.mmm.client.ui.base.feature.AbstractUiFeatureValueAndValidationWithValidators<VALUE>

net.sf.mmm.client.ui.base.binding.AbstractUiDataBinding<VALUE>

net.sf.mmm.client.ui.base.binding.UiDataBindingPojo<VALUE>

Type Parameters:

VALUE - is the generic type of the value.

All Implemented Interfaces:

AttributeReadModified, AttributeReadValueAdvanced<VALUE>, AttributeWriteModified, AttributeWriteValueAdvanced<VALUE>, UiFeature, UiFeatureValidation<VALUE>, UiFeatureValue<VALUE>, UiFeatureValueAndValidation<VALUE>, UiDataBinding<VALUE>, AttributeReadValue<VALUE>, AttributeWriteValue<VALUE>, AbstractValidatableObject, HasValueValidators<VALUE>, ValidatableObject<VALUE>

Direct Known Subclasses:

UiDataBindingPojoComposite

public class UiDataBindingPojo<VALUE>
extends AbstractUiDataBinding<VALUE>

This is the implementation of UiDataBinding for any POJO (no Datatype).

Since:

1.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields

Modifier and Type	Field and Description
private UiDataBindingAdapter<VALUE>	adapter

Constructor Summary

Constructors

Constructor and Description
UiDataBindingPojo(AbstractUiWidget<VALUE> widget, UiDataBindingAdapter<VALUE> adapter) The constructor.

Method Summary

Modifier and Type	Method and Description
protected VALUE	createCopyOfValue(VALUE value) This method will create a (deep-)copy of the given value.
protected VALUE	createNewValue() This method creates a new instance of <VALUE> (see AbstractUiFeatureValueAndValidation.getValue()).
PropertyAccessor<VALUE,?>	createPropertyAccessor(String property)
<P> PropertyAccessor<VALUE,P>	createPropertyAccessor(TypedProperty<P> property)
UiDataBindingAdapter<VALUE>	getAdapter()

Methods inherited from class net.sf.mmm.client.ui.base.binding.AbstractUiDataBinding

addChangeHandler, bind, createAndBind, createAndBind, createValidationFailure, doGetValue, doSetValue, getLabel, getLogger, getOriginalValue, getRecentValue, getSource, getValidity, getValueDirect, getWidget, isModified, removeChangeHandler, setMandatory, setModified, setValidity, setValue, toString

Methods inherited from class net.sf.mmm.client.ui.base.feature.AbstractUiFeatureValueAndValidationWithValidators

addValidator, doValidate, isMandatory, isMandatory, removeValidator

Methods inherited from class net.sf.mmm.client.ui.base.feature.AbstractUiFeatureValueAndValidation

addValidatorMandatory, clearValidity, getValue, getValueAndValidate, getValueOrException, handleGetValueError, resetValue, setValue, setValueForUser, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sf.mmm.client.ui.base.binding.UiDataBinding

doValidate

Methods inherited from interface net.sf.mmm.client.ui.api.feature.UiFeatureValueAndValidation

getValueAndValidate

Methods inherited from interface net.sf.mmm.client.ui.api.attribute.AttributeWriteValueAdvanced

resetValue, setValue, setValueForUser

Methods inherited from interface net.sf.mmm.client.ui.api.attribute.AttributeReadValueAdvanced

getValue, getValueOrException

Methods inherited from interface net.sf.mmm.client.ui.api.feature.UiFeatureValidation

addValidatorMandatory, isMandatory

Methods inherited from interface net.sf.mmm.util.validation.api.HasValueValidators

addValidator, removeValidator

Methods inherited from interface net.sf.mmm.util.validation.api.AbstractValidatableObject

validate

Field Detail

adapter

private final UiDataBindingAdapter<VALUE> adapter

See Also:

getAdapter()

Constructor Detail

UiDataBindingPojo

public UiDataBindingPojo(AbstractUiWidget<VALUE> widget,
                         UiDataBindingAdapter<VALUE> adapter)

The constructor.

Parameters:

widget - is the widget to bind.

adapter - is the UiDataBindingAdapter.

Method Detail

getAdapter

public UiDataBindingAdapter<VALUE> getAdapter()

Returns:

the UiDataBindingAdapter.

createPropertyAccessor

public PropertyAccessor<VALUE,?> createPropertyAccessor(String property)

Specified by:

createPropertyAccessor in interface UiDataBinding<VALUE>

Overrides:

createPropertyAccessor in class AbstractUiDataBinding<VALUE>

Parameters:

property - is the property name.

Returns:

a PropertyAccessor for the given property based on the Pojo type <VALUE>.

createPropertyAccessor

public <P> PropertyAccessor<VALUE,P> createPropertyAccessor(TypedProperty<P> property)

Specified by:

createPropertyAccessor in interface UiDataBinding<VALUE>

Overrides:

createPropertyAccessor in class AbstractUiDataBinding<VALUE>

Type Parameters:

P - is the generic type of the property to access - see TypedProperty.getPropertyType().

Parameters:

property - is the TypedProperty.

Returns:

a PropertyAccessor for the given property based on the Pojo type <VALUE>.

createNewValue

protected VALUE createNewValue()

This method creates a new instance of <VALUE> (see AbstractUiFeatureValueAndValidation.getValue()). It is called from AbstractUiDataBinding.getValueDirect(Object, ValidationState) or AbstractUiFeatureValueAndValidation.setValue(Object) in case the given value is null.
NOTE:
If <VALUE> is Void or a Datatype (immutable object), this method should legally return null. This can also be suitable for objects that only delegate their value to something else. Further, to be GWT compatible you cannot create the new instance via reflection. If you do not care about GWT, you can use reflection or better use it via PojoFactory.

Specified by:

createNewValue in class AbstractUiDataBinding<VALUE>

Returns:

a new instance of <VALUE>.

createCopyOfValue

protected VALUE createCopyOfValue(VALUE value)

This method will create a (deep-)copy of the given value.
ATTENTION:
If <VALUE> is immutable you can simply return null.

Specified by:

createCopyOfValue in class AbstractUiDataBinding<VALUE>

Parameters:

value - is the value to copy. Will typically be AbstractUiDataBinding.getOriginalValue(). Must NOT be modified in any way.

Returns:

a copy of the value or null if NOT implemented or supported.