jsf - javax.faces.component.UIInput.CONVERSION vs javax.faces.converter.* -


the jsf-api.jar contains various localized messages.properties files contain, on 1 hand javax.faces.component.uiinput.conversion key on other hand various javax.faces.converter.* keys.

my questions are:

  • when first key used, when second key used?
  • where documented?

the javax.faces.component.uiinput.conversion message used when converterexception didn't contain faces message , component didn't specify convertermessage attribute. in other words, it's default/fallback message. message identifier specified uiinput#conversion_message_id constant documented follows:

conversion_message_id

public static final java.lang.string conversion_message_id

the message identifier of facesmessage created if conversion error occurs, , neither page author nor converterexception provides message.

see also:

constant field values


the javax.faces.converter.* messages used when in message identifier specified standard jsf converter has failed specific conversion task. standard jsf converters listed in class summary of javax.faces.convert package summary. e.g. java.faces.converter.datetimeconverter.* message identifiers used datetimeconverter has message identifier constants listed in field summary datetimeconverter#date_id constant value of "javax.faces.converter.datetimeconverter.date" documented follows:

date_id

public static final java.lang.string date_id

the message identifier of facesmessage created if conversion date fails. message format string message may optionally include following placeholders:

  • {0} replaced unconverted value.
  • {1} replaced example value.
  • {2} replaced string value label of input component produced message.

see also:

constant field values

note message identifiers listed in chapter 2.5.2.4 of jsf specification. see jsf converter resource bundle messages copy.


Comments