org.apache.myfaces.trinidad.convert

Class NumberConverter

java.lang.Object

javax.faces.convert.NumberConverter

org.apache.myfaces.trinidad.convert.NumberConverter

All Implemented Interfaces:

javax.faces.component.PartialStateHolder, javax.faces.component.StateHolder, javax.faces.convert.Converter

@JSFConverter(configExcluded=true)
public class NumberConverter
extends javax.faces.convert.NumberConverter

This is an extension of the standard JSF NumberConverter The converter provides all the standard functionality of the default NumberConverter and is strict while converting to object. JSF NumberConverter is lenient and will convert values like 22.22.2 or 22ABC to valid number 22.22 and 22 respectively, here it would result in a conversion failure and would throw ConverterException. If number grouping separator, decimal separator is configured in trinidad-config.xml file, it will be used during call to getAsObject() and getAsString() for parsing and formatting. If it has not been set, number grouping separator, decimal separator is defaulted based on the locale.

If currencyCode is set on the converter then it will be used. Else uses the currencyCode set on trinidad-config.xml file. If it is not set, then it is defaulted based on the locale. The value registered in trinidad-config.xml is obtained using api from RequestContext.

Since Apache Trinidad is compatible only with JDK 1.4 and higher versions, the currencyCode gets preference over currencySymbol See RI's NumberConverter for the way in which currencyCode and currencySymbol gets preference for different version of JDK.

The detail part of the FacesMessage can be customized. For each message id there is a corresponding setter method, which provides for message customization. The customized messages can contain placeholders as specified in the documentation for its corresponding message id.

Example: to customize the message for invalid input values, which will result in conversion error containing CONVERT_NUMBER_MESSAGE_ID, the following, can be done.

String convertNumberMessageDetail = "{0}" in "{1}" is not valid age. // Note that, the string can contain placeholders and it will be replaced // appropriately as specified in the documentation for the corresponding // message id. setMessageDetailConvertNumber(convertNumberMessageDetail); This way user can override detail part of the FacesMessage for different conversion errors that occur for wrong values, that arise during conversion. There is a one to one mapping for message customization which is as given below.

The methods used for customizing the detail message associated with each id is given below:

1. CONVERT_PATTERN_MESSAGE_ID - setMessageDetailConvertPattern(String)
2. CONVERT_NUMBER_MESSAGE_ID - setMessageDetailConvertNumber(String)
3. CONVERT_CURRENCY_MESSAGE_ID - setMessageDetailConvertCurrency(String)
4. CONVERT_PERCENT_MESSAGE_ID - setMessageDetailConvertPercent(String)

The custom messages can contain placeholders, which will be replaced with values as specified in its corresponding message id.

This NumberConverter is automatically registered under the standard converter ID, and therefore will be used when the <f:convertNumber> tag is used.

See Also:

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONVERT_CURRENCY_MESSAGE_ID The message identifier of the FacesMessage to be created if the input value is not a valid number when type is set to 'currency'.
static String	CONVERT_NUMBER_MESSAGE_ID The message identifier of the FacesMessage to be created if the input value is not a valid number.
static String	CONVERT_PATTERN_MESSAGE_ID The message identifier of the FacesMessage to be created if the input value does not match the specified pattern.
static String	CONVERT_PERCENT_MESSAGE_ID The message identifier of the FacesMessage to be created if the input value is not a valid number when type is set to 'percent'.
static String	CONVERTER_ID The standard converter id for this converter.

Fields inherited from class javax.faces.convert.NumberConverter

CURRENCY_ID, NUMBER_ID, PATTERN_ID, PERCENT_ID, STRING_ID

Fields inherited from interface javax.faces.convert.Converter

DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE_PARAM_NAME

Constructor Summary

Constructors

