This page describes Changes in version 1.2.0 of Commons Validator (see section 1. Changes) and notes on Upgrading from Validator 1.1.4 (see section 2. Upgrading).
...
1. Changes
Wiki Markup
Wiki Markup
1.1 Validator Inheritance
...
1.1.1 Explicit Form Inheritance
Wiki Markup
In the following example nameForm inherits from baseForm, overriding the lastName field...
...
For example, if you have a form named CustomerForm defined in a FormSet for the French language (no country) and also in a FormSet for the Candian French locale then the Candian French version of the Form will inherit from the French one.
Wiki Markup
N.B. See Section 2. Variables in Resource Bundles which may remove your need to have multiple FormSet's for different locales altogether.
...
One motivation for having different Form Sets was due to the fact that variable values needed to be different for different locales. Validator 1.2.0 has the facility to specify variable values in resource bundles which removes the need for multiple formsets in this instanceunmigrated-wiki-markup
Two new properties have been added to \[http://jakarta.apache.org/commons/validator/apidocs/org/apache/commons/validator/Var.html Variable\] - *resource* and *bundle*. Setting *resource* to *true* (default is _false_) indicates that the variable's value is a _resource key_. Additionally the (optional) *bundle* property can be set to the name of an alternative resource bundle.
In the following example the value of datePattern variable is specified in the validatorVariables bundle under a key of dateOfBirth.pattern.
| No Format |
|---|
<formset>
<form name="EmployeeForm">
<field property="dateOfBirth" depends="date">
<var resource="true" bundle="validatorVariables">
<var-name>datePattern</var-name>
<var-value>dateOfBirth.pattern</var-value>
</var>
</field>
</form>
</formset>
|
Wiki Markup
1.3 Arg0-Arg3 Deprecations Removed
...
| No Format |
|---|
<arg key="first.key" position="0">
<arg key="second.key" position="1">
|
Wiki Markup
Additionally, this issue only arises if you upgrade to the new version of the Validator DTD - previous versions of the DTD using arg0-arg3 will continue to work in Validator 1.2.0.
...
A few new validators have been added:
Wiki Markup - New _locale aware_ *byte*, *short*, *integer*, *long*, *float* and *double* validations added (see \[http://issues.apache.org/bugzilla/show_bug.cgi?id=21282 #21282\]).
Wiki Markup - New *Minimum/Maximum* value validators added (see \[http://issues.apache.org/bugzilla/show_bug.cgi?id=29015 #29015\]).
\\
The following validator's issues have been fixed:
...
- *Email* Validator fixed for \[http://issues.apache.org/bugzilla/show_bug.cgi?id=23990 Bug 23990\], \[http://issues.apache.org/bugzilla/show_bug.cgi?id=29541 Bug 29541\], \[http://issues.apache.org/bugzilla/show_bug.cgi?id=33409 Bug 33409\], \[http://issues.apache.org/bugzilla/show_bug.cgi?id=31644 Bug 31644\]
Wiki Markup - Float* Validator fixed for \[http://issues.apache.org/bugzilla/show_bug.cgi?id=32351 Bug 32351\] and \[http://issues.apache.org/bugzilla/show_bug.cgi?id=36878 Bug 36878\]unmigrated-wiki-markup*
- Double* Validator fixed for \[http://issues.apache.org/bugzilla/show_bug.cgi?id=36878 Bug 36878\]
Wiki Markup - Credit Card* Validator fixed for \[http://issues.apache.org/bugzilla/show_bug.cgi?id=35926 Bug 35926\]
- Date Validator no longer logs the ParseException for an invalid date.
The following JavaScript validator's issues have been fixed:
...
- The Strategy for locating a form using name/id has changed to correct various issues - see \[http://issues.apache.org/bugzilla/show_bug.cgi?id=35127 Bug 35127\], \[http://issues.apache.org/bugzilla/show_bug.cgi?id=35294 Bug 35294\] and \[http://issues.apache.org/bugzilla/show_bug.cgi?id=31534 Bug 31534\]
Wiki Markup - Required* validator fixed for \[http://issues.apache.org/bugzilla/show_bug.cgi?id=15912 Bug 15912\] and \[http://issues.apache.org/bugzilla/show_bug.cgi?id=33047 Bug 33047\]unmigrated-wiki-markup*
- Date* validator enhanced to support _datePattern_ - see \[http://issues.apache.org/bugzilla/show_bug.cgi?id=22384 Bug 22384\]
\\
1.5 Dependency Changes
The following changes to validator's dependencies have occured:
Wiki Markup Wiki Markup - \[http://jakarta.apache.org/commons/collections/ Commons Collections\] - dependency removed (*see note below*).unmigrated-wiki-markup
- \[http://jakarta.apache.org/commons/digester/ Commons Digester\] - upgraded from version 1.5 to version 1.6unmigrated-wiki-markup\[http://jakarta.apache.org/commons/digester/
- Commons Logging\] - upgraded from version 1.0.3 to version 1.0.4
\\
Wiki Markup
...
2. Upgrading
This section describes upgrading from validator 1.1.4.
...
Obvious, but don't forget to deploy the new Validator 1.2.0 jar and also upgrade to new versions of dependency jars for BeanUtils, Digester and Logging (see section 1.5 above).
2.2 New DTD version
Wiki Markup
Upgrading your system to use \[http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/validator/trunk/conf/share/validator_1_2_0.dtd?view=markup validator_1_2_0.dtd\] has the following consequences:
- You will be able to use the new features that depend on the attributes that have been added to the DTD.
- If your validation.xml files uses the ar0-arg3 elements - these will need to be replaced with "arg" - see the section 1.3 Arg0-Arg3 Deprecations Removed above.
...
NOT Upgrading your system to use \[http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/validator/trunk/conf/share/validator_1_2_0.dtd?view=markup validator_1_2_0.dtd\] has the following consequences:
- You won't be able to use (some of) the new features which depend on new elements in the DTD.
...
- Validator 1.2.0 can be deployed with Struts 1.2.x to take advantage of the new features(except one, see below).
Wiki Markup - The Variables in Resource Bundles feature described in section 1.2 above does not work in Struts 1.2.x - this requires Struts 1.3
...