مقدمة إلى Maven

Apache Maven أداة أتمتة بناء (build automation) لمشاريع Java. يأخذ شفرة المصدر وينتج مخرجاً (ملف .jar أو .war) بتنسيق كل الخطوات: التجميع، الاختبارات، التغليف، وإدارة التبعيات.

عملياً، يلبي Maven ثلاث حاجات أساسية :

قلب Maven ملف واحد، pom.xml (Project Object Model)، يصف المشروع: هويته، تبعياته، وطريقة بنائه. هذه «الوصفة» التي ينفّذها Maven.

بلا Maven، بناء مشروع Java يعني التجميع يدوياً بـ javac، وتنزيل كل مكتبة يدوياً، وإدارة الـ classpath بنفسك. يؤتمت Maven ذلك كله انطلاقاً من ملف واحد.

تمرين مصغّر — اذكر الحاجات الأساسية الثلاث التي يلبيها Maven.

قبل Maven، كان كل مشروع Java يُبنى «باليد» أو بسكربتات منزلية. ذلك طرح مشكلات متكررة :

الفكرة المركزية: مطوّر ينضم إلى مشروع Maven يعرف فوراً أين الشفرة، وأين الاختبارات، وكيف يطلق البناء — أياً كانت الشركة أو المشروع.

# مع Maven، بناء مشروع مجهول يختصر إلى:
mvn package

يحوّل Maven سؤال «كيف نبني هذا المشروع؟» — الذي كان يستغرق ساعات أحياناً — إلى أمر عالمي واحد.

تمرين مصغّر — اكتب الأمر الوحيد الذي يكفي لبناء مشروع Maven مجهول.

mvn package

المبدأ المركزي لـ Maven هو «العرف قبل الإعداد» (convention over configuration). بدل وصف كل شيء صراحة، ينطلق Maven من قيم افتراضية معقولة. إن احترمت الأعراف، فلا تكاد تحتاج إلى إعداد.

أمثلة أعراف افتراضية :

نقارن الفلسفتين :

يمكنك دائماً إعادة تعريف الأعراف إن لزم، لكن 95 % من المشاريع تكتفي بالقيم الافتراضية. إعداد أقل = أخطاء أقل.

كل مشروع Maven يتبع الشجرة نفسها. معرفتها تسمح بالتنقّل فوراً في أي مشروع.

تفصيل المجلدات :

تمرين مصغّر — في أي مجلد تضع صنفاً لاختبار وحدي، وفي أي مجلد ملفاً application.properties؟

# شجرة نموذجية تُرى من سطر الأوامر
mon-projet/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/        # مثال com/exemple/App.java
│   │   └── resources/   # مثال application.properties
│   └── test/
│       └── java/        # مثال com/exemple/AppTest.java
└── target/              # مولَّد: لا تؤرشف (.gitignore)

المجلد target/ يُعاد توليده عند كل بناء. أضفه إلى .gitignore: لا نؤرشف أبداً الآثار المجمَّعة.

يحتاج Maven إلى JDK (Java Development Kit) مثبَّت مسبقاً، لأنه يعتمد على المجمّع javac. يجب أن يشير المتغيّر JAVA_HOME إلى هذا JDK.

حسب نظامك :

التثبيت اليدوي (كل المنصات) :

# 1. التحقق أولاً من وجود Java
java -version
# يجب أن يعرض إصداراً 17+ مثلاً

# 2. تعيين JAVA_HOME (مثال Linux/macOS)
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk

# 3. تنزيل Maven من maven.apache.org، فك الضغط،
#    ثم إضافة المجلد bin/ إلى PATH
export PATH=$PATH:/opt/apache-maven-3.9.6/bin

على Windows، يُضبَط JAVA_HOME في «متغيرات البيئة». على Linux/macOS، أضف سطر export إلى ~/.bashrc أو ~/.zshrc ليصبح دائماً.

بعد تثبيت Maven، نتحقق من عمله ونولّد أول هيكل مشروع.

