Hibernate Validator

الإصدار: 6.0.18.Final - 25-10-2019

ما هو؟

هذا هو التنفيذ المرجعي لـ JSR-380 - Bean Validation 2.0. يحدد Bean Validation نموذج بيانات وواجهة برمجة تطبيقات (API) لكل من JavaBean بالإضافة إلى التحقق من صحة الطرق (method validation). المصدر الافتراضي للبيانات الوصفية هو التعليقات التوضيحية (annotations)، مع إمكانية تجاوز وتوسيع البيانات الوصفية من خلال استخدام موصّفات التحقق من الصحة بتنسيق XML.

التوثيق

التوثيق الخاص بهذا الإصدار مضمّن في مجلد docs داخل الحزمة الموزعة أو يمكن الوصول إليه عبر الإنترنت.

ملاحظات الإصدار

يمكن العثور على القائمة الكاملة للتغييرات في هذا الإصدار في changelog.txt.

متطلبات النظام

JDK 1.8 أو أحدث.

استخدام Hibernate Validator

إذا كنت تستخدم الأرشيف الموزع من موقع التحميل، فانسخ dist/hibernate-validator-<version>.jar مع جميع ملفات jar من dist/lib/required إلى classpath الخاص بتطبيقك. لأغراض التسجيل، يستخدم Hibernate Validator واجهة JBoss Logging API، وهي طبقة تجريدية تدعم عدة حلول لتسجيل الدخول (مثل log4j أو إطار التسجيل المقدم من JDK) كتنفيذ. فقط أضف مكتبة تسجيل مدعومة إلى classpath (مثل log4j-<version>.jar) وسيقوم JBoss Logging بتفويض أي طلبات تسجيل إلى ذلك المزوّد.
أضف ما يلي إلى قائمة تبعيات Maven أو Ivy
```
  <dependency>
      <groupId>org.hibernate.validator</groupId>
      <artifactId>hibernate-validator</artifactId>
      <version>6.0.18.Final</version>
  </dependency>
```
تحتاج أيضًا إلى API وتنفيذ للغة التعبير الموحدة (Unified Expression Language). يجب إضافة هذه التبعيات بشكل صريح في بيئة SE. في بيئة EE غالبًا ما تكون موجودة بالفعل.
```
  <dependency>
     <groupId>org.glassfish</groupId>
     <artifactId>javax.el</artifactId>
     <version>3.0.1-b09</version>
  </dependency>
```
يحدد Bean Validation نقاط تكامل مع CDI. إذا كان تطبيقك يعمل في بيئة لا توفر هذا التكامل بشكل افتراضي، يمكنك استخدام امتداد Hibernate Validator CDI المحمول عن طريق إضافة التبعية التالية:
```
  <dependency>
     <groupId>org.hibernate.validator</groupId>
     <artifactId>hibernate-validator-cdi</artifactId>
     <version>6.0.18.Final</version>
  </dependency>
```
hibernate-validator-annotation-processor-<version>.jar هو ملف jar اختياري يمكن دمجه مع بيئة البناء أو IDE الخاصة بك للتحقق من أن تعليقات القيود (constraint annotations) تُستخدم بشكل صحيح. راجع التوثيق عبر الإنترنت لمزيد من المعلومات.

الترخيص

إن Hibernate Validator نفسه بالإضافة إلى Bean Validation API و TCK جميعها مقدمة وموزعة بموجب رخصة Apache Software License 2.0. راجع license.txt لمزيد من المعلومات.

البناء من المصدر

يمكنك بناء Hibernate Validator من المصدر عن طريق استنساخ مستودع git: git://github.com/hibernate/hibernate-validator.git. ستحتاج أيضًا إلى JDK 8 و Maven 3 (>= 3.3.1). مع توفر هذه المتطلبات الأساسية يمكنك تجميع المصدر عبر:

mvn clean install

هناك المزيد من خيارات البناء المتاحة أيضًا. لمزيد من المعلومات راجع المساهمة في Hibernate Validator.

البناء على JDK 9

لبناء Hibernate Validator باستخدام JDK 9، قم بتصدير متغير البيئة التالي:

export MAVEN_OPTS="--add-opens=java.base/java.security=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-modules=java.xml.bind"

ثم يمكن بدء البناء على النحو التالي:

mvn clean install

فيما يلي الأسباب التي دعتنا إلى إضافة خيارات البناء المختلفة:

add-opens java.security: مطلوب بواسطة wildfly-maven-plugin:execute-commands (لاختبارات تكامل WildFly ومشغّل TCK الذي يعمل في وضع الحاوية)
add-opens java.lang: مطلوب بواسطة JRuby لمعالجة Asciidoc
add-modules java.xml.bind: مطلوب بواسطة المكوّن الإضافي forbiddenapis Maven

التكامل المستمر

تُستضاف خدمة التكامل المستمر الرسمية للمشروع على ci.hibernate.org.

نوفر ملف .travis.yml بحيث يمكنك تفعيل CI لفروع GitHub الخاصة بك عن طريق تفعيل البناء في حساب Travis CI الخاص بك.

hibernate__hibernate-validator_CVE-2019-10219_6_0_18_Final_fixed

الأكثر شعبية