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>
Show replies by date