B.1 Introduction to ADF Faces Default Messages

The FacesMessage class supports both summary and detailed messages. The convention is that:

The summary message is defined for the main key. The key value is of the form classname.MSG_KEY.

The detailed message is of the form classname.MSG_KEY_detail.

In summary, to override a detailed message you can either use the setter method on the appropriate class or enter a replacement message in a resource bundle using the required message key.

Placeholders are used in detail messages to provide relevant details such as the value the user entered and the label of the component for which this is a message. The general order of placeholder identifiers is:

component label

input value (if present)

minimum value (if present)

maximum value (if present)

pattern (if present)

B.2 Message Keys and Setter Methods

The following information is given for each of the ADF Faces converter and validators:

The set method you can use to override the message.

The message key you can use to identify your own version of the message in a resource bundle.

How placeholders can be used in the message to include details such as the input values and patterns.

B.3 Converter and Validator Message Keys and Setter Methods

This section gives the reference details for all ADF Faces converter and validator detail messages.

B.3.1 af:convertColor

Converts strings representing color values to and from java.awt.Color objects. The set of patterns used for conversion can be overriden.

Convert color: Input value cannot be converted to a color based on the patterns set

{0} The label that identifies the component
{1} Value entered by the user
{2} Example of the format the converter is expecting

B.3.3 af:convertNumber

Provides an extension of the standard JSF javax.faces.convert.NumberConverter class. The converter provides all the standard functionality of the default NumberConverter and is strict while converting to an object.

Convert number: Input value cannot be converted to a Number, based on the pattern set