Package io.guise.framework.converter
Class DateStringLiteralConverter
java.lang.Object
com.globalmentor.beans.BoundPropertyObject
io.guise.framework.event.GuiseBoundPropertyObject
io.guise.framework.converter.AbstractConverter<V,String>
io.guise.framework.converter.AbstractDateStringLiteralConverter<Date>
io.guise.framework.converter.DateStringLiteralConverter
- All Implemented Interfaces:
com.globalmentor.beans.PropertyBindable
,com.globalmentor.beans.PropertyConstrainable
,Converter<Date,
String>
An object that can convert a date/time from and to a string. This implementation caches a date format and only creates a new one if the locale has changed.
This implementation synchronizes all conversions on the
DateFormat
object.- Author:
- Garret Wilson
-
Field Summary
Fields inherited from class com.globalmentor.beans.BoundPropertyObject
NO_PROPERTY_CHANGE_LISTENERS, NO_VETOABLE_CHANGE_LISTENERS
Fields inherited from interface io.guise.framework.converter.Converter
INVALID_VALUE_MESSAGE_PROPERTY
-
Constructor Summary
ConstructorDescriptionDateStringLiteralConverter
(DateStringLiteralStyle dateStyle) Date style constructor with no time style.DateStringLiteralConverter
(DateStringLiteralStyle dateStyle, TimeStringLiteralStyle timeStyle) Date style and time style constructor. -
Method Summary
Modifier and TypeMethodDescriptionconvertLiteral
(String literal) Converts a literal representation of a value from the lexical space into a value in the value space.convertValue
(Date value) Converts a value from the value space to a literal value in the lexical space.Methods inherited from class io.guise.framework.converter.AbstractDateStringLiteralConverter
convertDateLiteral, convertDateValue, createDateFormat, getDateFormat, getDateStyle, getTimeStyle
Methods inherited from class io.guise.framework.converter.AbstractConverter
getInvalidValueMessage, isEquivalent, isValidLiteral, setInvalidValueMessage
Methods inherited from class io.guise.framework.event.GuiseBoundPropertyObject
getSession
Methods inherited from class com.globalmentor.beans.BoundPropertyObject
addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, createPostponedPropertyChangeEvent, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, fireVetoableChange, getForwardPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, getPropertyChangeSupport, getRepeatPropertyChangeListener, getRepeatVetoableChangeListener, getVetoableChangeListeners, getVetoableChangeListeners, getVetoableChangeSupport, hasPropertyChangeListeners, hasVetoableChangeListeners, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface io.guise.framework.converter.Converter
getSession
Methods inherited from interface com.globalmentor.beans.PropertyBindable
addPropertyChangeListener, addPropertyChangeListener, getPropertyChangeListeners, getPropertyChangeListeners, hasPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener
-
Constructor Details
-
DateStringLiteralConverter
Date style constructor with no time style.- Parameters:
dateStyle
- The date representation style, ornull
if the date should not be represented.- Throws:
NullPointerException
- if the given date style isnull
.
-
DateStringLiteralConverter
public DateStringLiteralConverter(DateStringLiteralStyle dateStyle, TimeStringLiteralStyle timeStyle) Date style and time style constructor.- Parameters:
dateStyle
- The date representation style, ornull
if the date should not be represented.timeStyle
- The time representation style, ornull
if the time should not be represented.- Throws:
NullPointerException
- if both the given date style and time style arenull
.
-
-
Method Details
-
convertValue
Converts a value from the value space to a literal value in the lexical space.This implementation converts the value using the date format object. This implementation synchronizes on the
DateFormat
instance.- Parameters:
value
- The value in the value space to convert.- Returns:
- The converted value in the lexical space, or
null
if the given literal isnull
. - Throws:
ConversionException
- if the value cannot be converted.- See Also:
-
convertLiteral
Converts a literal representation of a value from the lexical space into a value in the value space.This implementation converts the empty string to a
null
value.- Parameters:
literal
- The literal value in the lexical space to convert.- Returns:
- The converted value in the value space, or
null
if the given literal isnull
. - Throws:
ConversionException
- if the literal value cannot be converted.
-