|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.beans.PropertyEditorSupport org.springframework.beans.propertyeditors.CustomNumberEditor
public class CustomNumberEditor
Property editor for any Number subclass like Integer, Long, Float, Double.
Can use a given NumberFormat for (locale-specific) parsing and rendering,
or alternatively the default valueOf
respectively
toString
methods.
This is not meant to be used as system PropertyEditor but rather as locale-specific number editor within custom controller code, to parse user-entered number strings into Number 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.
Number
,
NumberFormat
,
DataBinder.registerCustomEditor(java.lang.Class, java.beans.PropertyEditor)
,
BaseCommandController.initBinder(javax.servlet.http.HttpServletRequest, org.springframework.web.bind.ServletRequestDataBinder)
Constructor Summary | |
---|---|
CustomNumberEditor(Class numberClass,
boolean allowEmpty)
Create a new CustomNumberEditor instance, using the default valueOf methods for parsing and toString
methods for rendering. |
|
CustomNumberEditor(Class numberClass,
NumberFormat numberFormat,
boolean allowEmpty)
Create a new CustomNumberEditor instance, using the given NumberFormat for parsing and rendering. |
Method Summary | |
---|---|
String |
getAsText()
Format the Number as String, using the specified NumberFormat. |
void |
setAsText(String text)
Parse the Number from the given text, using the specified NumberFormat. |
void |
setValue(Object value)
Coerce a Number value into the required target class, if necessary. |
Methods inherited from class java.beans.PropertyEditorSupport |
---|
addPropertyChangeListener, firePropertyChange, getCustomEditor, getJavaInitializationString, getSource, getTags, getValue, isPaintable, paintValue, removePropertyChangeListener, setSource, supportsCustomEditor |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public CustomNumberEditor(Class numberClass, boolean allowEmpty) throws IllegalArgumentException
valueOf
methods for parsing and toString
methods for 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.
numberClass
- Number subclass to generateallowEmpty
- if empty strings should be allowed
IllegalArgumentException
- if an invalid numberClass has been specifiedNumberUtils.parseNumber(String, Class)
,
Integer.valueOf(java.lang.String, int)
,
Integer.toString(int, int)
public CustomNumberEditor(Class numberClass, NumberFormat numberFormat, boolean allowEmpty) throws IllegalArgumentException
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.
numberClass
- Number subclass to generatenumberFormat
- NumberFormat to use for parsing and renderingallowEmpty
- if empty strings should be allowed
IllegalArgumentException
- if an invalid numberClass has been specifiedNumberUtils.parseNumber(String, Class, java.text.NumberFormat)
,
NumberFormat.parse(java.lang.String, java.text.ParsePosition)
,
NumberFormat.format(java.lang.Object, java.lang.StringBuffer, java.text.FieldPosition)
Method Detail |
---|
public void setAsText(String text) throws IllegalArgumentException
setAsText
in interface PropertyEditor
setAsText
in class PropertyEditorSupport
IllegalArgumentException
public void setValue(Object value)
setValue
in interface PropertyEditor
setValue
in class PropertyEditorSupport
public String getAsText()
getAsText
in interface PropertyEditor
getAsText
in class PropertyEditorSupport
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |