From richfaces-svn-commits at lists.jboss.org Mon Jun 16 08:22:16 2008
Content-Type: multipart/mixed; boundary="===============8504828448411013282=="
MIME-Version: 1.0
From: richfaces-svn-commits at lists.jboss.org
To: richfaces-svn-commits at lists.jboss.org
Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r9051 -
 trunk/docs/userguide/en/src/main/docbook/included.
Date: Mon, 16 Jun 2008 08:22:15 -0400
Message-ID: <E1K8Dix-0004v5-7Q@committer01.frg.pub.inap.atl.jboss.com>

--===============8504828448411013282==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: artdaw
Date: 2008-06-16 08:22:15 -0400 (Mon, 16 Jun 2008)
New Revision: 9051

Modified:
   trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml
Log:
http://jira.jboss.com/jira/browse/RF-3701 - Description was checked. Info a=
bout 'ajaxOnly' attribute was added

Modified: trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml	2008-06=
-16 12:17:06 UTC (rev 9050)
+++ trunk/docs/userguide/en/src/main/docbook/included/keepAlive.xml	2008-06=
-16 12:22:15 UTC (rev 9051)
@@ -59,32 +59,39 @@
   <section>
     <title>Key attributes and ways of usage</title>
 	<para>
-	  If a managed bean is declared with <property>request</property> scope i=
n the configuration file with the help of <property>managed-bean-scope</pro=
perty> tag then the life-time of
+	  If a managed bean is declared with <property>request</property> scope i=
n the configuration file with the help of =

+	  <emphasis role=3D"bold"><property>&lt;managed-bean-scope&gt;</property>=
</emphasis> tag then the life-time of
 	 this bean instance is valid only for the current request.
 	 Any attempts to make a reference to the bean instance after the request =
end will throw in Illegal Argument Exception by the server.
-	To avoid these kinds of Exception, component
-	<emphasis role=3D"bold"><property>&lt;a4j:keepAlive&gt;</property>
-	</emphasis>  is used to maintain the state of the whole bean object among=
 subsequent request. =

+	To avoid these kinds of Exception, component <emphasis role=3D"bold"><pro=
perty>&lt;a4j:keepAlive&gt;</property></emphasis>  =

+	is used to maintain the state of the whole bean object among subsequent r=
equest. =

 	</para>
 =

-	<para><emphasis role=3D"bold">Example:</emphasis></para>
+	<para>
+		<emphasis role=3D"bold">Example:</emphasis>
+	</para>
 =

 	<programlisting role=3D"XML"><![CDATA[<a4j:keepAlive beanName =3D "#{myCl=
ass.testBean}"/>]]></programlisting>
 =

 	<para>
-	  Note that the attribute <emphasis><property>&quot;beanName&quot;</prope=
rty></emphasis> must point to a legal jsf EL expression which resolves to a=
 managed mean instance. For example for
-	the above code the class definition may look like this:</para>
-
+	The <emphasis><property>&quot;beanName&quot;</property></emphasis> attrib=
ute defines the request scope bean name you&apos;d like  =

+	to re-use. Note that this attribute must point to a legal JSF EL expressi=
on which resolves to a managed mean instance. For example for
+	the above code the class definition may look like this one:
+	</para>
 	<programlisting role=3D"JAVA"><![CDATA[
-        class MyClass{
+class MyClass{
 	...
 	private TestBean testBean;
 	// Getters and Setters for testBean.
 	...
 }
-	]]></programlisting>
-
-
+]]></programlisting>
+	<para>
+		The <emphasis><property>&quot;ajaxOnly&quot;</property></emphasis> attri=
bute =

+		declares whether the value of the bean should be available during a non-=
Ajax request.
+		If the value of this attribute is &quot;true&quot; a request scope bean =
keeps the same value during Ajax requests =

+		from the given page. If a non-Ajax request is sent from this page the be=
an is re-created as a regular request scope bean.
+	</para>
   </section>
   <section>
     <title>Relevant resources links</title>


--===============8504828448411013282==--