org.springframework.beans.propertyeditors: public class: CharacterEditor

org.springframework.beans.propertyeditors
public class: CharacterEditor [javadoc | source]

java.lang.Object
   java.beans.PropertyEditorSupport
      org.springframework.beans.propertyeditors.CharacterEditor

All Implemented Interfaces:
PropertyEditor

Editor for a java.lang.Character , to populate a property of type Character or char from a String value.

Note that the JDK does not contain a default property editor for char! org.springframework.beans.BeanWrapperImpl will register this editor by default.

Also supports conversion from a Unicode character sequence; e.g. u0041 ('A').

Also see:

java.lang.Character

org.springframework.beans.BeanWrapperImpl

author: Juergen - Hoeller

author: Rob - Harrop

author: Rick - Evans

since: 1.2 -

Constructor:

Constructor:
public CharacterEditor(boolean allowEmpty) { this.allowEmpty = allowEmpty; } Create a new CharacterEditor instance. The "allowEmpty" parameter controls whether an empty String is to be allowed in parsing, i.e. be interpreted as the `null` value when text is being converted . If `false`, an IllegalArgumentException will be thrown at that time. Parameters: `allowEmpty` - if empty strings are to be allowed

 public CharacterEditor(boolean allowEmpty) {
	                                                     	 
		this.allowEmpty = allowEmpty;
}

Create a new CharacterEditor instance.

The "allowEmpty" parameter controls whether an empty String is to be allowed in parsing, i.e. be interpreted as the null value when text is being converted . If false, an IllegalArgumentException will be thrown at that time.

Parameters:

allowEmpty - if empty strings are to be allowed

Method from org.springframework.beans.propertyeditors.CharacterEditor Summary:
getAsText, setAsText

Methods from java.beans.PropertyEditorSupport:
addPropertyChangeListener, firePropertyChange, getAsText, getCustomEditor, getJavaInitializationString, getSource, getTags, getValue, isPaintable, paintValue, removePropertyChangeListener, setAsText, setSource, setValue, supportsCustomEditor

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.springframework.beans.propertyeditors.CharacterEditor Detail:
public String getAsText() { Object value = getValue(); return (value != null ? value.toString() : ""); }
public void setAsText(String text) throws IllegalArgumentException { if (this.allowEmpty && !StringUtils.hasLength(text)) { // Treat empty String as null value. setValue(null); } else if (text == null) { throw new IllegalArgumentException("null String cannot be converted to char type"); } else if (isUnicodeCharacterSequence(text)) { setAsUnicode(text); } else if (text.length() != 1) { throw new IllegalArgumentException("String [" + text + "] with length " + text.length() + " cannot be converted to char type"); } else { setValue(new Character(text.charAt(0))); } }

Method from org.springframework.beans.propertyeditors.CharacterEditor Detail:

 public String getAsText() {
		Object value = getValue();
		return (value != null ? value.toString() : "");
}

 public  void setAsText(String text) throws IllegalArgumentException {
		if (this.allowEmpty && !StringUtils.hasLength(text)) {
			// Treat empty String as null value.
			setValue(null);
		}
		else if (text == null) {
			throw new IllegalArgumentException("null String cannot be converted to char type");
		}
		else if (isUnicodeCharacterSequence(text)) {
			setAsUnicode(text);
		}
		else if (text.length() != 1) {
			throw new IllegalArgumentException("String [" + text + "] with length " +
					text.length() + " cannot be converted to char type");
		}
		else {
			setValue(new Character(text.charAt(0)));
		}
}