Constructor and Description
NumberConverter()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object numberConverter) Compares this NumberConverter with the specified Object for equality.
Object	getAsObject(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, String value) Performs strict conversion of string to number.
String	getAsString(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, Object value)
protected javax.faces.application.FacesMessage	getConvertMessage(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, String inputValue, Object[] params)
String	getCurrencyCode()
String	getCurrencySymbol()
String	getHintPattern() Return custom hintPattern message.
Locale	getLocale() Return the Locale that was set, returns null if it was not set, while faces RI returns the Locale set on the view root if the locale is null.
String	getLocalizedPattern(javax.faces.context.FacesContext context, String pattern, DecimalFormatSymbols dfs) If pattern contains the generic currency sign, this method will replace it with the localized currency symbol (if one exists).
int	getMaxFractionDigits()
int	getMaxIntegerDigits()
String	getMessageDetailConvertCurrency() Return custom detail error message that was set for creating FacesMessage, when conversion fails for values, when type is set to 'currency' and pattern is null or not set.
String	getMessageDetailConvertNumber() Return custom detail error message that was set for creating FacesMessage, when conversion fails for values, when type is set to 'number' and pattern is null or not set.
String	getMessageDetailConvertPattern() Custom detail error message that was set for creation of FacesMessage when conversion fails for values that does not match the pattern set.
String	getMessageDetailConvertPercent() Return custom detail error message that was set for creating FacesMessage, when conversion fails for values, when value cannot be converted to a number, when type is set to 'percent' and pattern is null or not set.
int	getMinFractionDigits()
int	getMinIntegerDigits()
String	getNegativePrefix() Gets the negative prefix that is applied on the number.
String	getNegativeSuffix() Gets the negative suffix that is applied on the number.
String	getPattern()
RoundingMode	getRoundingMode()
String	getType()
javax.faces.el.ValueBinding	getValueBinding(String name) Deprecated.
javax.el.ValueExpression	getValueExpression(String name) Return the ValueExpression used to calculate the value for the specified attribute name, if any.
int	hashCode() Returns the hash code for this Converter.
boolean	isDisabled() Return whether it is disabled.
boolean	isGroupingUsed()
boolean	isIntegerOnly()
boolean	isMaximumFractionDigitsSet() Return true if the maximum fraction digits have been set.
boolean	isMaximumIntegerDigitsSet() Return true if the maximum integer digits have been set.
boolean	isMinimumFractionDigitsSet() Return true if the minimum fraction digits have been set.
boolean	isMinimumIntegerDigitsSet() Return true if the minimum integer digits have been set.
boolean	isNegativePrefixSet() Return true if a non-null negative prefix has been set via setNegativePrefix(String).
boolean	isNegativeSuffixSet() Return true if a non-null negative suffix has been set via setNegativeSuffix(String).
boolean	isRoundingModeSet() Return true if a non-null rounding mode has been set via setRoundingMode(RoundingMode).
void	restoreState(javax.faces.context.FacesContext context, Object state)
Object	saveState(javax.faces.context.FacesContext context)
void	setCurrencyCode(String currencyCode)
void	setCurrencySymbol(String currencySymbol)
void	setDisabled(boolean isDisabled) Set the value to property disabled.
void	setGroupingUsed(boolean groupingUsed)
void	setHintPattern(String hintPattern) Custom hintPattern message.
void	setIntegerOnly(boolean integerOnly)
void	setLocale(Locale locale) Set the Locale to be used when parsing numbers.
void	setMaxFractionDigits(int maxFractionDigits)
void	setMaxIntegerDigits(int maxIntegerDigits)
void	setMessageDetailConvertCurrency(String convertCurrencyMessageDetail) Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'currency' and pattern is null or not set.
void	setMessageDetailConvertNumber(String convertNumberMessageDetail) Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'number' and pattern is null or not set.
void	setMessageDetailConvertPattern(String convertPatternMessageDetail) Custom error message to be used, for creating detail part of the FacesMessage, message, when value cannot be converted to a number, based on the pattern set.
void	setMessageDetailConvertPercent(String convertPercentMessageDetail) Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'percent' and pattern is null or not set.
void	setMinFractionDigits(int minFractionDigits)
void	setMinIntegerDigits(int minIntegerDigits)
void	setNegativePrefix(String negPrefix) Sets the negative prefix on the converter.
void	setNegativeSuffix(String negSuffix) Sets the negative suffix on the converter.
void	setPattern(String pattern)
void	setRoundingMode(RoundingMode mode)
void	setType(String type)
void	setValueBinding(String name, javax.faces.el.ValueBinding binding) Deprecated.
void	setValueExpression(String name, javax.el.ValueExpression expression) Set the ValueExpression used to calculate the value for the specified attribute if any.

