[jboss-cvs] jboss-seam/doc/reference/en/modules ...

[Peter Muir]

  User: pmuir   
  Date: 07/08/08 07:37:33

  Modified:    doc/reference/en/modules   events.xml framework.xml
  Log:
  JBSEAM-1700
  
  Revision  Changes    Path
  1.29      +8 -6      jboss-seam/doc/reference/en/modules/events.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: events.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/events.xml,v
  retrieving revision 1.28
  retrieving revision 1.29
  diff -u -b -r1.28 -r1.29
  --- events.xml	22 Jun 2007 15:44:26 -0000	1.28
  +++ events.xml	8 Aug 2007 11:37:33 -0000	1.29
  @@ -51,7 +51,7 @@
           
           <programlisting><![CDATA[<start-page name="hello" view-id="/hello.jsp">
       <transition to="hello">
  -        <action execute="#{helloWorld.sayHello}"/>
  +        <action expression="#{helloWorld.sayHello}"/>
       </transition>
   </start-page>]]></programlisting>
   
  @@ -113,8 +113,8 @@
           
           <programlisting><![CDATA[<pages>
       <page view-id="/hello.jsp">
  -        <action execute="#{helloWorld.sayHello}" if="#{not validation.failed}"/>
  -        <action execute="#{hitCount.increment}"/>
  +        <action expression="#{helloWorld.sayHello}" if="#{not validation.failed}"/>
  +        <action expression="#{hitCount.increment}"/>
       </page>
   </pages>]]></programlisting>
   
  @@ -503,8 +503,8 @@
               
           <programlisting><![CDATA[<components>
       <event type="hello">
  -        <action execute="#{helloListener.sayHelloBack}"/>
  -        <action execute="#{logger.logHello}"/>
  +        <action expression="#{helloListener.sayHelloBack}"/>
  +        <action expression="#{logger.logHello}"/>
       </event>
   </components>]]></programlisting>
   
  @@ -628,9 +628,11 @@
               <listitem><para><literal>org.jboss.seam.preAuthenticate.&lt;name&gt; </literal>&#8212; called before attempting to authenticate a user</para></listitem>
               <listitem><para><literal>org.jboss.seam.notLoggedIn</literal> &#8212; called there is no authenticated user and authentication is required</para></listitem>
               <listitem><para><literal>org.jboss.seam.rememberMe</literal> &#8212; occurs when Seam security detects the username in a cookie</para></listitem>
  -            <listitem><para><literal>org.jboss.seam.exceptionHandled.&lt;Type&gt;</literal> &#8212; called when an uncaught exception is handled by Seam</para></listitem>
  +            <listitem><para><literal>org.jboss.seam.exceptionHandled.&lt;type&gt;</literal> &#8212; called when an uncaught exception is handled by Seam</para></listitem>
               <listitem><para><literal>org.jboss.seam.exceptionHandled</literal> &#8212; called when an uncaught exception is handled by Seam</para></listitem>
               <listitem><para><literal>org.jboss.seam.exceptionNotHandled</literal> &#8212; called when there was no handler for an uncaught exception</para></listitem>
  +            <listitem><para><literal>org.jboss.seam.afterTransactionSuccess</literal> &#8212; called when a transaction succeeds in the Seam Application Framework</para></listitem>
  +            <listitem><para><literal>org.jboss.seam.afterTransactionSuccess.&lt;name&gt;</literal> &#8212; called when a transaction succeeds in the Seam Application Framework which manages an entity called <literal>&lt;name&gt;</literal></para></listitem>
               </itemizedlist>
                
                <para>
  
  
  
  1.22      +16 -0     jboss-seam/doc/reference/en/modules/framework.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: framework.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/framework.xml,v
  retrieving revision 1.21
  retrieving revision 1.22
  diff -u -b -r1.21 -r1.22
  --- framework.xml	17 Jul 2007 09:14:38 -0000	1.21
  +++ framework.xml	8 Aug 2007 11:37:33 -0000	1.22
  @@ -296,6 +296,13 @@
   }]]></programlisting>
   
           <para>
  +			The Home object raises an <literal>org.jboss.seam.afterTransactionSuccess</literal> 
  +			event when a transaction succeeds (a call to <literal>persist()</literal>, 
  +			<literal>update()</literal> or <literal>remove()</literal> succeeds).  By observing 
  +			this event we can refresh our queries when the underlying entities are changed.
  +		</para>
  +
  +        <para>
               The Home object automatically displays faces messages when an operation is
               successful. To customize these messages we can, again, use configuration:
           </para>
  @@ -472,6 +479,15 @@
   </h:dataTable>]]></programlisting>
   
           <para>
  +			To update the query when the underlying entities change we observe the
  +			<literal>org.jboss.seam.afterTransactionSuccess</literal> event:
  +		</para>
  +		
  +		<programlisting><![CDATA[<event type="org.jboss.seam.afterTransactionSuccess">
  +    <action execute="#{people.refresh}" />
  +</event>]]></programlisting>
  +
  +        <para>
               The examples in this section have all shown reuse by configuration. However,
               reuse by extension is equally possible for Query objects.
           </para>