7:48 a.m.
Author: ilya_shaikovsky
Date: 2008-08-01 08:48:40 -0400 (Fri, 01 Aug 2008)
New Revision: 9860
Added:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/snippets/
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/snippets/validationBean.java
Modified:
trunk/samples/richfaces-demo/src/main/java/org/richfaces/demo/validation/PassTime.java
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/examples/jsfValidation.xhtml
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/usage.xhtml
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/examples/simple.xhtml
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/usage.xhtml
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/additionalValidation.xhtml
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/hibernateValidation.xhtml
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/usage.xhtml
Log:
validators descriptions
Modified:
trunk/samples/richfaces-demo/src/main/java/org/richfaces/demo/validation/PassTime.java
===================================================================
---
trunk/samples/richfaces-demo/src/main/java/org/richfaces/demo/validation/PassTime.java 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/java/org/richfaces/demo/validation/PassTime.java 2008-08-01
12:48:40 UTC (rev 9860)
@@ -14,7 +14,7 @@
}
@NotEmpty
- @Length(max=12, min=3)
+ @Length(max=15, min=3)
private String title;
@NotNull
@Min(0)
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/examples/jsfValidation.xhtml
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/examples/jsfValidation.xhtml 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/examples/jsfValidation.xhtml 2008-08-01
12:48:40 UTC (rev 9860)
@@ -15,7 +15,7 @@
<h:outputText value="Name:" />
<h:inputText value="#{userBean.name}" id="name"
required="true">
<f:validateLength minimum="3" maximum="12"/>
- <rich:ajaxValidator event="onblur" ajaxSingle="true" />
+ <rich:ajaxValidator event="onblur"/>
</h:inputText>
<rich:message for="name" />
@@ -23,7 +23,7 @@
<h:inputText value="#{userBean.age}" id="age"
required="true">
<f:convertNumber integerOnly="true"/>
<f:validateLongRange minimum="18" maximum="99"/>
- <rich:ajaxValidator event="onblur" ajaxSingle="true" />
+ <rich:ajaxValidator event="onblur"/>
</h:inputText>
<rich:message for="age"/>
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/usage.xhtml
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/usage.xhtml 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxValidator/usage.xhtml 2008-08-01
12:48:40 UTC (rev 9860)
@@ -9,9 +9,15 @@
<ui:define name="sample">
<p>
- Using standard JSF validators
+ rich:ajaxValidator is a component designed in order to provide ajax validation
+ inside the inputs. It designed like a4j:support component but skips all JSF
processing
+ except validation.
</p>
-
+ <p>
+ Look to the first simple example. This component should be added as child component
+ to input which should be validated and specify validation event. The component
+ is ajaxSingle by default so only current field will be validated.
+ </p>
<fieldset class="demo_fieldset">
<legend class="demo_legend">Title</legend>
<div class="sample-container" >
@@ -22,8 +28,11 @@
</div>
</fieldset>
<p>
- Using Hibernate validators
+ The component also provide possibility to use Hibernate Validation for the target
fileds.
</p>
+ <p>
+ Look to the next examlpe which is modified in order to use Hibernate Validators:
+ </p>
<fieldset class="demo_fieldset">
<legend class="demo_legend">Title</legend>
<div class="sample-container" >
@@ -33,10 +42,10 @@
<ui:param name="openlabel" value="View Page Source" />
</ui:include>
<ui:include src="/templates/include/sourceview.xhtml">
- <ui:param name="sourcepath"
value="/WEB-INF/src/org/richfaces/demo/validator/ValidatorBean.java"/>
- <ui:param name="openlabel" value="View ValidatorBean.java
Source" />
+ <ui:param name="openlabel" value="Validation Bean Code"
/>
<ui:param name="sourcetype" value="java" />
- </ui:include>
+ <ui:param name="sourcepath"
value="/richfaces/beanValidator/snippets/validationBean.java"/>
+ </ui:include>
</div>
</fieldset>
</ui:define>
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/examples/simple.xhtml
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/examples/simple.xhtml 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/examples/simple.xhtml 2008-08-01
12:48:40 UTC (rev 9860)
@@ -13,7 +13,7 @@
<h:panelGrid columns="3">
<h:outputText value="Name:" />
<h:inputText value="#{validationBean.name}" id="name">
- <rich:ajaxValidator/>
+ <rich:beanValidator/>
</h:inputText>
<rich:message for="name" />
<h:outputText value="Email:" />
Added:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/snippets/validationBean.java
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/snippets/validationBean.java
(rev 0)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/snippets/validationBean.java 2008-08-01
12:48:40 UTC (rev 9860)
@@ -0,0 +1,49 @@
+package org.richfaces.demo.validation;
+
+import org.hibernate.validator.Email;
+import org.hibernate.validator.Length;
+import org.hibernate.validator.Max;
+import org.hibernate.validator.Min;
+import org.hibernate.validator.NotEmpty;
+import org.hibernate.validator.NotNull;
+
+public class ValidationBean {
+
+ @NotEmpty
+ @Length(min=3,max=12)
+ private String name;
+ @Email
+ @NotEmpty
+ private String email;
+ @NotNull
+ @Min(18)
+ @Max(100)
+ private int age;
+
+ public ValidationBean() {
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ public String getEmail() {
+ return email;
+ }
+
+ public void setEmail(String email) {
+ this.email = email;
+ }
+
+ public int getAge() {
+ return age;
+ }
+
+ public void setAge(int age) {
+ this.age = age;
+ }
+}
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/usage.xhtml
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/usage.xhtml 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/beanValidator/usage.xhtml 2008-08-01
12:48:40 UTC (rev 9860)
@@ -9,19 +9,30 @@
<ui:define name="sample">
<p>
- Description
+ Starting from 3.2.2 GA version Rich Faces provides support for model-based
+ constraints defined using Hibernate Validator. So it's possible to use Hibernate
+ Validators the same as for Seam based applications.
</p>
-
+ <p>
+ rich:beanValidator component should be defined in the same way
+ as any JSF validators.
+ Lock through the example below.
+ </p>
<fieldset class="demo_fieldset">
<legend class="demo_legend">Title</legend>
<div class="sample-container" >
<ui:include src="/richfaces/beanValidator/examples/simple.xhtml"/>
<ui:include src="/templates/include/sourceview.xhtml">
+ <ui:param name="openlabel" value="Page Code" />
<ui:param name="sourcepath"
value="/richfaces/beanValidator/examples/simple.xhtml"/>
</ui:include>
+ <ui:include src="/templates/include/sourceview.xhtml">
+ <ui:param name="openlabel" value="Validation Bean Code"
/>
+ <ui:param name="sourcetype" value="java" />
+ <ui:param name="sourcepath"
value="/richfaces/beanValidator/snippets/validationBean.java"/>
+ </ui:include>
</div>
</fieldset>
</ui:define>
-
</ui:composition>
</html>
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/additionalValidation.xhtml
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/additionalValidation.xhtml 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/additionalValidation.xhtml 2008-08-01
12:48:40 UTC (rev 9860)
@@ -21,11 +21,8 @@
</rich:inputNumberSpinner>
<rich:message for="time" />
</rich:column>
- <rich:column>
- <h:outputText value="#{pt.title}" id="out"/>
- </rich:column>
</rich:dataTable>
</rich:graphValidator>
- <h:commandButton value="Store my details" />
+ <a4j:commandButton value="Store my details"
action="#{pt.store}"/>
</h:form>
</ui:composition>
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/hibernateValidation.xhtml
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/hibernateValidation.xhtml 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/examples/hibernateValidation.xhtml 2008-08-01
12:48:40 UTC (rev 9860)
@@ -13,7 +13,9 @@
<rich:graphValidator>
<h:panelGrid columns="3">
<h:outputText value="Name:" />
- <h:inputText value="#{validationBean.name}" id="name"/>
+ <h:inputText value="#{validationBean.name}" id="name">
+ <f:validateLength minimum="2"/>
+ </h:inputText>
<rich:message for="name" />
<h:outputText value="Email:" />
<h:inputText value="#{validationBean.email}" id="email"/>
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/usage.xhtml
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/usage.xhtml 2008-08-01
11:38:29 UTC (rev 9859)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/graphValidator/usage.xhtml 2008-08-01
12:48:40 UTC (rev 9860)
@@ -9,9 +9,15 @@
<ui:define name="sample">
<p>
- Description
+ Graph validator component also allow to register Hibernate Validators for the
+ input components. As opposite to beanValidator which should be
+ child component for the input to be validated this component should wrap
+ some subtree with inputs. As result validator for every input in this
+ subtree will be added to component.
</p>
-
+ <p>
+ Look through the next simple example:
+ </p>
<fieldset class="demo_fieldset">
<legend class="demo_legend">Title</legend>
<div class="sample-container" >
@@ -19,21 +25,38 @@
<ui:include src="/templates/include/sourceview.xhtml">
<ui:param name="sourcepath"
value="/richfaces/graphValidator/examples/hibernateValidation.xhtml"/>
</ui:include>
+ <ui:include src="/templates/include/sourceview.xhtml">
+ <ui:param name="openlabel" value="Validation Bean Code"
/>
+ <ui:param name="sourcetype" value="java" />
+ <ui:param name="sourcepath"
value="/richfaces/beanValidator/snippets/validationBean.java"/>
+ </ui:include>
</div>
</fieldset>
<p>
- Description
+ There is one additional usefull feature in Graph Validator component.
+ Value attribute could be defined with some value binding to bean. And the
+ bean properties will be validated again <b>after</b> model update.
</p>
-
+ <p>
+ Simple example of such usage below. Just write some activities of the day
+ and the time you spend to each one in a day.
+ </p>
<fieldset class="demo_fieldset">
<legend class="demo_legend">Title</legend>
- <div class="sample-container" >
+ <div class="sample-container">
<ui:include
src="/richfaces/graphValidator/examples/additionalValidation.xhtml"/>
<ui:include src="/templates/include/sourceview.xhtml">
<ui:param name="sourcepath"
value="/richfaces/graphValidator/examples/additionalValidation.xhtml"/>
</ui:include>
</div>
</fieldset>
+ <p>
+ In this case only properties of each passTime(values of the inputs) validated
+ at validation phase.
+ But after the model updated (Each explicit passtime was validated ok) all the
+ properties including "TotalTime" validated again. And total validation
could
+ fails if the sum of the hours in a day more than 24.
+ </p>
</ui:define>
</ui:composition>