We just released the 6.0.5.Final version of Hibernate Validator containing a couple of important bugfixes and some enhancements.
This is a recommended upgrade for everyone using Hibernate Validator 6.0.x and it is a drop-in replacement of 6.0.4.Final.
What’s new
Bugfixes
Marko noticed an annoying regression potentially leading to random ClassCastException.
It was introduced in one of the performance patches of 6.0.3.Final.
It may not affect you if you only validate a few objects with a few properties at once (that’s why we didn’t notice it in our test suite) but it definitely makes this upgrade important for everyone.
We also fixed another issue concerning the @Email validator:
it was reporting emails with an IDN ASCII domain (the ones starting with xn--) as invalid, whereas they are perfectly valid. Thanks to Andreas Marienborg for reporting this one.
Enhancements
@UniqueElements constraint
Tadhg Pearson contributed a new constraint: @UniqueElements.
The purpose of this constraint is to raise a violation if there are duplicate elements in a collection.
@UniqueElements
private List<MyBean> beans;Consider the case where you use JAX-RS to deserialize XML and JSON beans and Hibernate Validator to validate their content.
XML and JSON collections are transformed into Lists.
If you then transform them to a Set, the duplicate elements will be silently discarded, whereas this might not be what you want.
The purpose of this constraint is for Hibernate Validator to be able to raise a violation if the input list contains duplicate elements.
Temporal validation tolerance
Daniel Wegener came to us with a very interesting requirement:
in distributed systems, you might have a slight delay between getting the current instant and validating it (think of generating the object on the client and then sending it to a backend server for validation).
In this case, it is very probable your temporal constraints (e.g. @Future or @Past) will fail.
He came with the idea of introducing a tolerance for temporal validation at the constraint level and we finally decided it was better to make it a global configuration knob.
Thus, you can now define a temporal validation tolerance when you initialize your ValidationFactory:
ValidatorFactory validatorFactory = Validation.byProvider( HibernateValidator.class )
.configure()
.temporalValidationTolerance( Duration.ofMillis( 10 ) )
.buildValidatorFactory();
Validator validator = validatorFactory.getValidator();See our reference documentation for more information about this new feature.
New HibernateConstraintValidator contract
Until now, the only parameter available via ConstraintValidator#initialize() was the constraint annotation.
It was a bit limiting as, for some of our validators, we needed additional helpers and access to some of the configuration properties.
We created the HibernateConstraintValidator contract to alleviate this limitation: it introduces an initialize() method taking a ConstraintDescriptor and a HibernateConstraintValidatorInitializationContext, giving access to, for instance, the clock provider.
This contract is marked as incubating. Our ultimate goal is to include it in a future revision of Bean Validation.
Translation updates
The Simplified Chinese translation was updated by Yanming Zhou.
Full changelog
The complete list of fixed issues can be found on our JIRA.
Getting 6.0.5.Final
To get the release with Maven, Gradle etc. use the GAV coordinates org.hibernate.validator:{hibernate-validator|hibernate-validator-cdi|hibernate-validator-annotation-processor}:6.0.5.Final. Note that the group id has changed from org.hibernate (Hibernate Validator 5 and earlier) to org.hibernate.validator (from Hibernate Validator 6 onwards).
Alternatively, a distribution bundle containing all the bits is provided on SourceForge (TAR.GZ, ZIP).
If you want to benefit from the new features of this version on WildFly, we also provide WildFly patches for WildFly 10.1 and WildFly 11.0 (wait for the synchronization to Maven Central). You can read about how to apply such patches here.
What’s next?
We will continue to release maintenance releases to fix quickly the issues reported by our users.
We updated our roadmap with the ideas we have for the future. If you want to join us, don’t hesitate to pick a task and come discuss it with us.
Feedback, issues, ideas?
To get in touch, use the usual channels:
-
hibernate-validator tag on Stack Overflow (usage questions)
-
User forum (usage questions, general feedback)
-
Issue tracker (bug reports, feature requests)
-
Mailing list (development-related discussions)
-
Bean Validation development mailing list (discussions about the Bean Validation specification)
