Hibernate Validator - Bean Validation 2.0 (JSR 380) Reference Implementation
Java Other
Clone or download
Permalink
Failed to load latest commit information.
annotation-processor HV-1629 Fix deprecation compiler warnings Jun 14, 2018
build-config HV-1577 Removed JAXB related code Apr 4, 2018
cdi HV-1645 Revert "HV-1609 Change how we filter which beans to process i… Aug 10, 2018
distribution HV-1644 Avoid having JavaFX as a transitive dependency Aug 10, 2018
documentation HV-1644 Avoid having JavaFX as a transitive dependency Aug 10, 2018
engine HV-1644 Avoid having JavaFX as a transitive dependency Aug 10, 2018
integration HV-1648 Reenable WildFly integration tests for JDK 11 Aug 10, 2018
jqassistant HV-1519 Exclude the test classes from the jqassistant rules Nov 3, 2017
modules HV-1617 Remove JDK 9 JVM arguments that are now useless for patch-gen Jun 7, 2018
osgi HV-1628 Remove more calls deprecated by JDK 10 Jul 13, 2018
performance HV-1628 Fix a hidden usage of String.format() Jun 15, 2018
relocation Prepare master for 6.1 developments Apr 4, 2018
src/main/scripts HV-1535 Use the default Javadoc stylesheet Dec 8, 2017
tck-runner HV-1647 Allow running TCK tests in container mode with JDK 11 Aug 10, 2018
test-utils HV-1623 Build abstraction over reflection in ConstraintLocation and r… Jun 11, 2018
.gitattributes HV-760 Adding .gitattributes to ensure consistent line ending style May 2, 2013
.gitignore Add the Maven wrapper files to .gitignore Mar 7, 2018
.travis.yml HV-1549 Use mvn install instead of mvn verify in the Travis build Dec 21, 2017
CONTRIBUTING.md HV-1464 Remove requirement for CLA Aug 29, 2017
README.md [Jenkins release job] README.md updated by release build 6.0.12.Final Aug 10, 2018
changelog.txt [Jenkins release job] changelog.txt updated by release build 6.0.10.F… May 15, 2018
copyright.txt HV-1534 Add Rob Dickinson to copyright.txt May 10, 2018
dco.txt HV-1464 Remove requirement for CLA Aug 29, 2017
license.txt BVAL-31 refactored some code, imported AnnotationFactory from annotat… Jan 7, 2009
pom.xml HV-1649 Upgrade to Bean Validation TCK 2.0.4.Final Aug 10, 2018
settings-example.xml HV-1187 Only use Groovy 2.4.8-SNAPSHOT for JDK 9 Dec 17, 2016

README.md

Hibernate Validator

Version: 6.0.12.Final - 10-08-2018

What is it?

This is the reference implementation of JSR-380 - Bean Validation 2.0. Bean Validation defines a metadata model and API for JavaBean as well as method validation. The default metadata source are annotations, with the ability to override and extend the meta-data through the use of XML validation descriptors.

Documentation

The documentation for this release is included in the docs directory of the distribution package or can be accessed online.

Release Notes

The full list of changes for this release can be found in changelog.txt.

System Requirements

JDK 1.8 or above.

Using Hibernate Validator

  • In case you use the distribution archive from the download site, copy dist/hibernate-validator-<version>.jar together with all jar files from dist/lib/required into the classpath of your application. For the purposes of logging, Hibernate Validator uses the JBoss Logging API, an abstraction layer which supports several logging solutions such (e.g. log4j or the logging framework provided by the JDK) as implementation. Just add a supported logging library to the classpath (e.g. log4j-<version>.jar) and JBoss Logging will delegate any log requests to that provider.

  • Add the following to your Maven or Ivy dependency list

      <dependency>
          <groupId>org.hibernate.validator</groupId>
          <artifactId>hibernate-validator</artifactId>
          <version>6.0.12.Final</version>
      </dependency>
    

    You also need an API and implementation of the Unified Expression Language. These dependencies must be explicitly added in an SE environment. In an EE environment they are often already provided.

      <dependency>
         <groupId>org.glassfish</groupId>
         <artifactId>javax.el</artifactId>
         <version>3.0.1-b09</version>
      </dependency>
    
  • Bean Validation defines integration points with CDI. If your application runs in an environment which does not provide this integration out of the box, you may use the Hibernate Validator CDI portable extension by adding the following dependency:

      <dependency>
         <groupId>org.hibernate.validator</groupId>
         <artifactId>hibernate-validator-cdi</artifactId>
         <version>6.0.12.Final</version>
      </dependency>
    
  • hibernate-validator-annotation-processor-<version>.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.

Licensing

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 8 and Maven 3 (>= 3.3.1). With these prerequisites in place you can compile the source via:

mvn -s settings-example.xml clean install

There are more build options available as well. For more information refer to Contributing to Hibernate Validator.

Continuous Integration

The official Continuous Integration service for the project is hosted on ci.hibernate.org.

We provide a .travis.yml file so that you can enable CI for your GitHub fork by enabling the build in your Travis CI account.

Hibernate Validator URLs