Version: 4.3.0.Alpha1, 06.03.2011
What is it?
This is the reference implementation of JSR 303 - Bean Validation. Bean Validation defines a metadata model and API for JavaBean validation. The default metadata source is annotations, with the ability to override and extend the meta-data through the use of XML validation descriptors.
A bit of history
Prior to version 4.x Hibernate Validators was based on a different source base which is not based on JSR 303. This code can be accessed via this GitHub tag.
The documentation for this release is included in the docs directory of distribution package or can be accessed online.
The full list of changes for this release can be found in changelog.txt.
JDK 1.5 or above.
Using Hibernate Validator
- In case you use the distribution archive from the download site, copy dist/hibernate-validator-.jar together with all jar files from dist/lib/required into the classpath of your application. You can switch the slf4j binding jars for log4j (log4j-.jar and slf4j-log4j12-.jar) with the slf4j binding files of your choice. See http://www.slf4j.org/manual.html In case you are using Java 5 you have to also include all the jar files from the dist/lib/jdk5 directory. The jar files contain the classes needed for JAXB. If you don't use the xml configuration and XML configuration is disabled via Configuration.ignoreXmlConfiguration the jar files from the dist/lib/jdk5 directory don't have to be added.
Add the following to your maven or ivy dependency list (Hibernate Validator can be found in the JBoss Maven repository):
<dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>4.3.0.Alpha1</version> </dependency>
hibernate-validator-annotation-processor-.jar is an optional jar which can be integrated with your build environment respectively IDE to verify that constraint annotations are correctly used. Refer to the online documentation for more information.
Hibernate Validator itself as well as the Bean Validation API and TCK are all provided and distributed under the Apache Software License 2.0. Refer to license.txt for more information.
Build from Source
You can build Hibernate Validator from source by cloning the git repository git://github.com/hibernate/hibernate-validator.git You will also need a JDK 6 or 7 and a Maven 3. With these prerequisites in place you can compile the source via
mvn clean install -s settings-example.xml
The documentation module requires an additional tool called po2xml. If you don't have po2xml installed you can skip the building of the documentation via:
mvn clean install -DdisableDocumentationBuild=true -s settings-example.xml
There are more build options available as well. For more information refer to Contributing to Hibernate Validator.