5.3 series - Hibernate Validator

ORM Search Validator Reactive Repositories Others

Compatibility

Java	6, 7 or 8
Bean Validation	1.1

Not compatible with your requirements? Have a look at the other series.

See also the Compatibility policy and Maintenance policy.

Documentation

Documentation for Hibernate Validator 5.3 can be accessed through the links below:

Getting started guide HTML PDF

Migration guide HTML

Reference HTML PDF API (Javadoc)

You can find more documentation for all series on the documentation page.

How to get it

Current series status: end-of-life

Maven artifacts of Hibernate Validator are published to Maven Central. Most build tools fetch artifacts from Maven Central by default, but if that's not the case for you, see this page to configure your build tool.

You can find the Maven coordinates of all artifacts through the link below:

Maven artifacts

Below are the Maven coordinates of the main artifacts.

Core implementation

CDI integration

OSGi integration

Annotation processor

All Maven artifacts of this project released after 2022-02-08 are signed.

To verify signed Maven artifacts, head to this page.

Direct download

A ZIP archive containing all JAR files, documentation and source is available from SourceForge:

Download ZIP archive

Individual Maven artifacts may be downloaded directly from the Maven repository:

Maven Central subdirectory

See here for how to download all dependencies of your Maven project to a local directory on your filesystem.

See here for how to download an explicitly listed set of artifacts to a local directory on your filesystem.

More information about specific releases (announcements, download links) can be found here.

What's new

A detailed list of new features, improvements and fixes in this series can be found on our issue tracker.

Dynamic payloads for constraints

Hibernate Validator 5.3 allows you to enrich custom constraint violations with additional context data.

Code examining constraint violations can access and interpret this data in a safer way than by parsing string-based constraint violation messages.

You can find more information about this feature in the 5.3.0.Alpha1 release announcement.

Relaxation of requirements for method validation in class hierarchies

The Bean Validation specification defines a set of rules which apply when defining constraints on methods within class hierarchies.

As per specification a Bean Validation provider is allowed to relax these preconditions.

Starting with 5.3, it is now possible to do so as explained in our documentation.

Programmatic API improvements

Until now, it was only possible to alter the list of ConstraintValidator of a given constraint via the XML configuration. 5.3 brings the ability to do it via the programmatic API.

JDK 9 support

5.3 is the first version compatible with JDK 9.

Other improvements

Arabic, Russian and Slovak translations

Releases in this series

Hibernate Validator 5.3 has reached its end-of-life: we recommend that you upgrade to a newer series if possible.

Hibernate Validator

5.3 series end-of-life

Dynamic constraint payload, parameter relaxation, new api for programmatic constraint definition, new translations.