Hibernate Validator

9.0 series development

This series targets Jakarta EE 11. It implements Jakarta Validation 3.1. New constraints: @KorRRN, @BitcoinAddress, removal of the Security Manager integration, BOM for simpler dependency management, dependency updates, improvements and bug fixes.

Hibernate Validator 9.0 is still in development:

  • some features may be incomplete;

  • newly introduced features may change in a backward-incompatible way before the stable release.

We encourage you to give it a try and to let us know of any bugs or problems you encounter.

Compatibility

Java 17, 21, 22 or 23
Jakarta Bean Validation 3.1
Jakarta EE 11

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 9.0 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: development

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.

org.hibernate.validator:hibernate-validator-bom:9.0.0.CR1
BOM to help manage published Hibernate Validator artifacts
org.hibernate.validator:hibernate-validator:9.0.0.CR1
Core implementation
org.hibernate.validator:hibernate-validator-cdi:9.0.0.CR1
CDI integration
org.hibernate.validator:hibernate-validator-annotation-processor:9.0.0.CR1
Annotation processor
org.hibernate.validator:hibernate-validator-test-utils:9.0.0.CR1
Set of test utilities that can help testing custom constraints.

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

Latest release announcement (2024-12-13): 9.0.0.CR1.

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

Jakarta EE 11

Hibernate Validator 9.0 is targeted to be the reference implementation for Jakarta Bean Validation 3.1 in Jakarta EE 11.

Upgrade to Hibernate Validator 9 is required if you are moving to Jakarta EE 11.

With Jakarta EE 11 upgrade the minimum required Java version is 17.

New constraints

This release also brings new constraints.

Country-specific South Korean RRN constraint

The new constraint @KorRRN was added to validate the Korean resident registration numbers.

Bitcoin address constraint

The new @BitcoinAddress constraint was added to validate whether BTC (Bitcoin) addresses are well-formed.

Alphanumeric CNPJ

A new configuration option was added to the @CNPJ constraint to allow validating the upcoming alphanumeric format of the number.

Hibernate Validator BOM

Hibernate Validator now offers a BOM providing dependency management for all of its published artifacts. It can be imported as part of your dependency management to keep the versions of Hibernate Validator artifacts aligned.

Removal of the Security Manager integration

With the security manager being deprecated without an alternative for some time now, we took the opportunity provided by the specification requirement of the minimum Java version to remove the integration of the Security Manager from Hibernate Validator.

Removal of the deprecated constraints, configuration properties and methods

With the new major release of Hibernate Validator some of the constraints, configuration properties, and public API methods/classes that have been deprecated for a few major versions now are removed. For a detailed list of removed deprecated items see the migration guide.

OSGi integration

Starting with Hibernate Validator 9.0, the Hibernate team no longer tests nor maintains the OSGi integration. For users who would want to experiment with Hibernate Validator in an OSGi environment, we will keep the existing manifest entries in place as they were.

Even though we no longer maintain the Hibernate Validator OSGi integration, we do encourage the community members interested in it to come forward with pull requests if they encounter some issues. In such a case, we will try to guide the submitter through the contribution process and assess the suggested patch for inclusion in the build.

Development versions (SNAPSHOTS)

The latest development versions of Maven artifacts for Hibernate Validator are published to the OSSRH snapshots repository.

OSSRH snapshots subdirectory

You should only need those (unstable) versions for testing recently merged patches, and should never use them in production.

To consume these artifacts, you may need to configure your build tool to fetch artifacts from http://oss.sonatype.org/content/repositories/snapshots and to enable snapshots:

Maven Gradle

Releases in this series

9.0.0.CR1

2024-12-13

ASL v2

A few dependency updates, some bug fixes and more translations of validation messages.

How to get it

Maven artifacts Download Resolved issues Release announcement

9.0.0.Beta3

2024-09-04

ASL v2

More removals of deprecated methods and constraints, clarification on stopping OSGi integration testing, a couple improvements and fixes identified while testing the previous beta release against downstream projects.

Maven artifacts Download Resolved issues Release announcement

9.0.0.Beta2

2024-08-01

ASL v2

This series targets Jakarta EE 11. It implements Jakarta Validation 3.1. New constraints: @KorRRN, @BitcoinAddress, removal of the Security Manager integration, BOM for simpler dependency management, dependency updates, improvements and bug fixes.

Maven artifacts Download Resolved issues Release announcement

Back to top