|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
S
- the source typeT
- the target typepublic interface BindingConverter<S,T>
Describes an object that converts values from a binding target to a binding source and vice versa.
Used by the binder mechanism to introduce a conversion in the binding chain from source to target. Often the binding source is a bean property that has been turned into a ValueModel. The binding target is typically a user interface component, e.g. combo box or text field.
Example:
binder.bindBeanProperty("price").converted(currencyConverter).to(priceField);
This conversion is similar to the String conversion of the Format class,
where Format.format(Object)
equates to targetValue(Object)
,
and Format.parseObject(String)
to sourceValue(Object)
.
Binding converters should be used judiciously; they can be limited
w.r.t. to localized formatting conventions. When binding non-String values
to a text UI component, consider using a JFormattedTextField
.
Formatted text fields provide a powerful means to convert strings to objects
and handle many cases that arise around invalid input.
Method Summary | |
---|---|
S |
sourceValue(T targetValue)
Returns the converted target value for use by the binding source. |
T |
targetValue(S sourceValue)
Returns the converted source value for use by the binding target. |
Method Detail |
---|
T targetValue(S sourceValue)
Format.format(Object)
if the target
accepts and provides Strings.
sourceValue
- the value to convert
S sourceValue(T targetValue)
Format.parseObject(String)
if the target
accepts and provides Strings.
targetValue
- the value to convert
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |