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

Class UiDataBindingList

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<List>

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

All Implemented Interfaces:

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

public class UiDataBindingList
extends AbstractUiDataBinding<List>

This is the implementation of UiDataBinding for the type List.

Since:

1.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Constructor Summary

Constructors

Constructor and Description
UiDataBindingList(AbstractUiWidget widget) The constructor.

Method Summary

Modifier and Type	Method and Description
protected List	createCopyOfValue(List value) This method will create a (deep-)copy of the given value.
protected List	createNewValue() This method creates a new instance of <VALUE> (see AbstractUiFeatureValueAndValidation.getValue()).

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

addChangeHandler, bind, createAndBind, createAndBind, createPropertyAccessor, createPropertyAccessor, 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

Constructor Detail

UiDataBindingList

public UiDataBindingList(AbstractUiWidget widget)

The constructor.

Parameters:

widget - is the widget to bind.

Method Detail

createNewValue

protected List 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<List>

Returns:

a new instance of <VALUE>.

createCopyOfValue

protected List createCopyOfValue(List 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<List>

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.