org.springframework.beans.propertyeditors

Class CustomBooleanEditor

java.lang.Object

java.beans.PropertyEditorSupport

org.springframework.beans.propertyeditors.CustomBooleanEditor

All Implemented Interfaces:

java.beans.PropertyEditor

public class CustomBooleanEditor
extends java.beans.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.

Since:

10.06.2003

Author:

Juergen Hoeller

See Also:

DataBinder.registerCustomEditor(java.lang.Class<?>, java.beans.PropertyEditor)

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	VALUE_0
static java.lang.String	VALUE_1
static java.lang.String	VALUE_FALSE
static java.lang.String	VALUE_NO
static java.lang.String	VALUE_OFF
static java.lang.String	VALUE_ON
static java.lang.String	VALUE_TRUE
static java.lang.String	VALUE_YES

Constructor Summary

Constructors

Constructor and Description
CustomBooleanEditor(boolean allowEmpty) Create a new CustomBooleanEditor instance, with "true"/"on"/"yes" and "false"/"off"/"no" as recognized String values.
CustomBooleanEditor(java.lang.String trueString, java.lang.String falseString, boolean allowEmpty) Create a new CustomBooleanEditor instance, with configurable String values for true and false.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAsText()
void	setAsText(java.lang.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 java.lang.String VALUE_TRUE

See Also:

Constant Field Values

VALUE_FALSE

public static final java.lang.String VALUE_FALSE

See Also:

Constant Field Values

VALUE_ON

public static final java.lang.String VALUE_ON

See Also:

Constant Field Values

VALUE_OFF

public static final java.lang.String VALUE_OFF

See Also:

Constant Field Values

VALUE_YES

public static final java.lang.String VALUE_YES

See Also:

Constant Field Values

VALUE_NO

public static final java.lang.String VALUE_NO

See Also:

Constant Field Values

VALUE_1

public static final java.lang.String VALUE_1

See Also:

Constant Field Values

VALUE_0

public static final java.lang.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(@Nullable
                           java.lang.String trueString,
                           @Nullable
                           java.lang.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(@Nullable
                      java.lang.String text)
               throws java.lang.IllegalArgumentException

Specified by:

setAsText in interface java.beans.PropertyEditor

Overrides:

setAsText in class java.beans.PropertyEditorSupport

Throws:

java.lang.IllegalArgumentException

getAsText

public java.lang.String getAsText()

Specified by:

getAsText in interface java.beans.PropertyEditor

Overrides:

getAsText in class java.beans.PropertyEditorSupport