to.etc.domui.component.controlfactory

Class ModelBindings

java.lang.Object

to.etc.domui.component.controlfactory.ModelBindings

All Implemented Interfaces:

Iterable<IModelBinding>, IModelBinding

public class ModelBindings
extends Object
implements IModelBinding, Iterable<IModelBinding>

This represents a list of IModelBindings. Each binding connects a UI Control (the input component) with a given property of the data model. This list can be used to collect all of the component-property bindings for an entire form, so that the data from the model can be moved into the controls that edit that model in one call. And of course the reverse, moving all edited control data back to the model is possible too.

A ModelBindings list is itself an IModelBinding too, so you can add this list to another list of bindings too.

Author:

Frits Jalvingh Created on Jul 20, 2011

Constructor Summary

Constructors

Constructor and Description
ModelBindings()

Method Summary

Modifier and Type	Method and Description
void	add(IModelBinding b) Add a binding to the list.
void	clear() Remove all bindings from this list.
IModelBinding	get(int ix) Get the nth binding stored in this list.
Iterator<IModelBinding>	iterator() Get an iterator to pass over all bindings in this list.
void	moveControlToModel() Move the data from the controls to the data model.
void	moveModelToControl() Move the data from model to the controls for all controls added to the list.
void	setControlsEnabled(boolean on) Enable or disable all bound components.
int	size() Return the #of bindings present in the list.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

ModelBindings

public ModelBindings()

Method Detail

add

public void add(@Nonnull
                IModelBinding b)

Add a binding to the list.

Parameters:

b -

moveControlToModel

public void moveControlToModel()
                        throws Exception

Move the data from the controls to the data model. If any control validation fails the move stops at the failing control, so this reports at most one validation error.

Specified by:

moveControlToModel in interface IModelBinding

Throws:

Exception

See Also:

IModelBinding.moveControlToModel()

moveModelToControl

public void moveModelToControl()
                        throws Exception

Move the data from model to the controls for all controls added to the list.

Specified by:

moveModelToControl in interface IModelBinding

Throws:

Exception

See Also:

IModelBinding.moveModelToControl()

size

public int size()

Return the #of bindings present in the list. Watch out: a ModelBinding that is itself added to the list counts as one item, even though it has many items inside itself.

Returns:

clear

public void clear()

Remove all bindings from this list.

setControlsEnabled

public void setControlsEnabled(boolean on)

Enable or disable all bound components.

Specified by:

setControlsEnabled in interface IModelBinding

See Also:

IModelBinding.setControlsEnabled(boolean)

iterator

@Nonnull
public Iterator<IModelBinding> iterator()

Get an iterator to pass over all bindings in this list.

Specified by:

iterator in interface Iterable<IModelBinding>

See Also:

Iterable.iterator()

get

@Nonnull
public IModelBinding get(int ix)

Get the nth binding stored in this list.

Parameters:

ix -

Returns: