تعليقات Spring التوضيحية: @Component و @Repository و @Service — ما الفرق؟

مقدمة: لماذا يوجد ثلاثة تعليقات توضيحية في Spring لنفس الغرض؟

كل من بدأ العمل مع Spring، عاجلاً أم آجلاً، طرح السؤال التالي: "لماذا نحتاج إلى ثلاثة تعليقات توضيحية مختلفة — @Component و @Repository و @Service — إذا كانت جميعها تسجل ببساطة Bean في السياق؟".

هذا السؤال شائع جداً لدرجة أنه حصد آلاف المشاهدات وعشرات الإجابات على Stack Overflow. وهذا ليس من قبيل الصدفة. للوهلة الأولى، تقوم التعليقات التوضيحية بالفعل بنفس الشيء. لكن الشيطان، كما هو الحال دائماً، يكمن في التفاصيل.

في هذه المقالة، لن نقوم فقط بسرد الاختلافات. سنقوم بتحليل فلسفة Spring، وننظر تحت غطاء المحرك للحاوية، ونوضح كيف يمكن للاستخدام الصحيح للتعليقات التوضيحية أن ينقذ مشروعك من الأخطاء الخفية. هيا بنا!

نبذة مختصرة: ما هي التعليقات التوضيحية النمطية؟

تنتمي التعليقات التوضيحية الثلاثة جميعها إلى ما يسمى التعليقات التوضيحية النمطية (stereotype annotations). وهي تخبر Spring أن الفئة هي مكون مُدار (Bean) ويجب اكتشافها تلقائياً أثناء مسح classpath.

التعليق التوضيحي الأساسي هو @Component. إنه الأساس. @Repository و @Service و @Controller هي أشكال متخصصة من @Component، والتي تضيف دلالات وسلوكاً إضافيين.

@Target(ElementType.TYPE)\n@Retention(RetentionPolicy.RUNTIME)\n@Documented\n@Component // هذه هي النقطة الأساسية!\npublic @interface Service {\n    // ...\n}

كما ترى، @Service نفسه مُعلَّق بـ @Component. هذا يعني أن Spring سيعالجها تماماً مثل @Component العادي. ولكن لماذا إذن نعقد الأمور؟

@Component — الجندي الشامل

@Component هو التعليق التوضيحي الأكثر عمومية. استخدمه عندما لا يناسب فصلك أي فئة من الفئات الأكثر تحديداً.

أمثلة نموذجية:

\n
• الأدوات المساعدة
\n
• كائنات التهيئة (لا تخلط مع @Configuration)
\n
• أي فئات يجب أن تكون Beans، ولكنها ليست خدمات أو مستودعات أو وحدات تحكم
\n

import org.springframework.stereotype.Component;\n\n@Component\npublic class EmailValidator {\n\n    public boolean isValid(String email) {\n        return email != null && email.contains("@");\n    }\n}

لاحظ: EmailValidator لا ينفذ منطق الأعمال (هذا ليس @Service) ولا يعمل مع قاعدة البيانات (هذا ليس @Repository). لذلك، @Component هو الخيار المثالي.

@Repository — حارس البيانات

@Repository هو أول تعليق توضيحي متخصص يضيف وظائف حقيقية. بالإضافة إلى تسجيل Bean، فإنه يؤدي مهمتين مهمتين:

\n
1. اعتراض استثناءات الوصول إلى البيانات. يقوم Spring تلقائياً بتغليف الاستثناءات من DAO (كائن الوصول إلى البيانات) في DataAccessException — التسلسل الهرمي للاستثناءات في Spring.
\n
2. تحسين قابلية قراءة الكود. أي مطور، عند رؤية @Repository، يفهم فوراً: "أها، هنا يتم العمل مع قاعدة البيانات".
\n

import org.springframework.stereotype.Repository;\nimport org.springframework.data.jpa.repository.JpaRepository;\n\n@Repository\npublic interface UserRepository extends JpaRepository<User, Long> {\n\n    User findByEmail(String email);\n}

هام: إذا كنت تستخدم Spring Data JPA وتورث من JpaRepository، فإن Spring سينشئ Bean وكيلاً بنفسه. التعليق التوضيحي الصريح @Repository ليس إلزامياً، ولكنه موصى به للإشارة الصريحة إلى الغرض.

الميزة الرئيسية لـ @Repository هي معترض AOP (PersistenceExceptionTranslationPostProcessor)

المدونات

البرمجة الوظيفية في Go: المبادئ والأمثلة

سير عمل Git لمطور PHP: من الفوضى إلى الكود النظيف

Angular 2 التمرير إلى الأعلى عند تغيير المسار: حل للمبتدئين

توصيات الكتب

هندسة تطبيقات Go (Golang): من المبتدئ إلى الإنتاج

رسومات بايثون: دليل شامل لإنشاء الرسومات ثنائية وثلاثية الأبعاد بلغة بايثون

Practical Rust Projects

ابدأ العمل مع ARKit لأجهزة iPhone وiPad

اقرأ أيضًا

التأمل والاستبطان في Rust: كيف تنظر داخل الكود فشل startForeground بعد التحديث إلى Android 8.1: الحل بلغة Kotlin TypeScript من الصفر في 2025: دليل شامل للمبتدئين العمل مع JSON في Swift: التحليل والتسلسل للمبتدئين أحداث مرسلة من الخادم في PHP: الوقت الفعلي بدون WebSocket وبدون صداع