JUnit برنامج تعليمي للتعليقات التوضيحية مع مثال: ما هو @Test و@After

ما هي تفاصيل JUnit شروح؟

JUnit الشروح هي شكل خاص من البيانات الوصفية النحوية التي يمكن إضافتها إلى Java يُتيح هذا النظام إمكانية إضافة تعليقات توضيحية إلى شفرة المصدر لتحسين سهولة قراءتها وبنيتها. ويمكن إضافة هذه التعليقات إلى المتغيرات والمعاملات والحزم والأساليب والفئات. وقد تم إدخال التعليقات التوضيحية في JUnit 4، مما يجعل Java الكود أكثر قابلية للقراءة وأبسط. هذا هو الفرق الكبير بين JUnit و3 JUnit 4: JUnit يعتمد الإصدار 4 على التعليقات التوضيحية.

بمعرفة عملية لهذه الشروحات، يمكن للمرء بسهولة تعلم وتطبيق JUnit امتحان. أدناه هو المهم والمستخدم بشكل متكرر JUnit قائمة التعليقات التوضيحية، مع JUnit 5 (كوكب المشتري) ما يعادله بجانب كل واحد:

JUnit مثال التعليقات التوضيحية

دعونا ننشئ طبقة تغطي المهم JUnit التعليقات التوضيحية مع عبارات الطباعة البسيطة وتنفيذها باستخدام فئة عداء الاختبار:

الخطوة 1) انظر إلى ما يلي Java فئة تحتوي على طرق متنوعة مرتبطة بالتعليقات التوضيحية المذكورة أعلاه:

مثال على JunitAnnotations.java

package guru99.junit;		

import static org.junit.Assert.assertEquals;				
import static org.junit.Assert.assertFalse;				

import java.util.ArrayList;		

import org.junit.After;		
import org.junit.AfterClass;		
import org.junit.Before;		
import org.junit.BeforeClass;		
import org.junit.Ignore;		
import org.junit.Test;		

public class JunitAnnotationsExample {				

    private ArrayList<String> list;					

    @BeforeClass		
    public static void m1() {							
        System.out.println("Using @BeforeClass , executed before all test cases ");					
    }		

    @Before		
    public void m2() {					
        list = new ArrayList<String>();					
        System.out.println("Using @Before annotations ,executed before each test cases ");					
    }		

    @AfterClass		
    public static void m3() {							
        System.out.println("Using @AfterClass ,executed after all test cases");					
    }		

    @After		
    public void m4() {					
        list.clear();			
        System.out.println("Using @After ,executed after each test cases");					
    }		

    @Test		
    public void m5() {					
        list.add("test");					
        assertFalse(list.isEmpty());			
        assertEquals(1, list.size());			
    }		

    @Ignore		
    public void m6() {					
        System.out.println("Using @Ignore , this execution is ignored");					
    }		

    @Test(timeout = 10)			
    public void m7() {					
        System.out.println("Using @Test(timeout),it can be used to enforce timeout in JUnit4 test case");					
    }		

    @Test(expected = NoSuchMethodException.class)					
    public void m8() {					
        System.out.println("Using @Test(expected) ,it will check for specified exception during its execution");					

    }		

}		

الخطوة 2) لنقم بإنشاء فئة تشغيل الاختبار لتنفيذ الاختبار المذكور أعلاه:

TestRunner.java

package guru99.junit;		

import org.junit.runner.JUnitCore;		
import org.junit.runner.Result;		
import org.junit.runner.notification.Failure;		

public class TestRunner {				
			public static void main(String[] args) {									
      Result result = JUnitCore.runClasses(JunitAnnotationsExample.class);					
			for (Failure failure : result.getFailures()) {							
         System.out.println(failure.toString());					
      }		
      System.out.println("Result=="+result.wasSuccessful());							
   }		
}      	

نتيجة متوقعة

• سيتم تنفيذ جميع حالات الاختبار واحدة تلو الأخرى، ويمكن رؤية جميع عبارات الطباعة على وحدة التحكم.
• كما هو موضح في الجدول أعلاه، فإن @Before و @BeforeClass في JUnit سيتم تنفيذ [الطريقتين m2() و m1()] قبل كل حالة اختبار وقبل جميع حالات الاختبار على التوالي.
• بنفس الطريقة التي اتبعتها @After و @AfterClass في JUnit سيتم تنفيذ الدالتين m4() و m3() بعد كل حالة اختبار وبعد جميع حالات الاختبار على التوالي. سيتم التعامل مع الدالة m6() (@Ignore) على أنها تتجاهل الاختبار.

لنقم بتحليل حالات الاختبار المستخدمة أعلاه Java شرح مفصل للدرس:

1. ضع في اعتبارك الطريقة m5() كما هو موضح أدناه:

	@Test		
    public void m5() {					
        list.add("test");					
        assertFalse(list.isEmpty());			
        assertEquals(1, list.size());			
    }		

في الطريقة المذكورة أعلاه، أثناء إضافة سلسلة نصية إلى المتغير "list":

• القائمة فارغة() سيعود خطأ.
• AssureFalse(list.isEmpty()) يجب أن يعود صحيحا.
• ونتيجة لذلك، فإن حالة الاختبار سوف pass .

بما أنك أضفت سلسلة نصية واحدة فقط إلى القائمة، فإن حجمها يساوي واحدًا.

• حجم القائمة () يجب أن تُرجع القيمة العددية "1".
• So AssurEquals(1, list.size()) يجب أن يعود صحيحا.
• ونتيجة لذلك، فإن حالة الاختبار سوف pass .

