SeamFramework.orgCommunity Documentation

Chapter 3. Conversation Management and Usage

3.1. Conversation Usage in EL
3.2. Conversation Management
3.2.1. @Begin
3.2.2. @End

3.1. Conversation Usage in EL

CDI exposes the conversation to EL via the name javax.enterprise.context.conversation. Seam Faces adds an alias to make this a little more convient for page authors. The alias Seam Faces provides is simply conversation.

3.2. Conversation Management

CDI Conversations can be started and stopped easily in Seam Faces using annotations, respectifully @Begin and @End. Both of these have some extra properties that can be used to configure the conversation.

Common to both annotations is the permit attribute. This is an array of Exception classes which if encountered during the method execution, will still allow the conversation to begin, or end. By default, any exception encountered will either prohibit the conversation from beginning or ending.

The @Begin annotation has the id property which can be used to provide an id for the conversation, instead of the default. The timeout property is used to set the timeout for the conversation in milliseconds.

@End has no additional properties.