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

[Gavin King]

  User: gavin   
  Date: 07/02/22 14:47:02

  Modified:    doc/reference/en/modules  conversations.xml
  Log:
  JBSEAM-858
  
  Revision  Changes    Path
  1.25      +39 -0     jboss-seam/doc/reference/en/modules/conversations.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: conversations.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/conversations.xml,v
  retrieving revision 1.24
  retrieving revision 1.25
  diff -u -b -r1.24 -r1.25
  --- conversations.xml	10 Feb 2007 16:42:48 -0000	1.24
  +++ conversations.xml	22 Feb 2007 19:47:02 -0000	1.25
  @@ -813,4 +813,43 @@
           
       </section>
           
  +    <section>
  +        <title>Conversational components and JSF component bindings</title>
  +
  +        <para>
  +            Conversational components have one minor limitation: they cannot be used to hold bindings 
  +            to JSF components. (We generally prefer not to use this feature of JSF unless absolutely
  +            necessary, since it creates a hard dependency from application logic to the view.) On a 
  +            postback request, component bindings are updated during the Restore View phase, 
  +            before the Seam conversation context has been restored.
  +        </para>
  +        
  +        <para>
  +            To work around this use an event scoped component to store the component bindings and inject 
  +            it into conversation scoped component that requires it.
  +        </para>
  +
  +        <programlisting><![CDATA[@Name("grid")
  + at Scope(ScopeType.EVENT)
  +public class Grid
  +{
  +    private HtmlPanelGrid htmlPanelGrid;
  +
  +    // getters and setters
  +    ...
  +}]]></programlisting>
  +
  +
  +        <programlisting><![CDATA[@Name("gridEditor")
  + at Scope(ScopeType.CONVERSATION)
  +public class GridEditor
  +{
  +    @In(required=false)
  +    private Grid grid;
  +    
  +    ...
  +}]]></programlisting>
  +
  +    </section>
  +        
   </chapter>
  \ No newline at end of file