org.mule.runtime.config.internal.editors

Class DatePropertyEditor

java.lang.Object

java.beans.PropertyEditorSupport

org.mule.runtime.config.internal.editors.DatePropertyEditor

All Implemented Interfaces:

PropertyEditor

public class DatePropertyEditor
extends PropertyEditorSupport

Handles the conversion of date strings in Date objects.

Constructor Summary

Constructors

Constructor and Description
DatePropertyEditor(DateFormat longDateFormat, boolean allowEmpty, int exactDateLength) Create a new CustomDateEditor instance, using the given DateFormat for parsing and rendering.
DatePropertyEditor(DateFormat longDateFormat, DateFormat shortDateFormat, boolean allowEmpty) Create a new CustomDateEditor instance, using the given DateFormat for parsing and rendering.

Method Summary

Modifier and Type	Method and Description
String	getAsText() Format the Date as String, using the specified DateFormat.
void	setAsText(String text) Parse the Date from the given text, using the specified DateFormat.

Methods inherited from class java.beans.PropertyEditorSupport

addPropertyChangeListener, firePropertyChange, getCustomEditor, getJavaInitializationString, getSource, getTags, getValue, isPaintable, paintValue, removePropertyChangeListener, setSource, setValue, supportsCustomEditor

Methods inherited from class java.lang.Object

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

Constructor Detail

DatePropertyEditor

public DatePropertyEditor(DateFormat longDateFormat,
                          DateFormat shortDateFormat,
                          boolean allowEmpty)

Create a new CustomDateEditor instance, using the given DateFormat for parsing and rendering.

The "allowEmpty" parameter states if an empty String should be allowed for parsing, i.e. get interpreted as null value. Otherwise, an IllegalArgumentException gets thrown in that case.

Parameters:

longDateFormat - DateFormat to use for parsing and rendering

shortDateFormat - a short form of DateFormat to use for parsing and rendering

allowEmpty - if empty strings should be allowed

DatePropertyEditor

public DatePropertyEditor(DateFormat longDateFormat,
                          boolean allowEmpty,
                          int exactDateLength)

Create a new CustomDateEditor instance, using the given DateFormat for parsing and rendering.

The "allowEmpty" parameter states if an empty String should be allowed for parsing, i.e. get interpreted as null value. Otherwise, an IllegalArgumentException gets thrown in that case.

The "exactDateLength" parameter states that IllegalArgumentException gets thrown if the String does not exactly match the length specified. This is useful because SimpleDateFormat does not enforce strict parsing of the year part, not even with setLenient(false). Without an "exactDateLength" specified, the "01/01/05" would get parsed to "01/01/0005".

Parameters:

longDateFormat - DateFormat to use for parsing and rendering

allowEmpty - if empty strings should be allowed

exactDateLength - the exact expected length of the date String

Method Detail

setAsText

public void setAsText(String text)
               throws IllegalArgumentException

Parse the Date from the given text, using the specified DateFormat.

Specified by:

setAsText in interface PropertyEditor

Overrides:

setAsText in class PropertyEditorSupport

Throws:

IllegalArgumentException

getAsText

public String getAsText()

Format the Date as String, using the specified DateFormat.

Specified by:

getAsText in interface PropertyEditor

Overrides:

getAsText in class PropertyEditorSupport