org.springframework.beans.propertyeditors
Class CustomDateEditor

java.lang.Object
  extended byjava.beans.PropertyEditorSupport
      extended byorg.springframework.beans.propertyeditors.CustomDateEditor
All Implemented Interfaces:
java.beans.PropertyEditor

public class CustomDateEditor
extends java.beans.PropertyEditorSupport

PropertyEditor for Date, supporting a custom DateFormat.

This is not meant to be used as system PropertyEditor but rather as locale-specific date editor within custom controller code, to parse user-entered date strings into Date properties of beans, and render them in the UI form.

In web MVC code, this editor will typically be registered with binder.registerCustomEditor calls in an implementation of BaseCommandController's initBinder method.

Since:
28.04.2003
Author:
Juergen Hoeller
See Also:
DataBinder.registerCustomEditor(java.lang.Class, java.beans.PropertyEditor), BaseCommandController.initBinder(javax.servlet.http.HttpServletRequest, org.springframework.web.bind.ServletRequestDataBinder), BindInitializer.initBinder(javax.servlet.ServletRequest, org.springframework.web.bind.ServletRequestDataBinder)

Constructor Summary
CustomDateEditor(java.text.DateFormat dateFormat, boolean allowEmpty)
          Create a new instance, using the given DateFormat for parsing and rendering.
 
Method Summary
 java.lang.String getAsText()
          Format the Date as String, using the specified DateFormat.
 void setAsText(java.lang.String text)
          Parse the Date from the given text, using the specified DateFormat.
 
Methods inherited from class java.beans.PropertyEditorSupport
addPropertyChangeListener, firePropertyChange, getCustomEditor, getJavaInitializationString, getTags, getValue, isPaintable, paintValue, removePropertyChangeListener, setValue, supportsCustomEditor
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CustomDateEditor

public CustomDateEditor(java.text.DateFormat dateFormat,
                        boolean allowEmpty)
Create a new 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. Else, an IllegalArgumentException gets thrown in that case.

Parameters:
dateFormat - DateFormat to use for parsing and rendering
allowEmpty - if empty strings should be allowed
Method Detail

setAsText

public void setAsText(java.lang.String text)
               throws java.lang.IllegalArgumentException
Parse the Date from the given text, using the specified DateFormat.

Throws:
java.lang.IllegalArgumentException

getAsText

public java.lang.String getAsText()
Format the Date as String, using the specified DateFormat.



Copyright (C) 2003-2004 The Spring Framework Project.