Methods inherited from class javax.faces.convert.NumberConverter

clearInitialState, initialStateMarked, isTransient, markInitialState, setTransient

Methods inherited from class java.lang.Object

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

Field Detail

CONVERTER_ID

public static final String CONVERTER_ID

The standard converter id for this converter.

See Also:

Constant Field Values

CONVERT_PATTERN_MESSAGE_ID

public static final String CONVERT_PATTERN_MESSAGE_ID

The message identifier of the FacesMessage to be created if the input value does not match the specified pattern. The message format string for this message may optionally include {0}, {1} and {4} placeholders, which will be replaced with the input value, label associated with the component and the pattern respectively.

See Also:

Constant Field Values

CONVERT_NUMBER_MESSAGE_ID

public static final String CONVERT_NUMBER_MESSAGE_ID

The message identifier of the FacesMessage to be created if the input value is not a valid number. The message format string for this message may optionally include {0} and {1} placeholders, which will be replaced with the input value and label associated with the component respectively.

See Also:

Constant Field Values

CONVERT_CURRENCY_MESSAGE_ID

public static final String CONVERT_CURRENCY_MESSAGE_ID

The message identifier of the FacesMessage to be created if the input value is not a valid number when type is set to 'currency'. The message format string for this message may optionally include {0} and {1} placeholders, which will be replaced with the input value and label associated with the component respectively.

See Also:

Constant Field Values

CONVERT_PERCENT_MESSAGE_ID

public static final String CONVERT_PERCENT_MESSAGE_ID

The message identifier of the FacesMessage to be created if the input value is not a valid number when type is set to 'percent'. The message format string for this message may optionally include {0} and {1} placeholders, which will be replaced with the input value and label associated with the component respectively.

See Also:

Constant Field Values

Constructor Detail

NumberConverter

public NumberConverter()

Method Detail

getAsObject

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

Performs strict conversion of string to number. Values having more than one decimal seprator like 22.22.22 and values of the form 22ABC, 22%ABC will result in ConverterException.

Specified by:

getAsObject in interface javax.faces.convert.Converter

Overrides:

getAsObject in class javax.faces.convert.NumberConverter

getAsString

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

Specified by:

getAsString in interface javax.faces.convert.Converter

Overrides:

getAsString in class javax.faces.convert.NumberConverter

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, if the passed value is a String, it's returned unchanged, otherwise String representation for the number object based on the attributes set.

Throws:

javax.faces.convert.ConverterException - if conversion cannot be successfully performed

NullPointerException - if context or component is null

IllegalArgumentException - if the value is not of type other than Number, String. value can be null.

restoreState

public void restoreState(javax.faces.context.FacesContext context,
                Object state)

Specified by:

restoreState in interface javax.faces.component.StateHolder

Overrides:

restoreState in class javax.faces.convert.NumberConverter

saveState

public Object saveState(javax.faces.context.FacesContext context)

Specified by:

saveState in interface javax.faces.component.StateHolder

Overrides:

saveState in class javax.faces.convert.NumberConverter

setValueExpression

public void setValueExpression(String name,
                      javax.el.ValueExpression expression)

Set the ValueExpression used to calculate the value for the specified attribute if any.

Parameters:

name - Name of the attribute for which to set a ValueExpression

expression - The ValueExpression to set, or null to remove any currently set ValueExpression

