##### Validator

- Overview
- Download
- Documentation
  - Release Notes
  - Dependencies
  - License
  - Framework
  - Routines
  - Wiki
- JavaDocs
  - Current Release
  - 1.3.0 Release
  - 1.2.0 Release
  - 1.1.4 Release
  - 1.0.2 Release
- JavaScript Doc

##### Development

- Mailing Lists
- Issue Tracking
- Latest JavaDoc
- Source Repository
- Building

##### Project Documentation

- About
- Project Info
- Project Reports
- Development Process

##### Commons

- Home
- Components
- Sandbox
- Dormant
- Volunteering
- Contributing Patches
- Building Components
- Releasing Components
- Wiki

##### Legend

- External Link
- Opens in a new window

## Commons Validator

A common issue when receiving data either electronically or from user input is verifying the integrity of the data. This work is repetitive and becomes even more complicated when different sets of validation rules need to be applied to the same set of data based on locale. Error messages may also vary by locale. This package addresses some of these issues to speed development and maintenance of validation rules.

## Releases

See the Downloads page for current/previous releases.

For details of whats new in each version see the Release Notes.

Community Notes on release are maintained on the Jakarta Commons Wiki.

## Overview

### Features

Validator provides two distinct sets of functionality:

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

Your validation methods are plugged into the engine and executed against your data. Often, these methods use resources specific to one application or framework 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.

### Usage

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 utilize a particular Validator instance from more than one thread at a time.
- Add any resources needed to perform the validations, such as the JavaBean to validate.
- Call the validate method on `org.apache.commons.validator.Validator`.

## Documentation

The package JavaDoc has useful information:

- Validator Framework
- Routines package

The following versions of the JavaDoc API documents are available online:

- The Current Release
- The Version 1.3.0
- The Version 1.2.0
- The Version 1.1.4
- The Version 1.0.2
- The latest SVN

The subversion repository can be browsed.

## Support

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

Issues may be reported via ASF JIRA.