org.omnifaces.renderer

Class MessagesRenderer

java.lang.Object

javax.faces.render.Renderer

org.omnifaces.renderer.MessagesRenderer

public class MessagesRenderer
extends Renderer

This renderer is the default renderer of OmniMessages. It's basically copypasted from Mojarra 2.2, including the fix of tooltip rendering as described in issue 2160, and afterwards slightly rewritten, refactored and enhanced to take the new features into account.

Since:

1.5

Author:

Bauke Scholtz

Field Summary

Fields

Modifier and Type	Field and Description
static String	RENDERER_TYPE The standard renderer type.

Fields inherited from class javax.faces.render.Renderer

PASSTHROUGH_RENDERER_LOCALNAME_KEY

Constructor Summary

Constructors

Constructor and Description
MessagesRenderer()

Method Summary

Modifier and Type	Method and Description
void	encodeChildren(FacesContext context, UIComponent component)
protected void	encodeEmptyMessages(FacesContext context, OmniMessages component) Encode the case when there are no messages.
protected void	encodeMessage(FacesContext context, OmniMessages component, FacesMessage message, boolean table, boolean showSummary, boolean showDetail, boolean escape, boolean tooltip) Encode a single faces message.
protected void	encodeMessages(FacesContext context, OmniMessages component, List<FacesMessage> messages, boolean table) Encode the case when the faces messages are to be rendered as either a HTML table or a HTML list.
protected void	encodeMessagesRepeater(FacesContext context, OmniMessages component, List<FacesMessage> messages) Encode the case when the var attribute is specified.
protected List<FacesMessage>	getMessages(FacesContext context, OmniMessages component) Collect all messages associated with components identified by for attribute and return it.
boolean	getRendersChildren() Returns true.

Methods inherited from class javax.faces.render.Renderer

convertClientId, decode, encodeBegin, encodeEnd, getConvertedValue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RENDERER_TYPE

public static final String RENDERER_TYPE

The standard renderer type.

See Also:

Constant Field Values

Constructor Detail

MessagesRenderer

public MessagesRenderer()

Method Detail

getRendersChildren

public boolean getRendersChildren()

Returns true.

Overrides:

getRendersChildren in class Renderer

encodeChildren

public void encodeChildren(FacesContext context,
                           UIComponent component)
                    throws IOException

Overrides:

encodeChildren in class Renderer

Throws:

IOException

getMessages

protected List<FacesMessage> getMessages(FacesContext context,
                                         OmniMessages component)

Collect all messages associated with components identified by for attribute and return it. An empty list will be returned when there are no messages.

Parameters:

context - The involved faces context.

component - The messages component.

Returns:

All messages associated with components identified by for attribute.

encodeMessagesRepeater

protected void encodeMessagesRepeater(FacesContext context,
                                      OmniMessages component,
                                      List<FacesMessage> messages)
                               throws IOException

Encode the case when the var attribute is specified. This will render without any HTML markup and put the current message in the request scope as identified by the var attribute. Note: the iteration is by design completely stateless.

Parameters:

context - The involved faces context.

component - The messages component.

messages - The queued faces messages.

Throws:

IOException - When an I/O error occurs.

encodeEmptyMessages

protected void encodeEmptyMessages(FacesContext context,
                                   OmniMessages component)
                            throws IOException

Encode the case when there are no messages. This will render a div when the ID is specified.

Parameters:

context - The involved faces context.

component - The messages component.

Throws:

IOException - When an I/O error occurs.

encodeMessages

protected void encodeMessages(FacesContext context,
                              OmniMessages component,
                              List<FacesMessage> messages,
                              boolean table)
                       throws IOException

Encode the case when the faces messages are to be rendered as either a HTML table or a HTML list.

Parameters:

context - The involved faces context.

component - The messages component.

messages - The queued faces messages.

table - Whether to render the messages as a HTML table or a HTML list.

Throws:

IOException - When an I/O error occurs.

encodeMessage

protected void encodeMessage(FacesContext context,
                             OmniMessages component,
                             FacesMessage message,
                             boolean table,
                             boolean showSummary,
                             boolean showDetail,
                             boolean escape,
                             boolean tooltip)
                      throws IOException

Encode a single faces message.

Parameters:

context - The involved faces context.

component - The messages component.

message - The queued faces message.

table - Whether to render the messages as a HTML table or a HTML list.

showSummary - Whether to show summary.

showDetail - Whether to show detail.

escape - Whether to HTML-escape message.

tooltip - Whether to show tooltip.

Throws:

IOException - When an I/O error occurs.