
Referenzimplementierung von Bean Validation 2.0 (JSR-380) mit annotierungsbasiertem Metadatenmodell und Methodenvalidierung für JavaBeans, einschließlich eines CVE-2019-10219-Fixes.
Version: 6.0.18.Final - 25-10-2019
Dies ist die Referenzimplementierung von JSR-380 - Bean Validation 2.0. Bean Validation definiert ein Metadatenmodell und eine API für JavaBeans sowie Methodenvalidierung. Die Standard-Metadatenquelle sind Annotationen; die Metadaten können überschrieben und erweitert werden mithilfe von XML-Validierungsdeskriptoren.
Die Dokumentation für diese Version ist im docs-Verzeichnis des Distributionspakets enthalten oder kann online abgerufen werden.
Die vollständige Liste der Änderungen für diese Version finden Sie in 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 dist/lib/required in den Klassenpfad Ihrer Anwendung. Für die Protokollierung verwendet Hibernate Validator die JBoss-Logging-API, eine Abstraktionsschicht, die mehrere Protokollierungslösungen wie (z. B. log4j oder das vom JDK bereitgestellte Protokollierungs-Framework) als Implementierung unterstützt. Fügen Sie einfach eine unterstützte Protokollierungsbibliothek zum Klassenpfad hinzu (z. B. ) und JBoss Logging leitet alle Protokollanforderungen an diesen Anbieter weiter.
Fügen Sie Ihrer Maven- oder Ivy-Abhängigkeitsliste Folgendes hinzu:
<dependency>
<groupId>org.hibernate.validator</groupId>
<artifactId>hibernate-validator</artifactId>
<version>6.0.18.Final</version>
</dependency>
Sie benötigen außerdem eine API und eine 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 portable Hibernate-Validator-CDI-Erweiterung verwenden, indem Sie die folgende Abhängigkeit hinzufügen:
<dependency>
<groupId>org.hibernate.validator</groupId>
<artifactId>hibernate-validator-cdi</artifactId>
<version>6.0.18.Final</version>
</dependency>
hibernate-validator-annotation-processor-<version>.jar ist eine optionale JAR-Datei, die in Ihre Build-Umgebung bzw. IDE integriert werden kann, um zu überprüfen, ob Einschränkungsannotationen korrekt verwendet werden. Siehe Online- Dokumentation für weitere Informationen.
Hibernate Validator selbst sowie die Bean-Validation-API und der TCK werden unter der Apache Software License 2.0 bereitgestellt und verteilt. Weitere Informationen finden Sie in 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 ein JDK 8 und Maven 3 (>= 3.3.1). Mit diesen Voraussetzungen können Sie den Quellcode wie folgt kompilieren:
mvn clean install
Es sind auch weitere Build-Optionen verfügbar. Weitere Informationen finden Sie unter Mitwirken an 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"
Danach 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 Dienst für kontinuierliche Integration des Projekts wird auf ci.hibernate.org gehostet.
Wir stellen eine .travis.yml-Datei bereit, damit Sie CI für Ihren GitHub-Fork aktivieren können, indem Sie den Build in Ihrem Travis-CI-Konto aktivieren.