S
- the source typeT
- the target typepublic interface BindingConverter<S,T>
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.
Modifier and Type | Method and Description |
---|---|
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.
|
T targetValue(S sourceValue)
Format.format(Object)
if the target
accepts and provides Strings.sourceValue
- the value to convertS sourceValue(T targetValue)
Format.parseObject(String)
if the target
accepts and provides Strings.targetValue
- the value to convertCopyright © 2002-2015 JGoodies Software GmbH. All Rights Reserved.