
Referenzimplementierung der Bean Validation 2.0 (JSR-380), die ein annotierungsgesteuertes Metadatenmodell und eine API für die Validierung von JavaBeans und Methoden mit XML-Deskriptor-Unterstützung bereitstellt.
Version: 6.0.17.Final - 13-06-2019
Dies ist die Referenzimplementierung von JSR-380 - Bean Validation 2.0. Bean Validation definiert ein Metadatenmodell und eine API für JavaBeans sowie die Methodenvalidierung. Die Standard-Metadatenquelle sind Annotationen, mit der Möglichkeit, die Metadaten durch die Verwendung von XML-Validierungsdeskriptoren zu überschreiben und zu erweitern.
Die Dokumentation für dieses Release ist im docs-Verzeichnis des Distributionspakets enthalten oder kann online abgerufen werden.
Die vollständige Liste der Änderungen für dieses Release finden Sie in der changelog.txt.
JDK 1.8 oder höher.
Falls Sie das Distributionsarchiv von der Download-Seite verwenden, kopieren Sie dist/hibernate-validator-<version>.jar zusammen mit allen jar-Dateien aus in den Klassenpfad Ihrer Anwendung. Zu Protokollierungszwecken verwendet Hibernate Validator die JBoss Logging API, eine Abstraktionsschicht, die mehrere Protokollierungslösungen wie (z.B. log4j oder das Protokollierungsframework des JDK) als Implementierung unterstützt. Fügen Sie einfach eine unterstützte Protokollierungsbibliothek zum Klassenpfad hinzu (z.B. ), und JBoss Logging wird alle Protokollierungsanfragen an diesen Anbieter delegieren.
Fügen Sie Folgendes zu Ihrer Maven- oder Ivy-Abhängigkeitsliste hinzu
<dependency>
<groupId>org.hibernate.validator</groupId>
<artifactId>hibernate-validator</artifactId>
<version>6.0.17.Final</version>
</dependency>
Sie benötigen außerdem eine API und Implementierung der Unified Expression Language. Diese Abhängigkeiten müssen in einer SE-Umgebung explizit hinzugefügt werden. In einer EE-Umgebung sind sie oft bereits vorhanden.
<dependency>
<groupId>org.glassfish</groupId>
<artifactId>javax.el</artifactId>
<version>3.0.1-b09</version>
</dependency>
Bean Validation definiert Integrationspunkte mit CDI. Wenn Ihre Anwendung in einer Umgebung läuft, die diese Integration nicht von Haus aus bereitstellt, können Sie die Hibernate Validator CDI Portable Extension verwenden, indem Sie die folgende Abhängigkeit hinzufügen:
<dependency>
<groupId>org.hibernate.validator</groupId>
<artifactId>hibernate-validator-cdi</artifactId>
<version>6.0.17.Final</version>
</dependency>
hibernate-validator-annotation-processor-<version>.jar ist ein optionales JAR, das in Ihre Build-Umgebung bzw. IDE integriert werden kann, um zu überprüfen, ob Einschränkungsannotationen korrekt verwendet werden. Weitere Informationen finden Sie in der Online-Dokumentation.
Hibernate Validator selbst sowie die Bean Validation API und der TCK werden alle unter der Apache Software License 2.0 bereitgestellt und verteilt. Weitere Informationen finden Sie in der license.txt.
Sie können Hibernate Validator aus dem Quellcode erstellen, indem Sie das Git-Repository git://github.com/hibernate/hibernate-validator.git klonen. Sie benötigen außerdem JDK 8 und Maven 3 (>= 3.3.1). Mit diesen Voraussetzungen können Sie den Quellcode kompilieren via:
mvn clean install
Es stehen auch weitere Build-Optionen zur Verfügung. Weitere Informationen finden Sie unter Contributing to Hibernate Validator.
Um Hibernate Validator mit JDK 9 zu erstellen, exportieren Sie die folgende Umgebungsvariable:
export MAVEN_OPTS="--add-opens=java.base/java.security=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-modules=java.xml.bind"
Dann kann der Build wie folgt gestartet werden:
mvn clean install
Hier sind die Gründe, warum wir die verschiedenen Build-Optionen hinzugefügt haben:
Der offizielle Continuous-Integration-Dienst für das Projekt wird auf ci.hibernate.org gehostet.
Wir stellen eine .travis.yml-Datei zur Verfügung, damit Sie CI für Ihren GitHub-Fork aktivieren können, indem Sie den Build in Ihrem Travis CI-Konto aktivieren.