الإعداد والمشروع الأول

توليد مشروع Spring Boot لا يستغرق سوى ثلاثين ثانية. أما ما يستغرق وقتًا، وما يميّز مشروعًا يتقدّم في العمر بشكل جيد عن مشروع يتحول إلى حقل ألغام، فيُحسم في الساعتين اللتين تليان: أين نضع الأصناف (classes)؟ وكيف يُكتب الإعداد؟ وكيف يتصرف التطبيق حين ينتقل من بيئة إلى أخرى؟

سيناريو الفشل هو نفسه دائمًا. ملف application.properties يتضخم سطرًا بعد سطر على مدى ستة أشهر، بمفاتيح لم يعد أحد يعرف أثرها. عنوان قاعدة بيانات الإنتاج يُودَع في المستودع «مؤقتًا». وحقن @Value("${paiement.delai}") في أربعة أصناف، يكتب أحدها paiement.delais بصيغة الجمع فيحصل بصمت على قيمة افتراضية. وفي يوم النشر، يبدأ التطبيق دون أي خطأ ثم يسلك سلوكًا خاطئًا.

لا تُعدّ أي من هذه المشكلات قاتلة بمفردها. القاسم المشترك بينها أنها تُكتشف متأخرة، مع أنه كان بالإمكان اكتشافها كلها عند بدء التشغيل. وهذا بالضبط ما تُرسيه هذه الدرس: إعداد يفشل مبكرًا وبصوت عالٍ حين يكون غير صحيح، بدلًا من أن ينحرف بصمت.

سنولّد هنا biblio-api، وهو فهرس المكتبة الذي سيكون خيطنا الناظم حتى الدرس الأخير.

توليد المشروع

يُستخدم Spring Initializr من المتصفح، لكن استدعاؤه من سطر الأوامر له ميزة قابلية إعادة الإنتاج، ويمكن وضعه في ملف README: