Javax.faces.component.UIInput.CONVERSION vs javax.faces.converter. *

jsf-api.jar contains various localized Messages.properties files, which contain, on the one hand, the javax.faces.component.UIInput.CONVERSION key, and on the other hand, various javax.faces.converter.* keys.

My questions:

  • When is the first key used, when is the second key used?
  • Where is this documented?
+4
source share
1 answer

The javax.faces.component.UIInput.CONVERSION message will be used if ConverterException does not contain a person message and the component does not specify the converterMessage attribute. In other words, this is the default message / backup. The message identifier is determined by the constant UIInput#CONVERSION_MESSAGE_ID , which is documented as follows:

CONVERSION_MESSAGE_ID

public static final java.lang.String CONVERSION_MESSAGE_ID

A FacesMessage message FacesMessage must be created if a conversion error occurs, and neither the page author nor ConverterException provides a message.

See also:

Constant Field Values


The javax.faces.converter.* Messages will be used if the standard JSF converter specified in the message identifier fails a specific conversion task. Standard JSF converters are listed in the javax.faces.convert class javax.faces.convert compile package . For instance. java.faces.converter.DateTimeConverter.* message identifiers will be used by DateTimeConverter , which has some message identifier constants listed in the field summary, such as DateTimeConverter#DATE_ID with the constant value "javax.faces.converter.DateTimeConverter.DATE" , which is documented as follows way:

DATE_ID

public static final java.lang.String DATE_ID

The FacesMessage message FacesMessage must be created if the conversion to Date completed. The message format string for this message may optionally include the following placeholders:

  • {0} is replaced with an unverified value.
  • {1} replace with an approximate value.
  • {2} replaced by String , whose value is the label of the input component that created this message.

See also:

Constant Field Values

Note that all message identifiers are listed in chapter 2.5.2.4 of the JSF specification . See Also JSF Converter Communications Messages for a Copy.

+5
source

All Articles