no.g9.support.convert

Class SimpleDateConverter

java.lang.Object

no.g9.support.convert.SimpleDateConverter

public class SimpleDateConverter
extends Object

SimpleDateConverter is a custom DateTimeConverter which handles g9 display rules in a Jouteur and Jasper context.

The getAsObject() method parses a String into a java.util.Date, according to the following algorithm:

• If the specified String is null, return a null. Otherwise, trim leading and trailing whitespace before proceeding.
• If the specified String - after trimming - has a zero length, return null.
• If a displayRule has been specified, its syntax must conform the rules specified by java.text.SimpleDateFormat. Such a displayRule will be used to parse, and the type, dateStyle, and timeStyle properties will be ignored.
• If a displayRule has not been specified, parsing will be based on the type property, which expects a date value, a time value, or both. Any date and time values included will be parsed in accordance to the styles specified by dateStyle and timeStyle, respectively.
• In all cases, parsing must be non-lenient; the given string must strictly adhere to the parsing format.

The getAsString() method expects a value of type java.util.Date (or a subclass), and creates a formatted String according to the following algorithm:

• If the specified value is null, return a zero-length String.
• If the specified value is a String, return it unmodified.
• If a displayRule has been specified, its syntax must conform the rules specified by java.text.SimpleDateFormat. Such a displayRule will be used to format, and the dataType, dateStyle, and timeStyle properties will be ignored.
• If a displayRule has not been specified, formatting will be based on the dataType property, which includes a date value, a time value, or both into the formatted String. Any date and time values included will be formatted in accordance to the styles specified by dateStyle and timeStyle, respectively.

Constructor Summary

Constructors

Constructor and Description
SimpleDateConverter(String dataType, String displayRule) Create a new g9 date converter.
SimpleDateConverter(String dataType, String displayRule, Locale locale) Create a new g9 date converter.

Method Summary

Modifier and Type	Method and Description
Object	getAsObject(String value) Convert the specified string value from a field, into a model data object that is appropriate for being stored during the Apply Request Values phase of the request processing life cycle.
String	getAsString(Object value)
String	getDataType()
String	getDefaultStyle()
String	getDisplayRule()
void	setDataType(String dataType)
void	setDefaultStyle(String defaultStyle)
void	setDisplayRule(String displayRule) Set the format displayRule to be used when formatting and parsing dates and times.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleDateConverter

public SimpleDateConverter(String dataType,
                           String displayRule,
                           Locale locale)

Create a new g9 date converter. Sets the converter time zone to the current default time zone.

Parameters:

dataType - to be converted

displayRule - for the field

locale - for the converter

SimpleDateConverter

public SimpleDateConverter(String dataType,
                           String displayRule)

Create a new g9 date converter. Sets the converter time zone to the current default time zone. Locale is set to system default locale.

Parameters:

dataType - to be converted

displayRule - for the field

Method Detail

getAsObject

public Object getAsObject(String value)

Convert the specified string value from a field, into a model data object that is appropriate for being stored during the Apply Request Values phase of the request processing life cycle.

Parameters:

value - to be converted

Returns:

value as Date object

getAsString

public String getAsString(Object value)

Parameters:

value - to convert

Returns:

String representation of the date

setDisplayRule

public void setDisplayRule(String displayRule)

Set the format displayRule to be used when formatting and parsing dates and times. Valid values are those supported by java.text.SimpleDateFormat. An invalid value will cause a SimpleDateConverterException when getAsObject() or getAsString() is called.

Parameters:

displayRule - The new format displayRule

getDisplayRule

public String getDisplayRule()

Returns:

displayRule

setDataType

public void setDataType(String dataType)

Parameters:

dataType - to be set

getDataType

public String getDataType()

Returns:

dataType

getDefaultStyle

public String getDefaultStyle()

Returns:

defaultStyle

setDefaultStyle

public void setDefaultStyle(String defaultStyle)

Parameters:

defaultStyle - to be set