تعتبر التسمية من أصعب المشاكل في تطوير البرمجيات. قد يكون إنشاء أسماء ذات مغزى للجوانب الأساسية للبرنامج ، مثل الفئات والطرق ، أمرًا صعبًا. وتزيد قيود التسمية ، مثل عدم التباعد ، من حدة هذه المشكلة.
تستمر مشكلة التسمية في كل جانب من جوانب دورة حياة تطوير البرامج ، بما في ذلك الاختبار. هذا هو المكان الذي يصبح فيه التعليق التوضيحي JUnitDisplayName مفيدًا.
ما هو التعليق التوضيحيDisplayName؟
يمكن أن يكون لطريقة واحدة عدة طرق اختبار يختبر كل منها سلوكًا معينًا. ومع ذلك ، إذا قمت بتعيين أسماء سلوكية لأساليب الاختبار ، فيمكن أن تصبح كلمات وتصعب قراءتها.
التعليق التوضيحيDisplayName هو مكون JUnit يسمح لك بإنشاء أسماء مخصصة لفئات وأساليب الاختبار الخاصة بك. يمكن أن تحتوي هذه الأسماء على مسافات وأحرف خاصة وحتى رموز تعبيرية. يجب أن يساعدك التعليق التوضيحيDisplayName على إنشاء أسماء أكثر وصفًا وذات مغزى لفئات الاختبار وطرقه.
كيفية استخدام التعليق التوضيحيDisplayName
في فئة اختبار JUnit، يظهر التعليق التوضيحيDisplayName أعلى اسم الفئة أو قبل إعلان الأسلوب مباشرةً. يأخذ التعليق التوضيحيDisplayName وسيطة واحدة (الاسم). تظهر هذه الحجة لاحقًا في تقارير الاختبار ، مما يجعل وثائق الاختبار أكثر وصفًا.
حزمة اسم العرض؛يستورد org.junit.jupiter.api. اسم العرض؛
يستورد org.junit.jupiter.api. اختبار؛@اسم العرض("اختبار صف دراسيمظاهرةكيفال @اسم العرضحاشية. ملاحظةيعمل.&مثل;)
صف دراسياسم العرض{
@اختبار
@اسم العرض("اسم عرض الاختبار الذي يحتوي على أحرف خاصة: ° □ °） ╯")
فارغtestDisplayNameWithSpecialCharacters(){}@اختبار
@اسم العرض("اختبار اسم العرض الذي يحتوي على مسافة")
فارغtestDisplayNameWithSpaces(){}
@اختبار
@اسم العرض("اختبار اسم العرض الذي يحتوي على رمز تعبيري: 😱")
فارغtestDisplayNameWithEmoji(){}
}
يؤدي تنفيذ فئة Java هذه إلى إنشاء تقرير اختبار وحدة JUnit التالي:
تستبدل كل وسيطة تعليق توضيحيDisplayName اسم الفئة أو الأسلوب الخاص بها في تقرير اختبار JUnit. التعليق التوضيحيDisplayName ، "اختبار الفصل الذي يوضح كيفية عمل التعليق التوضيحيDisplayName" هو أكثر تعبيرًا وشمولية من DisplayNameTest.
ما التالي للاختبار؟
إن معرفة كيفية استخدام التعليق التوضيحيDisplayName سيؤدي بالتأكيد إلى تحسين وثائق اختبار الوحدة الخاصة بك. بصرف النظر عن التعليق التوضيحي لـDisplayName ، ستجد أن جميع اختبارات وحدة JUnit الخاصة بك ستحتاج إلى تأكيد واحد أو أكثر. التأكيدات هي اللبنات الأساسية لاختبارات وحدة JUnit ، لذلك من الجيد معرفة كيفية استخدامها.
