to.etc.domui.component.binding

Class ComponentPropertyBinding

java.lang.Object

to.etc.domui.component.binding.ComponentPropertyBinding

All Implemented Interfaces:

IBinding

@DefaultNonNull
public final class ComponentPropertyBinding
extends Object
implements IBinding

This binds a control property to some model property.

Author:

Frits Jalvingh Created on Oct 13, 2009

Constructor Summary

Constructors

Constructor and Description
ComponentPropertyBinding(NodeBase control, String controlProperty)

Method Summary

Modifier and Type	Method and Description
ComponentPropertyBinding	convert(IBindingConverter<?,?> converter)
UIMessage	getBindError() If this binding is in error: return the message describing that error.
BindingValuePair<?,?>	getBindingDifference() Move the control value to wherever it's needed.
IValueAccessor<?>	getControlProperty()
Object	getInstance()
IValueAccessor<?>	getInstanceProperty()
void	moveModelToControl()
<T> void	setModelValue(T value) Put the specified value into the bound model property.
void	to(IBindingListener<?> listener)
<T,V> void	to(T instance, IValueAccessor<V> pmm) Bind to a IValueAccessor and the given instance.
<T> void	to(T instance, String property)
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ComponentPropertyBinding

public ComponentPropertyBinding(@Nonnull
                                NodeBase control,
                                @Nonnull
                                String controlProperty)

Method Detail

convert

@Nonnull
public ComponentPropertyBinding convert(@Nullable
                                                 IBindingConverter<?,?> converter)

to

public void to(@Nonnull
               IBindingListener<?> listener)

to

public <T> void to(@Nonnull
                   T instance,
                   @Nonnull
                   String property)
            throws Exception

Throws:

Exception

to

public <T,V> void to(@Nonnull
                     T instance,
                     @Nonnull
                     IValueAccessor<V> pmm)
              throws Exception

Bind to a IValueAccessor and the given instance.

Parameters:

instance -

pmm -

Throws:

Exception

getBindError

@Nullable
public UIMessage getBindError()

If this binding is in error: return the message describing that error.

Specified by:

getBindError in interface IBinding

Returns:

getControlProperty

@Nonnull
public IValueAccessor<?> getControlProperty()

toString

public String toString()

Overrides:

toString in class Object

getInstance

@Nullable
public Object getInstance()

getInstanceProperty

@Nullable
public IValueAccessor<?> getInstanceProperty()

setModelValue

public <T> void setModelValue(@Nullable
                              T value)

Description copied from interface: IBinding

Put the specified value into the bound model property.

Specified by:

setModelValue in interface IBinding

Type Parameters:

T -

Parameters:

value -

getBindingDifference

@Nullable
public BindingValuePair<?,?> getBindingDifference()
                                                     throws Exception

Move the control value to wherever it's needed. If this is a listener binding it calls the listener, else it moves the value either to the model's value or the instance's value. This is the *hard* part of binding: it needs to handle control errors caused by bindValue() throwing an exception.

Specified by:

getBindingDifference in interface IBinding

Throws:

Exception

moveModelToControl

public void moveModelToControl()
                        throws Exception

Specified by:

moveModelToControl in interface IBinding

Throws:

Exception