From richfaces-svn-commits at lists.jboss.org Thu Aug 14 04:47:00 2008
Content-Type: multipart/mixed; boundary="===============9134834146099218413=="
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: r10085 -
 trunk/docs/userguide/en/src/main/docbook/included.
Date: Thu, 14 Aug 2008 04:47:00 -0400
Message-ID: <E1KTYU0-0000ZM-IW@committer01.frg.pub.inap.atl.jboss.com>

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

Author: artdaw
Date: 2008-08-14 04:47:00 -0400 (Thu, 14 Aug 2008)
New Revision: 10085

Modified:
   trunk/docs/userguide/en/src/main/docbook/included/graphValidator.desc.xml
   trunk/docs/userguide/en/src/main/docbook/included/graphValidator.xml
Log:
https://jira.jboss.org/jira/browse/RF-3903
Added info about graphValidator

Modified: trunk/docs/userguide/en/src/main/docbook/included/graphValidator.=
desc.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/graphValidator.desc.x=
ml	2008-08-14 08:46:44 UTC (rev 10084)
+++ trunk/docs/userguide/en/src/main/docbook/included/graphValidator.desc.x=
ml	2008-08-14 08:47:00 UTC (rev 10085)
@@ -9,7 +9,7 @@
         <title>Description</title>
         <para>The<emphasis role=3D"bold">
             <property>&lt;rich:ajaxGraph&gt;</property> =

-        </emphasis>is a component designed to provide ajax validation insi=
de for JSF inputs.</para>
+        </emphasis>component  allows to register Hibernate Validators for =
multiple input components.</para>
 =

     </section>
     <section>

Modified: trunk/docs/userguide/en/src/main/docbook/included/graphValidator.=
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/graphValidator.xml	20=
08-08-14 08:46:44 UTC (rev 10084)
+++ trunk/docs/userguide/en/src/main/docbook/included/graphValidator.xml	20=
08-08-14 08:47:00 UTC (rev 10085)
@@ -81,7 +81,57 @@
 HtmlgraphValidator mygraphValidator=3D new HtmlgraphValidator();
 ...
 ]]></programlisting>
+    =

+    =

   </section>
+  =

+  <para> The<emphasis role=3D"bold">
+    <property>&lt;rich:graphValidator&gt;</property></emphasis>component b=
ehaves basically the same way as the <emphasis role=3D"bold">
+    <property>&lt;rich:beanValidator&gt;</property></emphasis>
 =

+    The deference between these two components is that in order to validat=
e some input data with a  <emphasis role=3D"bold">
+      <property>&lt;rich:beanValidator&gt;</property></emphasis> component=
, it should be a nested element of an input component,  whereas <emphasis r=
ole=3D"bold">
+        <property>&lt;rich:graphValidator&gt;</property></emphasis> wraps =
multiple input components and validates the data received from them.
+  </para>
 =

+  <para>The following example demonstrate a pattern of  how the <emphasis =
role=3D"bold">
+    <property>&lt;rich:graphValidator&gt;</property></emphasis> can be use=
d.</para>
+  <programlisting role=3D"XML"><![CDATA[...
+                <rich:graphValidator>
+                    <h:panelGrid columns=3D"3">
+                        <h:outputText value=3D"Name:" />
+                        <h:inputText value=3D"#{validationBean.name}" id=
=3D"name">
+                            <f:validateLength minimum=3D"2" />
+                        </h:inputText>
+                        <rich:message for=3D"name" />
+                        <h:outputText value=3D"Email:" />
+                        <h:inputText value=3D"#{validationBean.email}" id=
=3D"email" />
+                        <rich:message for=3D"email" />
+                    </h:panelGrid>
+                </rich:graphValidator>
+                ...
+]]></programlisting>
+  =

+  <para>The data validation can be also performed using Hibernate Validato=
r, the same way as it is done with <emphasis role=3D"bold">
+    <property>&lt;rich:beanValidator&gt;</property></emphasis>. </para>
+  =

 =

+
+  <para>The components&apos;s architecture provides an option to bind the =
component to a managed bean, which is done with the <emphasis >
+    <property>&lt;value&gt;</property></emphasis> attribute. The attribute=
 ensures that the entered  data is valid after the model is updated by reva=
lidating the bean properties.</para>
+  <para>Please look at the example below.</para>
+  =

+  =

+  <programlisting role=3D"XML"><![CDATA[...
+  <rich:graphValidator value=3D"#{dayStatistics}">
+    <h:outputText value=3D"#{pt.title}" /><
+     <rich:inputNumberSpinne minValue=3D"0" maxValue=3D"24" value=3D"#{pt.=
time}" id=3D"time">
+       </rich:inputNumberSpinner>
+         <rich:message for=3D"time" />  =

+</rich:graphValidator>
+                ...
+]]></programlisting>
+  =

+
+</section>
+


--===============9134834146099218413==--