Mockito: обход предупреждений при работе со списками generics

Быстрый ответ

Для тестирования списков с дженериками в Mockito рекомендуется использовать any(), явно указывая тип данных. Это обеспечивает статическую типобезопасность, необходимую при мокировании или верификации методов, работающих со списками обобщений.

when(mockList.addAll(any())).thenReturn(true);
verify(mockList).addAll((List<String>) any());

Здесь (List<String>) указывает Mockito на то, что мы работаем со списком строк, обеспечивая сопоставимость типов при вызове методов.

Синергия Mockito и дженериков

Встреча дженериков и матчеров

В Java 8 и новее используйте ArgumentMatchers.any(). Это позволяет написать код более лаконично и воспользоваться выводом типов:

when(mockList.addAll(ArgumentMatchers.<String>any())).thenReturn(true);
verify(mockList).addAll(ArgumentMatchers.<String>anyList());

БОНУС: дженерики автоматически определяются и предусматривают строгую типизацию без необходимости явного приведения типов.

Подробнее об этом расскажет наш спикер на видео

Грациозное обращение с перегруженными методами

Перегрузка методов может быть источником проблем при использовании Mockito. Использование матчеров обобщённых типов pomожет их избежать:

// Для большего разнообразия...
verify(mockedList).add(ArgumentMatchers.<MyClass>any());

В глубь времён (или назад в будущее)

В Java 7 и более ранних версиях для избегания несоответствия типов можно использовать Matchers.anyListOf(Class<T> clazz):

when(mockList.addAll(Matchers.<String>anyListOf(String.class))).thenReturn(true);
verify(mockList).addAll(Matchers.<String>anyListOf(String.class));

Вера в "сырые" типы (примечательно, что нет)

Использование сырых типов существенно увеличивает риск ошибок типизации. Если приходится работать с такими типами, применяйте соответствующие приведения типов:

when(mockList.addAll((List) any())).thenReturn(true);
verify(mockList).addAll((List)Matchers.anyList());

ArgumentMatchers: Мультиинструмент

ArgumentMatchers позволяет удобно манипулировать параметрами методов, предлагая гибкие способы уточнения ожидаемого типа. Статический импорт снимает многие компликации:

import static org.mockito.ArgumentMatchers.*;

when(mockList.addAll(anyList())).thenReturn(true);
verify(mockList).addAll(anyList());

Детали: Продвинутые стратегии создания заглушек

Точное соответствие с вложенными дженериками

Сложные вложенные дженерики требуют явного указания типов при использовании API Matchers:

when(mockSomeObject.someMethod(Matchers.<List<List<String>>>any())).thenReturn(someResult);

Захват параметров с помощью ArgumentCaptor

ArgumentCaptor позволяет захватывать фактические значения аргументов при тестировании, расширяя инструментарий тестировщика:

ArgumentCaptor<List<String>> captor = ArgumentCaptor.forClass((Class) List.class); 
verify(mockList).addAll(captor.capture());
assertTrue(captor.getValue().containsAll(expectedList));

Визуализация

Проанализируйте детали, как элементы мозаики:

Без дженериков: форма детали не оценивается 🧩

verify(mockedList).add(any());

С дженериками: каждая деталь тщательно подбирается 🧩💫

verify(mockedList).add(any(MyClass.class));

В итоге, Mockito с дженериками обеспечивает высокую точность в тестировании, что гарантирует качественный результат! 🧩🔍

Полезные материалы

1. ArgumentMatchers — mockito-core 5.10.0 javadoc — официальная документация ArgumentMatchers в Mockito.
2. GitHub – mockito/mockito — официальный репозиторий Mockito с последними версиями и документацией.
3. Урок: Дженерики (The Java™ Tutorials > Learning the Java Language) — туториал Oracle по дженерикам в Java.
4. Mockito+generics – Stack Overflow — обсуждения и вопросы, связанные с Mockito и дженериками.
5. Руководство по Mockito для разработчика юнит-тестов от Toptal® — руководство по Mockito в контексте юнит-тестирования.
6. Использование ArgumentCaptor – Baeldung — руководство по использованию ArgumentCaptor для захвата аргументов в Mockito.