You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by se...@apache.org on 2013/02/01 13:21:16 UTC
svn commit: r1441420 -
/commons/proper/validator/trunk/src/main/java/org/apache/commons/validator/package.html
Author: sebb
Date: Fri Feb 1 12:21:15 2013
New Revision: 1441420
URL: http://svn.apache.org/viewvc?rev=1441420&view=rev
Log:
Simplify layout by using <pre> blocks
Modified:
commons/proper/validator/trunk/src/main/java/org/apache/commons/validator/package.html
Modified: commons/proper/validator/trunk/src/main/java/org/apache/commons/validator/package.html
URL: http://svn.apache.org/viewvc/commons/proper/validator/trunk/src/main/java/org/apache/commons/validator/package.html?rev=1441420&r1=1441419&r2=1441420&view=diff
==============================================================================
--- commons/proper/validator/trunk/src/main/java/org/apache/commons/validator/package.html (original)
+++ commons/proper/validator/trunk/src/main/java/org/apache/commons/validator/package.html Fri Feb 1 12:21:15 2013
@@ -20,7 +20,7 @@
</head>
<body bgcolor="white">
The Validator package provides validation for JavaBeans based on an xml file.
-<br><br>
+<br/><br/>
<a name="doc.Description"></a>
<div align="center">
<a href="http://commons.apache.org/validator/dependencies.html">[Dependencies]</a>
@@ -144,59 +144,54 @@ speed development and maintenance of val
</p>
<p>
Create an xml file with your validator and validation rules.
- Setup your required validator in your xml file.<br>
- <br>
- <a href="#doc.Usage.xml">XML Example</a><br>
- <a href="#doc.Usage.validator">Validator Example</a><br>
+ Setup your required validator in your xml file.<br/>
+ <br/>
+ <a href="#doc.Usage.xml">XML Example</a><br/>
+ <a href="#doc.Usage.validator">Validator Example</a><br/>
<a href="#doc.Usage.pluggableValidator">Pluggable Validator Example</a>
</p>
<a name="doc.Usage.xml"></a>
<h4>XML Example</h4>
<p>
- Definition of a 'required' pluggable validator.<br>
- <br>
- <form-validation> <br>
- <global> <br>
- <validator name="required" <br>
- classname="org.apache.commons.validator.TestValidator" <br>
- method="validateRequired" <br>
- methodParams="java.lang.Object,
- org.apache.commons.validator.Field"/> <br>
-
- </global> <br>
- <formset> <br>
- </formset> <br>
- </form-validation> <br>
-
-</p>
-<p>
- Add validation rules to require a first name and a last name.<br>
- <br>
- <form-validation> <br>
- <global> <br>
- <validator name="required" <br>
- classname="org.apache.commons.validator.TestValidator" <br>
- method="validateRequired" <br>
- methodParams="java.lang.Object,
- org.apache.commons.validator.Field"/> <br>
-
- </global> <br>
+ Definition of a 'required' pluggable validator.<br/>
+<pre>
+<form-validation>
+ <global>
+ <validator name="required"
+ classname="org.apache.commons.validator.TestValidator"
+ method="validateRequired"
+ methodParams="java.lang.Object, org.apache.commons.validator.Field"/>
+ </global>
+ <formset>
+ </formset>
+</form-validation>
+</pre>
+</p>
+<p>
+ Add validation rules to require a first name and a last name.<br/>
+<pre>
+<form-validation>
+ <global>
+ <validator name="required"
+ classname="org.apache.commons.validator.TestValidator"
+ method="validateRequired"
+ methodParams="java.lang.Object, org.apache.commons.validator.Field"/>
+ </global>
<b>
- <formset> <br>
- <form name="nameForm"> <br>
- <field property="firstName"
- depends="required"> <br>
- <arg0 key="nameForm.firstname.displayname"/> <br>
- </field> <br>
- <field property="lastName"
- depends="required"> <br>
- <arg0 key="nameForm.lastname.displayname"/> <br>
- </field> <br>
- </form> <br>
- </formset> <br>
+ <formset>
+ <form name="nameForm">
+ <field property="firstName" depends="required">
+ <arg0 key="nameForm.firstname.displayname"/>
+ </field>
+ <field property="lastName" depends="required">
+ <arg0 key="nameForm.lastname.displayname"/>
+ </field>
+ </form>
+ </formset>
</b>
- </form-validation> <br>
+</form-validation>
+</pre>
</p>
<a name="doc.Usage.validator"></a>
@@ -204,38 +199,33 @@ speed development and maintenance of val
<p>
Excerpts from org.apache.commons.validator.RequiredNameTest
</p>
-<p>
-InputStream in = this.getClass().getResourceAsStream("validator-name-required.xml");<br>
-<br>
-// Create an instance of ValidatorResources to <br>
-// initialize from an xml file. <br>
+<pre>
+InputStream in = this.getClass().getResourceAsStream("validator-name-required.xml");
+
+// Create an instance of ValidatorResources to initialize from an xml file.
ValidatorResources resources = new ValidatorResources(in);
-</p>
-<p>
-// Create bean to run test on.<br>
-Name name = new Name();<br>
-<br>
- // Construct validator based on the loaded resources <br>
- // and the form key<br>
- Validator validator = new Validator(resources, "nameForm");<br>
- // add the name bean to the validator as a resource <br>
- // for the validations to be performed on.<br>
- validator.setParameter(Validator.BEAN_PARAM, name);<br>
-<br>
- // Get results of the validation.<br>
- Map results = null;<br>
- <br>
- // throws ValidatorException, <br>
- // but aren't catching for example <br>
- results = validator.validate();<br>
- <br>
- if (results.get("firstName") == null) { <br>
- // no error <br>
- } else {<br>
- // number of errors for first name
- int errors = ((Integer)results.get("firstName")).intValue();<br>
- } <br>
-</p>
+// Create bean to run test on.
+Name name = new Name();
+
+// Construct validator based on the loaded resources and the form key
+Validator validator = new Validator(resources, "nameForm");
+// add the name bean to the validator as a resource
+// for the validations to be performed on.
+validator.setParameter(Validator.BEAN_PARAM, name);
+
+// Get results of the validation.
+Map results = null;
+
+// throws ValidatorException (catch clause not shown here)
+results = validator.validate();
+
+if (results.get("firstName") == null) {
+ // no error
+} else {
+ // number of errors for first name
+ int errors = ((Integer)results.get("firstName")).intValue();
+}
+</pre>
<a name="doc.Usage.pluggableValidator"></a>
<h4>Pluggable Validator Example</h4>
@@ -244,11 +234,11 @@ Validation method defined in the 'requir
(excerpt from org.apache.commons.validator.TestValidator).
</p>
-<p>
- public static boolean validateRequired(Object bean, Field field) {<br>
- String value = ValidatorUtil.getValueAsString(bean, field.getProperty());<br>
- return GenericValidator.isBlankOrNull(value);<br>
- }<br>
-</p>
+<pre>
+public static boolean validateRequired(Object bean, Field field) {
+ String value = ValidatorUtil.getValueAsString(bean, field.getProperty());
+ return GenericValidator.isBlankOrNull(value);
+}
+</pre>
</body>
</html>