org.tentackle.swing.bind

Class DefaultFormTableBinder<S>

java.lang.Object

org.tentackle.bind.AbstractBinder

org.tentackle.swing.bind.DefaultFormTableBinder<S>

Type Parameters:

S - type of the objects contained within the table's items list

All Implemented Interfaces:

Comparable<Binder>, Binder, FormTableBinder<S>

public class DefaultFormTableBinder<S>
extends AbstractBinder
implements FormTableBinder<S>

Binding Workhorse.

Author:

harald

Constructor Summary

Constructors

Constructor and Description
DefaultFormTableBinder(BindableTableModel<S> model) Creates a binder for a table.

Method Summary

Modifier and Type	Method and Description
void	addBinding(Binding binding) Programmatically adds a binding to this form.
void	assertAllBound() Tests the binding. The method verifies that all components of the form are bound and throws a BindingException if it finds at least one unbound component. All unbound components are logged.
int	bind() Binds objects to a form.
int	bindAllInherited() Binds objects to a form.
protected int	doBind(BindingMember[] parents, String parentMemberPath, Class<?> parentClass, boolean declaredOnly)
FormTableBinding	getBinding(int mColumn) Gets a binding by component.
FormTableBinding	getBinding(String bindingPath)
Collection<? extends Binding>	getBindings() Gets the list of all bindings for this form.
Integer[]	getBoundColumns() Gets the list of all bound components of this form.
BindableTableModel<S>	getModel() Gets the table model.
Integer[]	getUnboundColumns() Gets the list of all unbound components of this form.
FormTableBinding	removeBinding(int mColumn) Programmatically removes a binding from the table.
FormTableBinding	removeBinding(String bindingPath) Programmatically removes a binding from this form.
void	unbind() Removes all bindings of the form.

Methods inherited from class org.tentackle.bind.AbstractBinder

addToModelListener, addToViewListener, addValidationListener, compareTo, equals, fireToModel, fireToView, fireValidated, getBindingProperty, getBindingProperty, getInstanceNumber, getToModelListeners, getToViewListeners, getValidationListeners, getValidationScope, hashCode, putBindingProperty, removeToModelListener, removeToViewListener, removeValidationListener, setValidationScope

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tentackle.bind.Binder

addToModelListener, addToViewListener, addValidationListener, fireToModel, fireToView, fireValidated, getBindingProperty, getBindingProperty, getInstanceNumber, getToModelListeners, getToViewListeners, getValidationListeners, getValidationScope, putBindingProperty, removeToModelListener, removeToViewListener, removeValidationListener, setValidationScope

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Detail

DefaultFormTableBinder

public DefaultFormTableBinder(BindableTableModel<S> model)

Creates a binder for a table.

Parameters:

model - the table model to bind

Method Detail

getModel

public BindableTableModel<S> getModel()

Description copied from interface: FormTableBinder

Gets the table model.

Specified by:

getModel in interface FormTableBinder<S>

Returns:

the bound table model

bindAllInherited

public int bindAllInherited()

Binds objects to a form.

The form and all components in the form's parent classes and all members or submembers annotated with the Bindable-annotation. Inherited members will be included as well.

Notice that the object references are not kept in the binding.

CAUTION: expensive operation!

Specified by:

bindAllInherited in interface Binder

Returns:

number of members bound

bind

public int bind()

Binds objects to a form.

The form will be scanned for members or submembers annotated with the Bindable-annotation. Inherited members will not be included.

Notice that the object references are not kept in the binding.

Specified by:

bind in interface Binder

Returns:

number of members bound

unbind

public void unbind()

Removes all bindings of the form.

Specified by:

unbind in interface Binder

getBindings

public Collection<? extends Binding> getBindings()

Gets the list of all bindings for this form.

Specified by:

getBindings in interface Binder

Returns:

the bindings, never null

getBoundColumns

public Integer[] getBoundColumns()

Gets the list of all bound components of this form.

Specified by:

getBoundColumns in interface FormTableBinder<S>

Returns:

the list of bound components

getUnboundColumns

public Integer[] getUnboundColumns()

Gets the list of all unbound components of this form.

Specified by:

getUnboundColumns in interface FormTableBinder<S>

Returns:

the list of unbound components.

assertAllBound

public void assertAllBound()
                    throws BindingException

Tests the binding.
The method verifies that all components of the form are bound and throws a BindingException if it finds at least one unbound component.
All unbound components are logged.

Specified by:

assertAllBound in interface Binder

Throws:

BindingException - if at least one unbound component found

addBinding

public void addBinding(Binding binding)

Programmatically adds a binding to this form.

Specified by:

addBinding in interface Binder

Parameters:

binding - the binding to add

getBinding

public FormTableBinding getBinding(int mColumn)

Description copied from interface: FormTableBinder

Gets a binding by component.

Specified by:

getBinding in interface FormTableBinder<S>

Parameters:

mColumn - the model column

Returns:

the binding, null if column not bound

getBinding

public FormTableBinding getBinding(String bindingPath)

Description copied from interface: FormTableBinder

Overridden to cast.

Specified by:

getBinding in interface Binder

Specified by:

getBinding in interface FormTableBinder<S>

removeBinding

public FormTableBinding removeBinding(int mColumn)

Description copied from interface: FormTableBinder

Programmatically removes a binding from the table.

Specified by:

removeBinding in interface FormTableBinder<S>

Parameters:

mColumn - the model column

Returns:

the removed binding, null if no such binding found

removeBinding

public FormTableBinding removeBinding(String bindingPath)

Programmatically removes a binding from this form.

Specified by:

removeBinding in interface Binder

Specified by:

removeBinding in interface FormTableBinder<S>

Parameters:

bindingPath - the object's binding path

Returns:

the removed binding, null if no such binding found

doBind

protected int doBind(BindingMember[] parents,
                     String parentMemberPath,
                     Class<?> parentClass,
                     boolean declaredOnly)

Specified by:

doBind in class AbstractBinder