يتم تطبيق التعليق التوضيحيSpy في JUnit، خاصة عند استخدامه مع Mockito، لإنشاء تجسس على كائن فعلي. التجسس عبارة عن محاكاة جزئية، مما يعني أنه يمكنك الاستهزاء ببعض أساليب الكائن مع الاحتفاظ بالسلوك الحقيقي للطرق الأخرى.

إليك بعض الاستخدامات الشائعة للتعليق التوضيحي @Spy:

1. السخرية الجزئية:

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

    @Spy
    private List spyList = new ArrayList();
   
    @Test
    public void testSpy() {
        spyList.add("Mockito");
        Mockito.verify(spyList).add("Mockito");
        assertEquals(1, spyList.size());
   
        Mockito.doReturn(100).when(spyList).size();
        assertEquals(100, spyList.size());
    }
   

2. تجاوز سلوك الطريقة الحقيقية:

   • يمكنك استخدام برنامج تجسس لتجاوز سلوك أسلوب معين لكائن حقيقي مع الحفاظ على بقية الأساليب سليمة.
   • مثال:

    @Spy
    private MyClass myClass = new MyClass();
   
    @Test
    public void testSpyWithMethodOverride() {
        Mockito.doReturn("Mocked Value").when(myClass).someMethod();
        assertEquals("Mocked Value", myClass.someMethod());
    }
   

3. التحقق من استدعاءات الطريقة:

   • يمكنك التحقق مما إذا تم استدعاء أساليب معينة للتجسس، وهو أمر مفيد عند اختبار التفاعلات.
   • مثال:

    @Spy
    private MyClass myClass = new MyClass();
   
    @Test
    public void testMethodCallVerification() {
        myClass.someMethod();
        Mockito.verify(myClass).someMethod();
    }
   

4. الدمج معInjectMocks:

   • يمكن استخدام @Spy مع @InjectMocks لإدخال كائنات متجسسة في الكائن الذي يتم اختباره، مما يسمح بالسخرية الجزئية داخل الفئة التي تم اختبارها.
   • مثال:

    @Spy
    private MyDependency dependency;
   
    @InjectMocks
    private MyService service;
   
    @Test
    public void testService() {
        Mockito.doReturn("Mocked Result").when(dependency).doSomething();
        assertEquals("Mocked Result", service.performAction());
    }
   

5. اختبار الكود القديم:

   • عند التعامل مع تعليمات برمجية قديمة لا يمكنك إعادة معالجتها بسهولة، فإن استخدام برنامج تجسس يسمح لك بعزل أساليب معينة والاستهزاء بها دون تغيير التعليمات البرمجية الأصلية.

باختصار، يعد التعليق التوضيحي @Spy مفيدًا عندما تحتاج إلى التحكم أو التحقق من سلوكيات معينة لكائن فعلي مع الحفاظ على بقية سلوك الكائن دون تغيير.