com.jgoodies.binding.value
Class AbstractConverter
java.lang.Object
com.jgoodies.common.bean.Bean
com.jgoodies.binding.beans.Model
com.jgoodies.binding.value.AbstractValueModel
com.jgoodies.binding.value.AbstractWrappedValueModel
com.jgoodies.binding.value.AbstractConverter
- All Implemented Interfaces:
- ComponentModel, ComponentValueModel, ValueModel, com.jgoodies.common.bean.ObservableBean, com.jgoodies.common.bean.ObservableBean2, Serializable
Deprecated. Replaced by the BindingConverter
interface
and - if necessary - the ConverterValueModel
@Deprecated
public abstract class AbstractConverter
- extends AbstractWrappedValueModel
An abstract class that minimizes the effort required to implement
a type converter. A type converter is a ValueModel that converts the type
of an object being held as a value in one ValueModel into another type.
More formally, a converting ValueModel VM1 converts the type
T2 of an object being held as a value in one ValueModel VM2
into another type T1. When reading a value from VM1,
instances of T2 are read from VM2 and are converted to T1. When storing
a new value to VM1, the type converter will perform the inverse conversion
and will convert an instance of T1 to T2.
The conversion must be performed when reading and writing values,
as well as in the change notification. This class specifies abstract
methods for the conversion from source to output, which is used to
convert in #getValue
and in the change notification.
For the write conversion you must implement #setValue
.
Most converters can set values converted by #convertFromSubject
with #setValue
. However, a converter may reject subject values
to be converted and may reject values to be set - as any ValueModel.
Type converters should be used judiciously and only to bridge two
ValueModel
s. Converters often use a generic but weak
conversion, and so 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. Formatted text fields can be bound
to ValueModel
s using the
PropertyConnector
class.
- Version:
- $Revision: 1.15 $
- Author:
- Karsten Lentzsch
- See Also:
ValueModel
,
ConverterFactory
,
JFormattedTextField
,
PropertyConnector
,
Serialized Form
Field Summary |
protected ValueModel |
subject
Deprecated. Holds the ValueModel that in turn holds the source value. |
Fields inherited from class com.jgoodies.common.bean.Bean |
changeSupport |
Methods inherited from class com.jgoodies.binding.value.AbstractValueModel |
addValueChangeListener, booleanValue, doubleValue, fireValueChange, fireValueChange, fireValueChange, fireValueChange, fireValueChange, fireValueChange, fireValueChange, floatValue, getString, intValue, longValue, paramString, removeValueChangeListener, setValue, setValue, setValue, setValue, setValue, toString, valueString |
Methods inherited from class com.jgoodies.common.bean.Bean |
addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, fireIndexedPropertyChange, fireIndexedPropertyChange, fireIndexedPropertyChange, fireMultiplePropertiesChanged, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, getVetoableChangeListeners, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener |
Methods inherited from interface com.jgoodies.common.bean.ObservableBean2 |
addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener |
Methods inherited from interface com.jgoodies.common.bean.ObservableBean |
addPropertyChangeListener, removePropertyChangeListener |
subject
protected final ValueModel subject
- Deprecated.
- Holds the ValueModel that in turn holds the source value.
AbstractConverter
public AbstractConverter(ValueModel subject)
- Deprecated.
- Constructs an AbstractConverter on the given subject.
- Parameters:
subject
- the ValueModel that holds the source value
- Throws:
NullPointerException
- if the subject is null
convertFromSubject
public abstract Object convertFromSubject(Object subjectValue)
- Deprecated.
- Converts a value from the subject to the type or format used
by this converter.
- Parameters:
subjectValue
- the subject's value
- Returns:
- the converted value in the type or format used by this converter
getValue
public Object getValue()
- Deprecated.
- Converts the subject's value and returns the converted value.
- Returns:
- the converted subject value
createValueChangeHandler
protected PropertyChangeListener createValueChangeHandler()
- Deprecated.
- Specified by:
createValueChangeHandler
in class AbstractWrappedValueModel
Copyright © 2002-2012 JGoodies Karsten Lentzsch. All Rights Reserved.