Throws:

NullPointerException - if name is null

IllegalArgumentException - if name is not a valid attribute of this converter

getValueExpression

public javax.el.ValueExpression getValueExpression(String name)

Return the ValueExpression used to calculate the value for the specified attribute name, if any.

Parameters:

name - Name of the attribute or property for which to retrieve a ValueExpression

Throws:

NullPointerException - if name is null

IllegalArgumentException - if name is not a valid attribute of this converter

setValueBinding

public void setValueBinding(String name,
                   javax.faces.el.ValueBinding binding)

Deprecated.

Set the ValueBinding used to calculate the value for the specified attribute if any.

Parameters:

name - Name of the attribute for which to set a ValueBinding

binding - The ValueBinding to set, or null to remove any currently set ValueBinding

Throws:

NullPointerException - if name is null

IllegalArgumentException - if name is not a valid attribute of this converter

getValueBinding

public javax.faces.el.ValueBinding getValueBinding(String name)

Deprecated.

Return the ValueBinding used to calculate the value for the specified attribute name, if any.

Parameters:

name - Name of the attribute or property for which to retrieve a ValueBinding

Throws:

NullPointerException - if name is null

IllegalArgumentException - if name is not a valid attribute of this converter

setMessageDetailConvertPattern

public void setMessageDetailConvertPattern(String convertPatternMessageDetail)

Custom error message to be used, for creating detail part of the FacesMessage, message, when value cannot be converted to a number, based on the pattern set. Overrides detail message identified by message id CONVERT_PATTERN_MESSAGE_ID

Parameters:

convertPatternMessageDetail - Custom error message.

getMessageDetailConvertPattern

@JSFProperty
public String getMessageDetailConvertPattern()

Custom detail error message that was set for creation of FacesMessage when conversion fails for values that does not match the pattern set.

Returns:

Custom error message.

See Also:

setMessageDetailConvertPattern(String)

setMessageDetailConvertNumber

public void setMessageDetailConvertNumber(String convertNumberMessageDetail)

Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'number' and pattern is null or not set.

Overrides detail message identified by message id CONVERT_NUMBER_MESSAGE_ID

Parameters:

convertNumberMessageDetail - custom error message.

getMessageDetailConvertNumber

@JSFProperty
public String getMessageDetailConvertNumber()

Return custom detail error message that was set for creating FacesMessage, when conversion fails for values, when type is set to 'number' and pattern is null or not set.

Returns:

Custom error message.

See Also:

setMessageDetailConvertNumber(String)

setMessageDetailConvertCurrency

public void setMessageDetailConvertCurrency(String convertCurrencyMessageDetail)

Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'currency' and pattern is null or not set.

Overrides detail message identified by message id CONVERT_CURRENCY_MESSAGE_ID.

Parameters:

convertCurrencyMessageDetail - custom error message.

getMessageDetailConvertCurrency

@JSFProperty
public String getMessageDetailConvertCurrency()

Return custom detail error message that was set for creating FacesMessage, when conversion fails for values, when type is set to 'currency' and pattern is null or not set.

Returns:

Custom error message.

See Also:

setMessageDetailConvertCurrency(String)

setMessageDetailConvertPercent

public void setMessageDetailConvertPercent(String convertPercentMessageDetail)

Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'percent' and pattern is null or not set.

Overrides detail message identified by message id CONVERT_PERCENT_MESSAGE_ID

Parameters:

convertPercentMessageDetail - custom error message.

getMessageDetailConvertPercent

@JSFProperty
public String getMessageDetailConvertPercent()

Return custom detail error message that was set for creating FacesMessage, when conversion fails for values, when value cannot be converted to a number, when type is set to 'percent' and pattern is null or not set.

Returns:

Custom error message.

See Also:

setMessageDetailConvertPercent(String)

setHintPattern

public void setHintPattern(String hintPattern)

Custom hintPattern message.

Overrides default hint message

Parameters:

hintPattern - Custom hint message.

