org.springframework.beans.propertyeditors
Class CustomBooleanEditor

java.lang.Object
  extended by java.beans.PropertyEditorSupport
      extended by org.springframework.beans.propertyeditors.CustomBooleanEditor
All Implemented Interfaces:
PropertyEditor

public class CustomBooleanEditor
extends PropertyEditorSupport

Property editor for Boolean/boolean properties.

This is not meant to be used as system PropertyEditor but rather as locale-specific Boolean editor within custom controller code, to parse UI-caused boolean strings into boolean properties of beans and check 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:
10.06.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)

Field Summary
static String VALUE_0
           
static String VALUE_1
           
static String VALUE_FALSE
           
static String VALUE_NO
           
static String VALUE_OFF
           
static String VALUE_ON
           
static String VALUE_TRUE
           
static String VALUE_YES
           
 
Constructor Summary
CustomBooleanEditor(boolean allowEmpty)
          Create a new CustomBooleanEditor instance, with "true"/"on"/"yes" and "false"/"off"/"no" as recognized String values.
CustomBooleanEditor(String trueString, String falseString, boolean allowEmpty)
          Create a new CustomBooleanEditor instance, with configurable String values for true and false.
 
Method Summary
 String getAsText()
           
 void setAsText(String text)
           
 
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
 

Field Detail

VALUE_TRUE

public static final String VALUE_TRUE
See Also:
Constant Field Values

VALUE_FALSE

public static final String VALUE_FALSE
See Also:
Constant Field Values

VALUE_ON

public static final String VALUE_ON
See Also:
Constant Field Values

VALUE_OFF

public static final String VALUE_OFF
See Also:
Constant Field Values

VALUE_YES

public static final String VALUE_YES
See Also:
Constant Field Values

VALUE_NO

public static final String VALUE_NO
See Also:
Constant Field Values

VALUE_1

public static final String VALUE_1
See Also:
Constant Field Values

VALUE_0

public static final String VALUE_0
See Also:
Constant Field Values
Constructor Detail

CustomBooleanEditor

public CustomBooleanEditor(boolean allowEmpty)
Create a new CustomBooleanEditor instance, with "true"/"on"/"yes" and "false"/"off"/"no" as recognized String values.

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:
allowEmpty - if empty strings should be allowed

CustomBooleanEditor

public CustomBooleanEditor(String trueString,
                           String falseString,
                           boolean allowEmpty)
Create a new CustomBooleanEditor instance, with configurable String values for true and false.

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:
trueString - the String value that represents true: for example, "true" (VALUE_TRUE), "on" (VALUE_ON), "yes" (VALUE_YES) or some custom value
falseString - the String value that represents false: for example, "false" (VALUE_FALSE), "off" (VALUE_OFF), "no" (VALUE_NO) or some custom value
allowEmpty - if empty strings should be allowed
See Also:
VALUE_TRUE, VALUE_FALSE, VALUE_ON, VALUE_OFF, VALUE_YES, VALUE_NO
Method Detail

setAsText

public void setAsText(String text)
               throws IllegalArgumentException
Specified by:
setAsText in interface PropertyEditor
Overrides:
setAsText in class PropertyEditorSupport
Throws:
IllegalArgumentException

getAsText

public String getAsText()
Specified by:
getAsText in interface PropertyEditor
Overrides:
getAsText in class PropertyEditorSupport


Copyright (c) 2002-2007 The Spring Framework Project.