Class FacesMessage

java.lang.Object
jakarta.faces.application.FacesMessage
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
ParametrizableFacesMessage

public class FacesMessage extends Object implements Serializable

FacesMessage represents a single validation (or other) message, which is typically associated with a particular component in the view. A FacesMessage instance may be created based on a specific messageId. The specification defines the set of messageIds for which there must be FacesMessage instances.

The implementation must take the following steps when creating FacesMessage instances given a messageId:
  • Call Application.getMessageBundle(). If non-null, locate the named ResourceBundle, using the Locale from the current UIViewRoot and see if it has a value for the argument messageId. If it does, treat the value as the summary of the FacesMessage. If it does not, or if Application.getMessageBundle() returned null, look in the ResourceBundle named by the value of the constant FACES_MESSAGES and see if it has a value for the argument messageId. If it does, treat the value as the summary of the FacesMessage. If it does not, there is no initialization information for the FacesMessage instance.
  • In all cases, if a ResourceBundle hit is found for the {messageId}, look for further hits under the key {messageId}_detail. Use this value, if present, as the detail for the returned FacesMessage.
  • Make sure to perform any parameter substitution required for the summary and detail of the FacesMessage .
See Also:
  • Field Details

    • FACES_MESSAGES

      public static final String FACES_MESSAGES
      ResourceBundle identifier for messages whose message identifiers are defined in the JavaServer Faces specification.
      See Also:
    • SEVERITY_INFO

      public static final FacesMessage.Severity SEVERITY_INFO
      Message severity level indicating an informational message rather than an error.
    • SEVERITY_WARN

      public static final FacesMessage.Severity SEVERITY_WARN
      Message severity level indicating that an error might have occurred.
    • SEVERITY_ERROR

      public static final FacesMessage.Severity SEVERITY_ERROR
      Message severity level indicating that an error has occurred.
    • SEVERITY_FATAL

      public static final FacesMessage.Severity SEVERITY_FATAL
      Message severity level indicating that a serious error has occurred.
    • VALUES

      public static final List<FacesMessage.Severity> VALUES
      Immutable Lis of valid FacesMessage.Severityinstances, in ascending order of their ordinal value.
    • VALUES_MAP

      public static final Map<String,FacesMessage.Severity> VALUES_MAP
      Immutable Map of valid FacesMessage.Severityinstances, keyed by name.
  • Constructor Details

    • FacesMessage

      public FacesMessage()
      Construct a new FacesMessage with no initial values. The severity is set to Severity.INFO.
    • FacesMessage

      public FacesMessage(String summary)
      Construct a new FacesMessage with just a summary. The detail is null, the severity is set to Severity.INFO.
    • FacesMessage

      public FacesMessage(String summary, String detail)
      Construct a new FacesMessage with the specified initial values. The severity is set to Severity.INFO.
      Parameters:
      summary - - Localized summary message text
      detail - - Localized detail message text
    • FacesMessage

      public FacesMessage(FacesMessage.Severity severity, String summary, String detail)
      Construct a new FacesMessagewith the specified initial values.
      Parameters:
      severity - - the severity
      summary - - Localized summary message text
      detail - - Localized detail message text
  • Method Details

    • getSeverity

      public FacesMessage.Severity getSeverity()
      Returns:
    • setSeverity

      public void setSeverity(FacesMessage.Severity severity)
      Return the severity level.
    • getSummary

      public String getSummary()
      Return the localized summary text.
    • setSummary

      public void setSummary(String summary)
      Set the localized summary text.
      Parameters:
      summary - - The new localized summary text
    • getDetail

      public String getDetail()
      Returns:
    • setDetail

      public void setDetail(String detail)
      Set the localized detail text.
      Parameters:
      detail - - The new localized detail text
    • isRendered

      public boolean isRendered()
    • rendered

      public void rendered()
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
      Since:
      4.1
    • equals

      public boolean equals(Object object)
      Overrides:
      equals in class Object
      Since:
      4.1
    • toString

      public String toString()
      Overrides:
      toString in class Object
      Since:
      4.1