
تنفيذ مرجعي لـ Bean Validation 2.0 (JSR-380) يوفر نموذج بيانات ووصف API للتحقق من JavaBean والطرق مع دعم واصفات XML.
الإصدار: 6.0.17.Final - 13-06-2019
هذا هو التطبيق المرجعي لـ JSR-380 - Bean Validation 2.0. يعرّف Bean Validation نموذج بيانات وواجهة برمجة تطبيقات (API) لـ JavaBean بالإضافة إلى التحقق من الأساليب. المصدر الافتراضي للبيانات الوصفية هو التعليقات التوضيحية، مع إمكانية تجاوز البيانات الوصفية وتوسيعها من خلال استخدام واصفات التحقق بتنسيق XML.
وثائق هذا الإصدار مضمنة في دليل docs الخاص بحزمة التوزيع، أو يمكن الوصول إليها عبر الإنترنت.
يمكن العثور على القائمة الكاملة للتغييرات في هذا الإصدار في ملف changelog.txt.
JDK 1.8 أو أحدث.
في حال استخدامك أرشيف التوزيع من موقع التنزيل، انسخ dist/hibernate-validator-<version>.jar مع جميع ملفات jar من dist/lib/required إلى مسار classpath الخاص بتطبيقك. لأغراض تسجيل الأحداث، يستخدم Hibernate Validator واجهة برمجة تطبيقات JBoss Logging، وهي طبقة تجريد تدعم العديد من حلول التسجيل مثل (على سبيل المثال log4j أو إطار التسجيل المقدم من JDK) كتطبيق. فقط أضف مكتبة تسجيل مدعومة إلى classpath (مثل ) وسيقوم JBoss Logging بتفويض جميع طلبات التسجيل إلى هذا المزوّد.
أضف ما يلي إلى قائمة تبعيات Maven أو Ivy الخاصة بك:
<dependency>
<groupId>org.hibernate.validator</groupId>
<artifactId>hibernate-validator</artifactId>
<version>6.0.17.Final</version>
</dependency>
تحتاج أيضًا إلى واجهة برمجة تطبيقات وتنفيذ للغة التعبير الموحدة. يجب إضافة هذه التبعيات بشكل صريح في بيئة 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.17.Final</version>
</dependency>
hibernate-validator-annotation-processor-<version>.jar هو ملف jar اختياري يمكن دمجه مع بيئة البناء أو بيئة التطوير المتكاملة (IDE) الخاصة بك للتحقق من أن تعليقات القيود تُستخدم بشكل صحيح. راجع الوثائق عبر الإنترنت لمزيد من المعلومات.
يتم توفير Hibernate Validator نفسه بالإضافة إلى واجهة برمجة تطبيقات Bean Validation ومجموعة أدوات 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.
لبناء 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
فيما يلي أسباب إضافة خيارات البناء المختلفة:
يتم استضافة خدمة التكامل المستمر الرسمية للمشروع على ci.hibernate.org.
نوفر ملف .travis.yml لك لتتمكن من تفعيل CI لفرعك على GitHub عن طريق تفعيل البناء في حساب Travis CI الخاص بك.