background image

Registering Custom Error Messages

<< Initializing Maps and Lists | Registering Custom Localized Static Text >>
<< Initializing Maps and Lists | Registering Custom Localized Static Text >>

Registering Custom Error Messages

</managed-property>
</managed-bean>
...
This configuration initializes a List called newsletters. This list is composed of SelectItem
instances, which are also managed beans. See
"Using the selectItem Tag" on page 349
for
more information on SelectItem. Note that, unlike the example in
"Initializing Map
Properties" on page 443
, the newsletters list is not a property on a managed bean. (It is not
wrapped with a managed-property element.) Instead, the list is the managed bean.
Registering Custom Error Messages
If you create custom error messages (which are displayed by the message and messages tags) for
your custom converters or validators, you must make them available at application startup
time. You do this in one of two ways: by queuing the message onto the FacesContext instance
programmatically (as described in
"Performing Localization" on page 390
) or by registering the
messages with your application using the application configuration resource file.
Here is the part of the file that registers the messages for the Duke's Bookstore application:
<application>
<message-bundle>
com.sun.bookstore6.resources.ApplicationMessages
</message-bundle>
<locale-config>
<default-locale>en</default-locale>
<supported-locale>es</supported-locale>
<supported-locale>de</supported-locale>
<supported-locale>fr</supported-locale>
</locale-config>
</application>
This set of elements will cause your Application instance to be populated with the messages
contained in the specified resource bundle.
The message-bundle element represents a set of localized messages. It must contain the fully
qualified path to the resource bundle containing the localized messages (in this case,
resources.ApplicationMessages
).
The locale-config element lists the default locale and the other supported locales. The
locale-config
element enables the system to find the correct locale based on the browser's
language settings. Duke's Bookstore manually sets the locale and so it overrides these settings.
Therefore, it's not necessary to use locale-config to specify the default or supported locales in
Duke's Bookstore.
Registering Custom Error Messages
The Java EE 5 Tutorial · September 2007
448