getHintPattern

public String getHintPattern()

Return custom hintPattern message.

Returns:

Custom hint message.

See Also:

setHintPattern(String)

setCurrencyCode

public void setCurrencyCode(String currencyCode)

Overrides:

setCurrencyCode in class javax.faces.convert.NumberConverter

getCurrencyCode

@JSFProperty
public String getCurrencyCode()

Overrides:

getCurrencyCode in class javax.faces.convert.NumberConverter

setCurrencySymbol

public void setCurrencySymbol(String currencySymbol)

Overrides:

setCurrencySymbol in class javax.faces.convert.NumberConverter

getCurrencySymbol

@JSFProperty
public String getCurrencySymbol()

Overrides:

getCurrencySymbol in class javax.faces.convert.NumberConverter

setGroupingUsed

public void setGroupingUsed(boolean groupingUsed)

Overrides:

setGroupingUsed in class javax.faces.convert.NumberConverter

isGroupingUsed

@JSFProperty(defaultValue="true")
public boolean isGroupingUsed()

Overrides:

isGroupingUsed in class javax.faces.convert.NumberConverter

setIntegerOnly

public void setIntegerOnly(boolean integerOnly)

Overrides:

setIntegerOnly in class javax.faces.convert.NumberConverter

isIntegerOnly

@JSFProperty(defaultValue="false")
public boolean isIntegerOnly()

Overrides:

isIntegerOnly in class javax.faces.convert.NumberConverter

setLocale

public void setLocale(Locale locale)

Set the Locale to be used when parsing numbers. If set to null, the Locale stored in the UIViewRoot for the current request will be utilized.

Overrides:

setLocale in class javax.faces.convert.NumberConverter

Parameters:

locale - The new Locale (or null)

getLocale

@JSFProperty
public Locale getLocale()

Return the Locale that was set, returns null if it was not set, while faces RI returns the Locale set on the view root if the locale is null. If this value is null, the Locale stored in the UIViewRoot for the current request will be utilized during parsing.

Overrides:

getLocale in class javax.faces.convert.NumberConverter

setMaxFractionDigits

public void setMaxFractionDigits(int maxFractionDigits)

Overrides:

setMaxFractionDigits in class javax.faces.convert.NumberConverter

getMaxFractionDigits

@JSFProperty
public int getMaxFractionDigits()

Overrides:

getMaxFractionDigits in class javax.faces.convert.NumberConverter

setMaxIntegerDigits

public void setMaxIntegerDigits(int maxIntegerDigits)

Overrides:

setMaxIntegerDigits in class javax.faces.convert.NumberConverter

getMaxIntegerDigits

@JSFProperty
public int getMaxIntegerDigits()

Overrides:

getMaxIntegerDigits in class javax.faces.convert.NumberConverter

setMinFractionDigits

public void setMinFractionDigits(int minFractionDigits)

Overrides:

setMinFractionDigits in class javax.faces.convert.NumberConverter

getMinFractionDigits

@JSFProperty
public int getMinFractionDigits()

Overrides:

getMinFractionDigits in class javax.faces.convert.NumberConverter

setMinIntegerDigits

public void setMinIntegerDigits(int minIntegerDigits)

Overrides:

setMinIntegerDigits in class javax.faces.convert.NumberConverter

getMinIntegerDigits

@JSFProperty
public int getMinIntegerDigits()

Overrides:

getMinIntegerDigits in class javax.faces.convert.NumberConverter

setRoundingMode

public void setRoundingMode(RoundingMode mode)

getRoundingMode

@JSFProperty
public RoundingMode getRoundingMode()

setNegativePrefix

public void setNegativePrefix(String negPrefix)

Sets the negative prefix on the converter. The negative prefix set using this method will override the negative prefix pattern, if any, specified through setPattern(String) or any other means.

Parameters:

negPrefix - Prefix to be applied on negative number

getNegativePrefix

@JSFProperty
public String getNegativePrefix()

