Module jakarta.faces

Package jakarta.faces.convert

Class CharacterConverter

java.lang.Object

jakarta.faces.convert.CharacterConverter

All Implemented Interfaces:

Converter

public class CharacterConverter
extends Object
implements Converter

Converter implementation for java.lang.Character (and char primitive) values.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CHARACTER_ID	The message identifier of the FacesMessage to be created if the conversion to Character fails.
static final String	CONVERTER_ID	The standard converter id for this converter.
static final String	STRING_ID	The message identifier of the FacesMessage to be created if the conversion of the Character value to String fails.

Fields inherited from interface jakarta.faces.convert.Converter

DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE_PARAM_NAME

Constructor Summary

Constructors

Constructor	Description
CharacterConverter()

Method Summary

Modifier and Type	Method	Description
Object	getAsObject(FacesContext context, UIComponent component, String value)	Convert the specified string value, which is associated with the specified UIComponent, into a model data object that is appropriate for being stored during the Process Validations phase of the request processing lifecycle.
String	getAsString(FacesContext context, UIComponent component, Object value)	Convert the specified model object value, which is associated with the specified UIComponent, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

CONVERTER_ID

public static final String CONVERTER_ID

The standard converter id for this converter.

See Also:

• Constant Field Values

CHARACTER_ID

public static final String CHARACTER_ID

The message identifier of the FacesMessage to be created if the conversion to Character fails. The message format string for this message may optionally include the following placeholders:

• {0} replaced by the unconverted value.
• {1} replaced by a String whose value is the label of the input component that produced this message.

See Also:

• Constant Field Values

STRING_ID

public static final String STRING_ID

The message identifier of the FacesMessage to be created if the conversion of the Character value to String fails. The message format string for this message may optionally include the following placeholders:

• {0} relaced by the unconverted value.
• {1} replaced by a String whose value is the label of the input component that produced this message.

See Also:

• Constant Field Values

Constructor Details

CharacterConverter

public CharacterConverter()

Method Details

getAsObject

public Object getAsObject(FacesContext context,
 UIComponent component,
 String value)

Description copied from interface: Converter

Convert the specified string value, which is associated with the specified UIComponent, into a model data object that is appropriate for being stored during the Process Validations phase of the request processing lifecycle.

Specified by:

getAsObject in interface Converter

Parameters:

context - FacesContext for the request being processed

component - UIComponent with which this model object value is associated

value - String value to be converted (may be null)

Returns:

null if the value to convert is null, otherwise the result of the conversion

Throws:

ConverterException - if conversion cannot be successfully performed

NullPointerException - if context or component is null

getAsString

public String getAsString(FacesContext context,
 UIComponent component,
 Object value)

Description copied from interface: Converter

Convert the specified model object value, which is associated with the specified UIComponent, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.

Specified by:

getAsString in interface Converter

Parameters:

context - FacesContext for the request being processed

component - UIComponent with which this model object value is associated

value - Model object value to be converted (may be null)

Returns:

a zero-length String if value is null, otherwise the result of the conversion

Throws:

ConverterException - if conversion cannot be successfully performed

NullPointerException - if context or component is null