خادم التطبيقات WildFly

http://wildfly.org

• بدء تشغيل سريع
• بصمة صغيرة
• تصميم نمطي
• تهيئة وإدارة موحّدة

وبالطبع Java EE7!

البناء

المتطلبات الأساسية:

• JDK 8 أو أحدث - تحقق عبر java -version
• Maven 3.3.1 أو أحدث - تحقق عبر mvn -v
• في أنظمة *nix، تأكد من أن الحد الأقصى لعدد الملفات المفتوحة للمستخدم الذي ينفّذ البناء هو 4096 على الأقل (تحقق من ulimit -n) أو أكثر، اعتمادًا على العمليات الأخرى كثيفة الإدخال/الإخراج التي يشغّلها المستخدم.

للبناء باستخدام تثبيت Maven الخاص بك:

mvn install

بدلاً من ذلك، يمكنك استخدام سكربت Maven Wrapper الذي يقوم بتنزيل وتثبيت (إذا لزم الأمر) إصدار Maven المطلوب إلى ~/.m2/wrapper وتشغيله من هناك. على Linux، شغّل

./mvnw install

أما على Windows

mvnw install

بدء وإيقاف WildFly

بعد بناء ناجح، انتقل إلى دليل bin

$ cd build/target/wildfly-[version]/bin

شغّل الخادم في وضع النطاق (domain mode)

./domain.sh

شغّل الخادم في الوضع المستقل (standalone mode)

./standalone.sh

لإيقاف الخادم، اضغط Ctrl + C، أو استخدم وحدة التحكم الإدارية

./jboss-cli.sh --connect command=:shutdown

لمزيد من المعلومات: https://docs.jboss.org/author/display/WFLY10/Getting+Started+Guide

المساهمة

https://developer.jboss.org/wiki/HackingOnWildFly

دليلا Build و Dist

بعد تشغيل mvn install، سيكون WildFly متاحًا في دليلين مختلفين هما build و dist.

• يحتوي الدليل build على بناء لـ WildFly يعتمد على حلّ مكونات Maven (artifact resolution) لتهيئة الوحدات
• أما الدليل dist فيحتوي على بناء كامل قابل للتوزيع لـ WildFly

استخدام الدليل build يجعل التكرار في تطوير الأنظمة الفرعية (subsystem) أو الوحدات أسهل، إذ لا حاجة إلى إعادة بناء WildFly بالكامل أو نسخ ملفات JAR في كل تغيير.

الدليل dist أكثر ملاءمة عندما تكون هناك حاجة إلى بناء كامل لـ WildFly لأغراض التطوير أو الاختبار.

تشغيل مجموعة الاختبارات

تحتوي وحدة testsuite على عدة وحدات فرعية، منها:

• "smoke" -- اختبارات أساسية يجب تشغيلها كجزء من كل بناء لخادم التطبيقات (AS). أي فشل هنا سيؤدي إلى فشل البناء.
• "api" -- اختبارات للميزات التي تتضمن استخدام المستخدم النهائي لواجهة API العامة لـ JBoss AS 8. يجب تشغيلها دون أي فشل قبل أي commits رئيسية.
• "cluster" -- اختبارات لميزات التجميع عالي التوافر (HA clustering) في WildFly. يجب تشغيلها دون أي فشل قبل أي commits رئيسية.
• "domain" -- اختبارات لميزات إدارة النطاق (domain). يجب تشغيلها دون أي فشل قبل أي commits رئيسية.
• "integration" -- اختبارات للبنية الداخلية لخادم WildFly المستقل (standalone). يجب تشغيلها دون أي فشل قبل أي commits رئيسية.
• "spec" -- اختبارات للميزات التي تتضمن فقط استخدام المستخدم النهائي لواجهات برمجة التطبيقات (APIs) الخاصة بمواصفات Java EE 7. يجب تشغيلها دون أي فشل قبل أي commits رئيسية.

لاختبارات smoke الأساسية، فقط: mvn test

لتشغيل جميع الاختبارات

mvn install -DallTests

استخدام Eclipse

1. ثبّت أحدث إصدار من Eclipse
2. تأكد من أن قيمة Xmx في ملف eclipse.ini لا تقل عن 1280M، وأنه يستخدم Java 8
3. شغّل Eclipse وثبّت المكوّن الإضافي m2e، وتأكد من أنه يستخدم إعدادات المستودعات الخاصة بك (احصل عليه من: http://www.eclipse.org/m2e/ أو ثبّت "Maven Integration for Eclipse" من Eclipse Marketplace)
4. في تفضيلات Eclipse، انتقل إلى Java->Compiler->Errors/Warnings->Deprecated and restricted واضبط خيار forbidden reference على WARNING
5. في تفضيلات Eclipse، انتقل إلى Java->Code Style، واستورد إعدادات التنظيف (cleanup) والقوالب (templates) والتنسيق (formatter) الموجودة في ide-configs/eclipse داخل مستودع wildfly-core.
6. في تفضيلات Eclipse، انتقل إلى Java->Editor->Save Actions، وفعّل "Additional Actions"، وألغِ تحديد جميع الإجراءات باستثناء "Remove trailing whitespace"
7. استخدم الاستيراد على ملف pom الجذر، والذي سيجلب جميع الوحدات
8. انتظر (يستغرق m2e بعض الوقت عند الاستيراد الأول)

الرخصة

• GNU Lesser General Public License Version 2.1