[richfaces-svn-commits] JBoss Rich Faces SVN: r16837 - branches/enterprise/3.3.X/docs/userguide/en/src/main/docbook/modules.

Author: SeanRogers Date: 2010-04-28 23:42:51 -0400 (Wed, 28 Apr 2010) New Revision: 16837 Modified: branches/enterprise/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml Log: Adding note on circular references (RFPL-562) Modified: branches/enterprise/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml =================================================================== --- branches/enterprise/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2010-04-29 03:34:21 UTC (rev 16836) +++ branches/enterprise/3.3.X/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2010-04-29 03:42:51 UTC (rev 16837) @@ -188,6 +188,18 @@ Render Response Phase <property>RichFaces</property> framework makes a traversal of the component tree, calls its own renderer and put the result into the Faces Response. </para> + </listitem> + <listitem> + <para> + Certain components in the <property>RichFaces</property> framework allow data to be serialized and transferred from the server to the client. If the data model being used contains circular references, serialization of the data fails due to a stack overflow. + </para> + <para> + Circular references are unsupported and should be avoided; however, <xref linkend="Avoiding_Circular_References" /> shows how to prevent a stack overflow due to circular references. Serialization of the data is done from the top-most object down, and circular references back to parent objects are ignored. Access to non-serialized references to parent objects is not available using this method. + </para> + <example id="Avoiding_Circular_References"> + <title>Avoiding Circular References</title> + <programlisting language="XML" role="XML">Code sample</programlisting> + </example> </listitem> </itemizedlist> </section>