أقسام الوصول السريع (مربع البحث)

📁 آخر الأخبار

نشر تطبيق Java EE على WebLogic خطوة بخطوة (WAR / EAR)


يعد Oracle WebLogic Server من أشهر خوادم التطبيقات (Application Servers) المستخدمة لتشغيل تطبيقات Java EE / Jakarta EE في البيئات المؤسسية. يتميز WebLogic بالاعتمادية العالية، وإدارة الموارد، ودعم المعاملات، والتكامل القوي مع منتجات Oracle الأخرى. في هذا المقال سنستعرض بشكل عملي ومفصل كيفية نشر تطبيق Java EE على WebLogic باستخدام حزم WAR و EAR، مع شرح الخطوات الأساسية من الإعداد وحتى التحقق من نجاح النشر.

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

قبل البدء بعملية النشر، يجب التأكد من توفر المتطلبات التالية:

  1. Java Development Kit (JDK)

    • يوصى باستخدام إصدار مدعوم من Oracle JDK أو OpenJDK ومتوافق مع إصدار WebLogic.

  2. Oracle WebLogic Server

    • تثبيت WebLogic Server (مثلاً 12c أو 14c).

    • التأكد من إنشاء Domain وتشغيل Admin Server بنجاح.

  3. تطبيق Java EE جاهز للنشر

    • إما تطبيق ويب بصيغة WAR.

    • أو تطبيق مؤسسي بصيغة EAR يحتوي على عدة وحدات (WAR, EJB, JAR).

  4. أداة بناء (Build Tool)

    • مثل Maven أو Gradle أو Ant لتجميع المشروع وإنتاج ملف WAR أو EAR.

ثانياً: الفرق بين WAR و EAR

قبل الدخول في خطوات النشر، من المهم فهم الفرق بين نوعي الحزم:

  • WAR (Web Application Archive)

    • يُستخدم لتطبيقات الويب فقط (Servlets, JSP, JSF).

    • يحتوي عادةً على المجلدات: WEB-INF, classes, lib.

  • EAR (Enterprise Application Archive)

    • يُستخدم للتطبيقات المؤسسية الكبيرة.

    • يمكن أن يحتوي على عدة وحدات مثل:

      • WAR (تطبيق ويب)

      • EJB JAR (منطق الأعمال)

      • JAR (مكتبات مشتركة)

WebLogic يدعم النوعين، ويعتمد الاختيار على بنية التطبيق وتعقيده.

ثالثاً: تجهيز التطبيق للنشر

1. إعداد ملفات التهيئة (Deployment Descriptors)

  • بالنسبة لـ WAR:

    • ملف web.xml داخل WEB-INF.

    • ملف خاص بـ WebLogic مثل weblogic.xml (اختياري لكنه شائع).

  • بالنسبة لـ EAR:

    • ملف application.xml داخل مجلد META-INF.

    • ملفات WebLogic مثل weblogic-application.xml.

تُستخدم هذه الملفات لتحديد إعدادات مثل:

  • اسم التطبيق.

  • سياق التطبيق (Context Root).

  • إعدادات الأمان وربط الموارد (Data Sources, JMS).

2. بناء التطبيق (Build)

باستخدام Maven على سبيل المثال:

  • لتطبيق WAR:

    mvn clean package
    

    سينتج ملف مثل:

    myapp.war
    
  • لتطبيق EAR:

    mvn clean install
    

    سينتج ملف:

    myenterprise.ear
    

رابعاً: تشغيل WebLogic Admin Server

  1. الانتقال إلى مجلد الـ Domain.

  2. تشغيل الخادم:

    • على Windows:

      startWebLogic.cmd
      
    • على Linux:

      ./startWebLogic.sh
      
  3. التأكد من ظهور رسالة تفيد بأن الخادم يعمل على المنفذ الافتراضي (7001).

بعد ذلك يمكن الوصول إلى وحدة التحكم (Admin Console) عبر المتصفح:

http://localhost:7001/console

خامساً: نشر تطبيق WAR أو EAR باستخدام Admin Console

1. تسجيل الدخول

  • إدخال اسم المستخدم وكلمة المرور الخاصة بالـ Admin.

2. بدء عملية النشر

  1. من القائمة الجانبية اختر Deployments.

  2. اضغط على Install.

  3. حدد موقع ملف WAR أو EAR على الخادم أو جهازك.

  4. اضغط Next.

3. اختيار نمط النشر

  • اختر Install this deployment as an application.

  • ثم اضغط Next.

4. تحديد الأهداف (Targets)

  • اختر الخادم المستهدف (عادةً AdminServer أو Managed Server).

  • اضغط Next.

5. مراجعة الإعدادات والنشر

  • راجع الإعدادات.

  • اضغط Finish.

سيبدأ WebLogic في نشر التطبيق، ويمكن متابعة حالة النشر من شاشة Deployments.

سادساً: التحقق من نجاح النشر

  1. تأكد من أن حالة التطبيق هي Active.

  2. افتح المتصفح وادخل على رابط التطبيق:

    • مثال:

      http://localhost:7001/myapp
      
  3. في حال ظهور الصفحة الرئيسية، فهذا يعني أن النشر تم بنجاح.

سابعاً: النشر باستخدام سطر الأوامر (WLST)

يوفر WebLogic أداة WLST (WebLogic Scripting Tool) لأتمتة عمليات النشر:

مثال على نشر تطبيق WAR:

connect('weblogic','password','t3://localhost:7001')
deploy('MyApp','/path/myapp.war','AdminServer')

تُعد هذه الطريقة مثالية لبيئات CI/CD.

ثامناً: الأخطاء الشائعة أثناء النشر

  1. عدم توافق إصدار Java.

  2. مكتبات مفقودة داخل WAR/EAR.

  3. مشاكل في Data Source أو JNDI.

  4. تعارض المنافذ أو Context Root.

يُنصح دائماً بمراجعة ملفات السجل:

DOMAIN_HOME/servers/AdminServer/logs

خاتمة

نشر تطبيقات Java EE على WebLogic يُعد خطوة محورية في دورة حياة التطبيقات المؤسسية. من خلال فهم الفرق بين WAR و EAR، وتجهيز ملفات التهيئة بشكل صحيح، واستخدام Admin Console أو WLST، يمكن تنفيذ عملية النشر بسلاسة وكفاءة. ومع الممارسة، يصبح WebLogic أداة قوية لإدارة وتشغيل التطبيقات على نطاق واسع وبموثوقية عالية.


عدد الكلمات التقريبي: 1000 كلمة

Professional
Professional
تعليقات