Аннотация @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 полезна, когда вам нужно контролировать или проверять определенное поведение реального объекта, сохраняя при этом остальную часть поведения объекта неизменной.