Skip to content

Commit

Permalink
Improve new section about Bean Validation and native executables
Browse files Browse the repository at this point in the history
  • Loading branch information
gsmet committed Jan 27, 2023
1 parent 1be06ed commit 934e026
Showing 1 changed file with 15 additions and 5 deletions.
20 changes: 15 additions & 5 deletions docs/src/main/asciidoc/validation.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -487,14 +487,24 @@ To configure the `ValidatorFactory`, use the exposed configuration properties an

Consequently, the only way to define constraints in Quarkus is by annotating your classes.

=== Native compilation
=== ValidatorFactory and native executables

Building a `Validator` using the `ValidatorFactory` is not possible in native mode. You will end in an
error similar to `javax.validation.NoProviderFoundException: Unable to create a Configuration, because no
Quarkus provides a default `ValidatorFactory` that you can customize using configuration properties.
This `ValidatorFactory` is carefully initialized to support native executables
using a bootstrap that is Quarkus-specific.

Creating a `ValidatorFactory` by yourself it not supported in native executables
and if you try to do so,
you will get an error similar to `javax.validation.NoProviderFoundException: Unable to create a Configuration, because no
Jakarta Bean Validation provider could be found. Add a provider like Hibernate Validator (RI) to your
classpath.`
classpath.` when running your native executable.

Thus why you should always use the Quarkus-managed `ValidatorFactory` by injecting an instance of
`ValidatorFactory` or directly an instance of `Validator` using CDI injection.

Always use an injected `Validator`. If you have to configure the `ValidatorFactory` follow the guide at
To support some external libraries that are creating a `ValidatorFactory` using the default bootstrap,
Quarkus returns the `ValidatorFactory` managed by Quarkus when `Validation.buildDefaultValidatorFactory()`
is called.

[[configuration-reference]]
== Hibernate Validator Configuration Reference
Expand Down

0 comments on commit 934e026

Please sign in to comment.