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

[Gavin King]

  User: gavin   
  Date: 06/11/20 15:14:27

  Modified:    doc/reference/en/modules    annotations.xml components.xml
                        concepts.xml
  Log:
  @readonly
  
  Revision  Changes    Path
  1.48      +10 -9     jboss-seam/doc/reference/en/modules/annotations.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: annotations.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/annotations.xml,v
  retrieving revision 1.47
  retrieving revision 1.48
  diff -u -b -r1.47 -r1.48
  --- annotations.xml	24 Oct 2006 15:18:17 -0000	1.47
  +++ annotations.xml	20 Nov 2006 20:14:27 -0000	1.48
  @@ -128,15 +128,6 @@
                           a long-running conversation started by this component is active 
                           (unless the method would begin a new long-running conversation).
                       </para>
  -                    <itemizedlist>
  -                        <listitem>
  -                        <para>
  -                            <literal>ifNotBegunOutcome</literal> &mdash; specifies a JSF
  -                            outcome for the action when the component is invoked and no
  -                            long-running conversation is active.
  -                        </para>
  -                        </listitem>
  -                    </itemizedlist>
                   </listitem>
               </varlistentry>   
               <varlistentry  id="startup-annotation">
  @@ -177,6 +168,16 @@
                       </para>
                   </listitem>
               </varlistentry>   
  +            <varlistentry  id="synchronized-annotation">
  +                <term><literal>@ReadOnly</literal></term>
  +                <listitem>
  +                    <programlisting><![CDATA[@ReadOnly]]></programlisting>
  +                    <para>
  +                        Specifies that a JavaBean component or component method does not
  +                        require state replication at the end of the invocation.
  +                    </para>
  +                </listitem>
  +            </varlistentry>   
           </variablelist>
       </section>
   
  
  
  
  1.50      +8 -0      jboss-seam/doc/reference/en/modules/components.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: components.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/components.xml,v
  retrieving revision 1.49
  retrieving revision 1.50
  diff -u -b -r1.49 -r1.50
  --- components.xml	20 Nov 2006 20:05:18 -0000	1.49
  +++ components.xml	20 Nov 2006 20:14:27 -0000	1.50
  @@ -1174,6 +1174,14 @@
                   </listitem>
               </varlistentry>
               <varlistentry>
  +                <term><literal>org.jboss.seam.persistence.persistenceProvider</literal></term>
  +                <listitem>
  +                    <para>
  +                        Abstraction layer for non-standardized features of JPA provider.
  +                    </para>
  +                </listitem>
  +            </varlistentry>
  +            <varlistentry>
                   <term><literal>org.jboss.seam.core.validation</literal></term>
                   <listitem>
                       <para>
  
  
  
  1.41      +29 -1     jboss-seam/doc/reference/en/modules/concepts.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: concepts.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/concepts.xml,v
  retrieving revision 1.40
  retrieving revision 1.41
  diff -u -b -r1.40 -r1.41
  --- concepts.xml	20 Nov 2006 19:56:49 -0000	1.40
  +++ concepts.xml	20 Nov 2006 20:14:27 -0000	1.41
  @@ -1205,7 +1205,7 @@
       </sect1>
       
           <sect1>
  -            <title>The <literal>Mutable</literal> interface</title>
  +            <title>The <literal>Mutable</literal> interface and <literal>@ReadOnly</literal></title>
               <para>
                   Many application servers feature an amazingly broken implementation of 
                   <literal>HttpSession</literal> clustering, where changes to the state of mutable
  @@ -1215,6 +1215,7 @@
                   when failover occurs. Furthermore, the actual replication message contains the
                   entire serialized object graph bound to the session attribute, which inefficient.
               </para>
  +            
               <para>
                   Of course, EJB stateful session beans must perform automatic dirty checking and 
                   replication of mutable state and a sophisticated EJB container can introduce
  @@ -1224,6 +1225,7 @@
                   Seam provides an extra layer of cluster-safe state management over the top
                   of the web container session clustering.
               </para>
  +            
               <para>
                   For session or conversation scoped JavaBean components, Seam automatically forces 
                   replication to occur by calling <literal>setAttribute()</literal> once in every 
  @@ -1255,6 +1257,32 @@
   }]]></programlisting>
               
               <para>
  +                Or, you can use the <literal>@ReadOnly</literal> annotation to achieve
  +                a similar effect:
  +            </para>
  +            
  +            <programlisting><![CDATA[@Name("account")
  +public class Account
  +{
  +    private BigDecimal balance;
  +    
  +    public void setBalance(BigDecimal balance)
  +    {
  +        setDirty(this.balance, balance);
  +        this.balance = balance;
  +    }
  +    
  +    @ReadOnly
  +    public BigDecimal getBalance()
  +    {
  +        return balance;
  +    }
  +    
  +    ...
  +    
  +}]]></programlisting>
  +
  +            <para>
                   For session or conversation scoped entity bean components, Seam automatically forces 
                   replication to occur by calling <literal>setAttribute()</literal> once in every 
                   request. This strategy is not efficient, so session or conversation scope entity