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

[Peter Muir]

  User: pmuir   
  Date: 07/08/08 07:48:03

  Modified:    doc/reference/en/modules  framework.xml
  Log:
  JBSEAM-1700 more docs
  
  Revision  Changes    Path
  1.23      +15 -2     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.22
  retrieving revision 1.23
  diff -u -b -r1.22 -r1.23
  --- framework.xml	8 Aug 2007 11:37:33 -0000	1.22
  +++ framework.xml	8 Aug 2007 11:48:03 -0000	1.23
  @@ -299,7 +299,11 @@
   			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.
  +			this event we can refresh our queries when the underlying entities are changed.  If
  +			we only want to refresh certain queries when a particular entity is persited, 
  +			updated or removed we can observe the 
  +			<literal>org.jboss.seam.afterTransactionSuccess.&lt;name&gt;</literal> 
  +			event (where <literal>&lt;name&gt;</literal> is the name of the entity).
   		</para>
   
           <para>
  @@ -479,7 +483,7 @@
   </h:dataTable>]]></programlisting>
   
   		<para>
  -			To update the query when the underlying entities change we observe the
  +			To refresh the query when the underlying entities change we observe the
   			<literal>org.jboss.seam.afterTransactionSuccess</literal> event:
   		</para>
   		
  @@ -488,6 +492,15 @@
   </event>]]></programlisting>
   
           <para>
  +			Or, to just refresh the query when the person entity is persisted, updated or 
  +			removed through <literal>PersonHome</literal>:
  +		</para>
  +		
  +		<programlisting><![CDATA[<event type="org.jboss.seam.afterTransactionSuccess.Person">
  +    <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>