[OmniFaces utilities 2.0] Add the given parameterized message body as faces message globally or to the given client ID (specify severity also)

---

[OmniFaces utilities] The add() method adds a faces message of the given severity to the given clientId, with the given message body which is formatted with the given parameters.

---

Method:

See also: Faces#getContext()

Usage:

Messages text:

// INFO message

private static final String FILES_UPLOADED = "The {0} file and associated extensions ({1}, {2} and {3}) were successfully uploaded !";

// WARN message

private static final String USER_WARN = "The {0} user has reached the maximum number, {1}, of submissions !";

// ERROR message

private static final String FILES_UPLOADED_ERROR = "The {0} file cannot be uploaded ! File size should be smaller than {1} bytes.";

// FATAL message

private static final String USER_FATAL = "The database at {0} does not respond on port {1} !";

import org.omnifaces.util.Messages;

...

// for a certain component, replace null with clientId

// add a INFO message as a global message

Messages.add(FacesMessage.SEVERITY_INFO, null, FILES_UPLOADED, "SHP", "SHX", "DBF", "SBN");

// or

Object[] params = new Object[]{"SHP", "SHX", "DBF", "SBN"};

Messages.add(FacesMessage.SEVERITY_INFO, null, FILES_UPLOADED, params);

// add a WARN message as a global message

Messages.add(FacesMessage.SEVERITY_WARN, null, USER_WARN, "Mark Rightwer", 5);

// add a ERROR message as a global message

Messages.add(FacesMessage.SEVERITY_ERROR, null, FILES_UPLOADED_ERROR, "order.txt", 1024);

// add a FATAL message as a global message

Messages.add(FacesMessage.SEVERITY_FATAL, null, USER_FATAL, "89.38.122.5", "5432");

Output:

// INFO message

The SHP file and associated extensions (SHX, DBF and SBN) were successfully uploaded !

// WARN message

The Mark Rightwer user has reached the maximum number, 5, of submissions !

// ERROR message

The order.txt file cannot be uploaded ! File size should be smaller than 1,024 bytes.

// FATAL message

The database at 89.38.122.5 does not respond on port 5432 !

Note Don't forget to use in page where the messages are displayed the <h:messages>, for global messages, <h:message>, for component messages, or any other approach capable to display the messages.

Note By default, this example uses the OmniFaces default message resolver, but you can use your own message resolver as in Working with OmniFaces Message Resolvers.

API GH