svn commit: r580259 - /myfaces/orchestra/trunk/core/src/site/xdoc/conversation.xml

[sk...@apache.org]

Author: skitching
Date: Fri Sep 28 02:08:46 2007
New Revision: 580259

URL: http://svn.apache.org/viewvc?rev=580259&view=rev
Log:
Add doc section about multiple passes through a conversation.

Modified:
    myfaces/orchestra/trunk/core/src/site/xdoc/conversation.xml

Modified: myfaces/orchestra/trunk/core/src/site/xdoc/conversation.xml
URL: http://svn.apache.org/viewvc/myfaces/orchestra/trunk/core/src/site/xdoc/conversation.xml?rev=580259&r1=580258&r2=580259&view=diff
==============================================================================
--- myfaces/orchestra/trunk/core/src/site/xdoc/conversation.xml (original)
+++ myfaces/orchestra/trunk/core/src/site/xdoc/conversation.xml Fri Sep 28 02:08:46 2007
@@ -55,6 +55,12 @@
 				<ul>
 					<li><p>When the conversation is complete, it is best to discard all the related objects in order
 						to save memory. However this is quite difficult to do when using session scope.</p></li>
+					<li><p>When a user performs some task for a second time (eg purchasing a second insurance policy),
+					    it is usually better for the backing beans to be new instances rather than having whatever
+					    state they had at the end of the previous pass. This is difficult to achieve when the beans
+					    are in session scope; every relevant bean needs to be explicitly deleted or reset. However
+					    when these objects are stored in a conversation this happens automatically as the conversation
+					    (with all its beans) has been discarded.</p></li>
 					<li><p>The user cannot have multiple windows open on the same site. Sessions are typically
 						tracked using cookies, and all windows associated with the same browser instance
 						share cookies and therefore are within the same "session". If two windows are created
@@ -63,8 +69,7 @@
 						multiple concurrent windows (eg MyFaces and Sun RI) but this only means that the JSF
 						*components* are safe for use with multiple windows; any application that uses only
 						request-scope beans will therefore work correctly but apps with session-scoped beans
-						will still suffer confusion.</p>
-					</li>
+						will still suffer confusion.</p></li>
 				</ul>
 			</p>