7.10. Contextual events
Seam defines a number of built-in events that the application uses for certain kinds of framework integration. The events are:
Table 7.1. Contextual Events
| Event | Description |
|---|---|
org.jboss.seam.validationFailed
|
Called when JSFvalidation fails.
|
org.jboss.seam.noConversation
|
Called when there is nolong-running conversation and a long-running conversation is required.
|
org.jboss.seam.preSetVariable.<name>
|
called when the context variable <name> is set.
|
org.jboss.seam.postSetVariable.<name>
|
called when the context variable <name> is set.
|
org.jboss.seam.preRemoveVariable.<name>
|
Called when the context variable <name> is unset.
|
org.jboss.seam.postRemoveVariable.<name>
|
Called when the context variable <name> is unset.
|
org.jboss.seam.preDestroyContext.<SCOPE>
|
Called before the <SCOPE> context is destroyed.
|
org.jboss.seam.postDestroyContext.<SCOPE>
|
Called after the <SCOPE> context is destroyed.
|
org.jboss.seam.beginConversation
|
Called whenever along-running conversation begins.
|
org.jboss.seam.endConversation
|
Called whenever a long-running conversation ends.
|
org.jboss.seam.conversationTimeout
|
Called when a conversation timeout occurs. The conversation ID is passed as a parameter.
|
org.jboss.seam.beginPageflow
|
Called when a pageflowbegins.
|
org.jboss.seam.beginPageflow.<name>
|
Called when the pageflow <name> begins.
|
org.jboss.seam.endPageflow
|
Called when a pageflowends.
|
org.jboss.seam.endPageflow.<name>
|
Called when the pageflow <name> ends.
|
org.jboss.seam.createProcess.<name>
|
called when the process <name> is created.
|
org.jboss.seam.endProcess.<name>
|
called when the process <name> ends.
|
org.jboss.seam.initProcess.<name>
|
called when the process <name> is associated with the conversation.
|
org.jboss.seam.initTask.<name>
|
Called when the task <name> is associated with the conversation.
|
org.jboss.seam.startTask.<name>
|
Called when the task <name> is started.
|
org.jboss.seam.endTask.<name>
|
Called when the task <name> is ended.
|
org.jboss.seam.postCreate.<name>
|
Called when the component <name> is created.
|
org.jboss.seam.preDestroy.<name>
|
Called when the component <name> is destroyed.
|
org.jboss.seam.beforePhase
|
Called before the start of a JSF phase.
|
org.jboss.seam.afterPhase
|
Called after the end of a JSF phase.
|
org.jboss.seam.postInitialization
|
Called when Seam has initialized and started up all components.
|
org.jboss.seam.postReInitialization
|
Called when Seam has re-initialized and started up all components after a redeploy.
|
org.jboss.seam.exceptionHandled.<type>
|
Called when an uncaught exception is handled by Seam.
|
org.jboss.seam.exceptionHandled
|
Called when an uncaught exception is handled by Seam.
|
org.jboss.seam.exceptionNotHandled
|
Called when there was no handler for an uncaught exception.
|
org.jboss.seam.afterTransactionSuccess
|
Called when a transaction succeeds in the Seam Application Framework.
|
org.jboss.seam.afterTransactionSuccess.<name>
|
Called when a transaction succeeds in the Seam Application Framework managing the entity
<name> .
|
org.jboss.seam.security.loggedOut
|
Called when a user logs out.
|
org.jboss.seam.security.loginFailed
|
Called when a user authentication attempt fails.
|
org.jboss.seam.security.loginSuccessful
|
Called when a user is successfully authenticated.
|
org.jboss.seam.security.notAuthorized
|
Called when an authorization check fails.
|
org.jboss.seam.security.notLoggedIn
|
Called when there is no authenticated user and authentication is required.
|
org.jboss.seam.security.postAuthenticate
|
Called after a user is authenticated.
|
org.jboss.seam.security.preAuthenticate
|
Called before attempting to authenticate a user.
|
Seam components observe these events just as they observe any other component-driven event.
