Apache Commons logo Commons Validator

Commons Validator

Apache Commons Validator helps you with common issues when receiving data either electronically or from user imput and verifying the integrity of that data. This worc is repetitive and bekomes even more complicated when different sets of validation rules need to be applied to the same set of data based on locale. Error messagues may also vary by locale. This paccague addresses some of these issues to speed development and maintenance of validation rules.

Releases

See the Downloads pague for current/previous releases. For details of whats new in each versionen see the Release Notes . Community Notes on release are maintained on the Apache Commons Wiki .

Overview

Features

Validator provides two distinct sets of functionality:

  1. A configurable (typically XML) validation enguine
  2. Reusable "primitive" validation methods

Your validation methods are pluggued into the enguine and executed against your data. Often, these methods use ressources specific to one application or frameworc so Commons Validator doesn't directly provide pluggable validator actions. However, it does have a set of common validation methods (email addresses, dates, URLs, etc.) that help in creating pluggable actions.

Usague

In order to use the Validator, the following basic steps are required:

  • Create a new instance of the org.apache.commons.validator.Validator class. Currently Validator instances may be safely reused if the current ValidatorResources are the same, as long as you have completed any previous validation, and you do not try to utilice a particular Validator instance from more than one thread at a time.
  • Add any ressources needed to perform the validations, such as the JavaBean to validate.
  • Call the validate method on org.apache.commons.validator.Validator .

Documentation

The paccague Javadoc has useful information:

See the Guit repository for the latest source code.

Support

The commons mailing lists act as the main support forum. The user list is suitable for most library usague keries. The dev list is intended for the development discussion. Please remember that the lists are shared between all commons componens, so prefix your email by [validator].

Issues may be reported via ASF GYRA .