Gets the negative prefix that is applied on the number. Will return the prefix or null if no negative prefix is specified via setNegativePrefix(String). Negative prefix specified using negative pattern string has no affect on this method.

Returns:

The prefix as set using setNegativePrefix(String) or null

setNegativeSuffix

public void setNegativeSuffix(String negSuffix)

Sets the negative suffix on the converter. The negative suffix set using this method will override the negative suffix pattern, if any, specified through setPattern(String) or any other means.

Parameters:

negSuffix - Suffix to be applied on negative number

getNegativeSuffix

@JSFProperty
public String getNegativeSuffix()

Gets the negative suffix that is applied on the number. Will return the suffix or null if no negative suffix is specified via setNegativeSuffix(String). Negative suffix specified using negative pattern string has no affect on this method.

Returns:

The suffix as set using setNegativeSuffix(String) or null

setPattern

public void setPattern(String pattern)

Overrides:

setPattern in class javax.faces.convert.NumberConverter

getPattern

@JSFProperty
public String getPattern()

Overrides:

getPattern in class javax.faces.convert.NumberConverter

getLocalizedPattern

public String getLocalizedPattern(javax.faces.context.FacesContext context,
                         String pattern,
                         DecimalFormatSymbols dfs)

If pattern contains the generic currency sign, this method will replace it with the localized currency symbol (if one exists).

Parameters:

context - the FacesContext

pattern - the pattern to be localized

dfs - the DecimalFormatSymbols; if null, will be constructed from the context

Returns:

setType

public void setType(String type)

Overrides:

setType in class javax.faces.convert.NumberConverter

getType

@JSFProperty(defaultValue="number")
public String getType()

Overrides:

getType in class javax.faces.convert.NumberConverter

hashCode

public int hashCode()

Returns the hash code for this Converter.

Overrides:

hashCode in class Object

equals

public boolean equals(Object numberConverter)

Compares this NumberConverter with the specified Object for equality.

Overrides:

equals in class Object

setDisabled

public void setDisabled(boolean isDisabled)

Set the value to property disabled. Default value is false.

Parameters:

isDisabled - true if it's disabled, false otherwise.

isDisabled

public boolean isDisabled()

Return whether it is disabled.

Returns:

true if it's disabled and false if it's enabled.

getConvertMessage

protected final javax.faces.application.FacesMessage getConvertMessage(javax.faces.context.FacesContext context,
                                                     javax.faces.component.UIComponent component,
                                                     String inputValue,
                                                     Object[] params)

isMaximumFractionDigitsSet

public boolean isMaximumFractionDigitsSet()

Return true if the maximum fraction digits have been set. If not set, return false;

Returns:

true, if the maximum fraction digits have been set.

isMinimumFractionDigitsSet

public boolean isMinimumFractionDigitsSet()

Return true if the minimum fraction digits have been set. If not set, return false;

Returns:

true, if the minimum fraction digits have been set.

isMaximumIntegerDigitsSet

public boolean isMaximumIntegerDigitsSet()

Return true if the maximum integer digits have been set. If not set, return false;

Returns:

true, if the maximum integer digits have been set.

isMinimumIntegerDigitsSet

public boolean isMinimumIntegerDigitsSet()

Return true if the minimum integer digits have been set. If not set, return false;

Returns:

true, if the minimum integer digits have been set.

isNegativePrefixSet

public boolean isNegativePrefixSet()

Return true if a non-null negative prefix has been set via setNegativePrefix(String). If not set, return false;

Returns:

true, if the negative prefix has been set.

isNegativeSuffixSet

public boolean isNegativeSuffixSet()

Return true if a non-null negative suffix has been set via setNegativeSuffix(String). If not set, return false;

Returns:

true, if the negative suffix has been set.

isRoundingModeSet

public boolean isRoundingModeSet()

Return true if a non-null rounding mode has been set via setRoundingMode(RoundingMode). If not set, return false;

Returns:

true, if the rounding mode has been set.