30.2. JSF-related components

The following set of components are provided to supplement JSF.
org.jboss.seam.faces.dateConverter
Provides a default JSF converter for properties of type java.util.Date.
This converter is automatically registered with JSF, so developers need not specify a DateTimeConverter on an input field or page parameter. By default, it assumes the type to be a date (as opposed to a time or date plus time), and uses the short input style adjusted to the user's Locale. For Locale.US, the input pattern is mm/dd/yy. However, to comply with Y2K, the year is changed from two digits to four — mm/dd/yyyy.
You can override the input pattern globally by reconfiguring your component. Consult the JavaServer Faces documentation for this class to see examples.
org.jboss.seam.faces.facesMessages
Allows Faces success messages to propagate across a browser redirect.
  • add(FacesMessage facesMessage) — adds a Faces message, which will be displayed during the next render response phase that occurs in the current conversation.
  • add(String messageTemplate) — adds a Faces message, rendered from the given message template, which may contain EL expressions.
  • add(Severity severity, String messageTemplate) — adds a Faces message, rendered from the given message template, which may contain EL expressions.
  • addFromResourceBundle(String key) — adds a Faces message, rendered from a message template defined in the Seam resource bundle which may contain EL expressions.
  • addFromResourceBundle(Severity severity, String key) — adds a Faces message, rendered from a message template defined in the Seam resource bundle, which may contain EL expressions.
  • clear() — clears all messages.
org.jboss.seam.faces.redirect
A convenient API for performing redirects with parameters. This is particularly useful for bookmarkable search results screens.
  • redirect.viewId — the JSF view ID to redirect to.
  • redirect.conversationPropagationEnabled — determines whether the conversation will propagate across the redirect.
  • redirect.parameters — a map of request parameter name to value, to be passed in the redirect request.
  • execute() — performs the redirect immediately.
  • captureCurrentRequest() — stores the view ID and request parameters of the current GET request (in the conversation context) for later use by calling execute().
org.jboss.seam.faces.httpError
A convenient API for sending HTTP errors.
org.jboss.seam.ui.renderStampStore
A component which maintains a collection of render stamps. A render stamp indicates whether a rendered form has been submitted. This is particularly useful in conjunction with JSF's client-side state saving method, because the form's status (posted or unposted) is controlled by the server rather than the client.
Client-side state saving is often used to unbind this check from the session. To do so, you will need an implementation that can store render stamps within the application (valid while the application runs), or the database (valid across server restarts).
  • maxSize — The maximum number of stamps to keep in the store. The default is 100.
The JSF components are installed when the class javax.faces.context.FacesContext is available on the classpath.