2. ضع في اعتبارك الطريقة m7() كما هو موضح أدناه:

@Test(timeout = 10)		
    public void m7() {					
        System.out.println("Using @Test(timeout),it can be used to enforce timeout in JUnit4 test case");					
    }		

كما نوقش أعلاه، @اختبار (المهلة = 10) يُستخدم هذا لفرض مهلة زمنية في حالة الاختبار. القيمة مُقاسة بالمللي ثانية، لذا يجب أن تنتهي الدالة m7() في غضون 10 مللي ثانية.

3. ضع في اعتبارك الطريقة m8() كما هو موضح أدناه:

@Test(expected = NoSuchMethodException.class)				
    public void m8() {					
        System.out.println("Using @Test(expected) ,it will check for specified exception during its execution");					
    
    }		

كما نوقش أعلاه، @اختبار(متوقع) سيتحقق من الاستثناء المحدد أثناء تنفيذه، لذا فإن الدالة m8() ستطرح استثناء "لا يوجد مثل هذا الأسلوب". ونتيجة لذلك، سيتم تنفيذ الاختبار مع وجود استثناء.

ملاحظة بشأن الدقة: تقوم الدالة m8() بطباعة سطر واحد فقط، لذا فإن الاستثناء المعلن لا يتم طرحه فعلياً. JUnit 4. يُشير التقرير إلى فشل الاختبار. يجب مطابقة النوع المتوقع مع النوع الذي يُصدره الأسلوب فعليًا. JUnit يكتب 5 هذا باستخدام assertThrows.

عندما يتم اجتياز جميع حالات الاختبار، يؤدي ذلك إلى تنفيذ اختبار ناجح.

نتيجة فعلية

بما أن المثال أعلاه يتضمن ثلاث حالات اختبار، فسيتم تنفيذ جميع حالات الاختبار واحدة تلو الأخرى. انظر لقطة شاشة وحدة التحكم أدناه:

انظر أدناه بيانات الطباعة التي يمكن رؤيتها على وحدة التحكم:

باستخدام @BeforeClass، يتم تنفيذه قبل جميع حالات الاختبار

استخدام التعليقات التوضيحية @Before، والتي يتم تنفيذها قبل كل حالات الاختبار

باستخدام @After، يتم تنفيذه بعد كل حالة اختبار

استخدام التعليقات التوضيحية @Before، والتي يتم تنفيذها قبل كل حالات الاختبار

باستخدام @Test(timeout)، يمكن استخدامه لفرض المهلة JUnit4 حالة اختبار

باستخدام @After، يتم تنفيذه بعد كل حالة اختبار

استخدام التعليقات التوضيحية @Before، والتي يتم تنفيذها قبل كل حالات الاختبار

باستخدام @Test(expected)، سيتم التحقق من الاستثناء المحدد أثناء تنفيذه

باستخدام @After، يتم تنفيذه بعد كل حالة اختبار

باستخدامAfterClass، يتم تنفيذه بعد كل حالات الاختبار

JUnit تأكيد الطبقة

تحدد التعليقات التوضيحية متى يتم تشغيل الطريقة؛ وتحدد طرق التأكيد ما إذا كانت ستنجح أم لا.

توفر هذه الفئة مجموعة من طرق التأكيد المفيدة في كتابة حالات الاختبار. إذا نجحت جميع عبارات التأكيد، تكون نتائج الاختبار ناجحة. أما إذا فشلت أي عبارة تأكيد، فتكون نتائج الاختبار فاشلة. JUnit يجزم يشرح البرنامج التعليمي كل طريقة بالتفصيل.

كما رأيتم سابقاً، يوضح الجدول أدناه طرق التأكيد المهمة ووصفها:

JUnit فئة حالات الاختبار

لتشغيل اختبارات متعددة، تتوفر فئة TestCase في إطار عمل JUnit الحزمة. يشير التعليق التوضيحي @Test إلى JUnit أن هذه الطريقة العامة الفارغة (حالة اختبار هنا) التي تم إرفاقها بها يمكن تشغيلها كحالة اختبار.

ملاحظة حول الإصدار: حالة اختبار, نتيجة الفحص و حزمة اختبار ينتمي إلى الإرث إطار عمل JUnit الحزمة من JUnit 3. لا تزال تُشحن داخل عنصر junit 4.x، لكن الاختبارات القائمة على التعليقات التوضيحية لا تمتد إلى TestCase.

يوضح الجدول أدناه بعض الطرق المهمة المتاحة في junit.framework.TestCase صف دراسي:

JUnit فئة نتيجة الاختبار

عند تنفيذ اختبار، فإنه يُرجع نتيجة (على شكل نتيجة الفحص يمكن استخدام كائن نتيجة الاختبار هذا لتحليل الكائن الناتج. قد تكون نتيجة الاختبار إما فشلاً أو نجاحاً.

انظر الجدول أدناه للاطلاع على الطرق المهمة المستخدمة في فئة junit.framework.TestResult:

JUnit فئة جناح الاختبار

إذا كنت ترغب في تنفيذ عدة اختبارات بترتيب محدد، فيمكنك القيام بذلك عن طريق دمج جميع الاختبارات في مكان واحد. يُطلق على هذا المكان اسم مجموعة الاختبارات، و JUnit حزمة اختبار يشرح البرنامج التعليمي مثالاً كاملاً.

انظر الجدول أدناه للاطلاع على أهم الطرق المستخدمة في مجموعة اختبارات junit.framework.TestSuite صف دراسي:

الأسئلة الشائعة