# التحقق من الإصدار المثبَّت
mvn -version

خرج نموذجي :

Apache Maven 3.9.6
Maven home: /opt/apache-maven-3.9.6
Java version: 17.0.9, vendor: Eclipse Adoptium

لتوليد مشروع فارغ يحترم الأعراف، نستخدم archetype (قالباً) :

# يولّد مشروعاً «quickstart» قياسياً
mvn archetype:generate \
  -DgroupId=com.exemple \
  -DartifactId=mon-app \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DinteractiveMode=false

أول mvn بطيء: ينزّل Maven إضافاته في ذاكرة تخزين محلية (~/.m2/repository). البناءات التالية أسرع بكثير.

تمرين مصغّر — اكتب الأمر الذي يعرض إصدار Maven المثبَّت (وإصدار Java).

mvn -version

السؤال 1: ماذا يعني الملف pom.xml في مشروع Maven؟

a) شفرة المصدر الرئيسية للتطبيق

b) Project Object Model: الوصفة التي تصف المشروع وبناءه

c) النتيجة المجمَّعة للمشروع

d) ملف سجلات

السؤال 2: أين يتوقع Maven شفرة المصدر الرئيسية افتراضياً؟

a) code/

b) target/main

c) src/main/java

d) java/source

السؤال 3: ماذا يعني «العرف قبل الإعداد»؟

a) يجب إعداد كل شيء صراحة

b) يستخدم Maven قيماً افتراضية معقولة تقلّل الإعداد اللازم

c) لا يمكن أبداً تغيير سلوك Maven

d) ليس لـ Maven ملف إعداد

السؤال 4: أي مجلد يولّده Maven تلقائياً ولا يجوز أرشفته؟

a) src/main/java

b) src/test/java

c) target/

d) resources/

السؤال 5: ماذا يحتاج Maven ليعمل؟

a) خادم ويب

b) JDK مثبَّت و JAVA_HOME مضبوط

c) قاعدة بيانات

d) Node.js

المطلوب

تحقق من تثبيت Maven، وولّد مشروعاً «quickstart» اسمه mon-app في المجموعة com.exemple، ثم ابنه وحدّد الأثر المنتج.

التصحيح — سلسلة الأوامر المتوقعة

# 1. التحقق من Maven و Java
mvn -version

# 2. توليد المشروع من قالب quickstart
mvn archetype:generate \
  -DgroupId=com.exemple \
  -DartifactId=mon-app \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DinteractiveMode=false

# 3. الدخول إلى المشروع وفحص البنية
cd mon-app
ls -R          # أو « tree » إن وُجد

# 4. بناء المشروع
mvn package

# 5. تحديد الأثر المولَّد
ls target/

النتيجة المتوقعة :

target/
├── classes/
├── mon-app-1.0-SNAPSHOT.jar   <-- الأثر المنتج
└── ...
BUILD SUCCESS

يجب أن تحتوي الشجرة المولَّدة :

mon-app/
├── pom.xml
└── src/
    ├── main/java/com/exemple/App.java
    └── test/java/com/exemple/AppTest.java

إذا عرض mvn package القيمة BUILD SUCCESS وظهر .jar في target/، فسلسلة Maven تعمل. اللاحقة -SNAPSHOT تشير إلى إصدار قيد التطوير (انظر الدرس 02).

النقاط التي يجب تذكّرها

1. Maven أداة أتمتة بناء لـ Java: يجمع، يختبر، يغلف، ويدير التبعيات.
2. pom.xml الوصفة الوحيدة التي تصف المشروع وبناءه.
3. العرف قبل الإعداد: قيم افتراضية تقلّل ما يجب كتابته.
4. البنية القياسية: src/main/java، src/test/java، src/main/resources، الخرج في target/.
5. يحتاج Maven إلى JDK و JAVA_HOME؛ نتحقق بـ mvn -version.

ما يلي

الدرس 02 — ملف pom.xml: تشريح وصفة Maven بالتفصيل — إحداثيات المشروع، الخصائص، ووراثة الأب.