|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IConverter
Converts input to output and vice versa. Converters are needed in web applications because we have to switch between Java objects on the server and Strings in the browser output and input.
Output conversion, which is handled by convertToString(Object, Locale)
, is typically
used by components when they render, so that a date can be displayed as '12/12/2007'. Input
conversion, handled by convertToObject(String, Locale)
, is typically used by form
components to interpret incoming values Such values are strings as they are send as request
parameters from browsers. An incoming value could be the string '12/12/2007' which could be
translated to a corresponding Date
object.
Notice that incoming value, when used by a FormComponent, will never be null because before
validation form components perform the required (see FormComponent.isRequired()
check
which errors out on null values. In the case the FormComponent is not required and the user
enters a null value converters will not be invoked because no type conversion is necessary.
Method Summary | |
---|---|
java.lang.Object |
convertToObject(java.lang.String value,
java.util.Locale locale)
Converts the given String value |
java.lang.String |
convertToString(java.lang.Object value,
java.util.Locale locale)
Converts the given value to a string. |
Method Detail |
---|
java.lang.Object convertToObject(java.lang.String value, java.util.Locale locale)
String
value
value
- The string value to convertlocale
- The locale used to convert the value
java.lang.String convertToString(java.lang.Object value, java.util.Locale locale)
value
- The value to convertlocale
- The locale used to convert the value
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |