Методы Mockito: основные понятия и применение
В данном разделе мы поговорим о Mockito – одной из самых популярных библиотек для создания и проверки Mock-объектов в Java. Mockito позволяет эмулировать поведение реальных объектов и проверять вызовы их методов.
Введение в Mockito
Mockito предлагает удобный способ моделирования поведения объектов в тестах. Он позволяет создавать так называемые Mock-объекты, которые ведут себя аналогично реальным объектам, но не имеют реальной реализации. Это позволяет изолировать тестируемый код от внешних зависимостей и сосредоточиться только на его поведении.
Mock-объекты и их роль в тестировании
Mock-объекты – это фиктивные объекты, которые используются в тестировании для замены реальных объектов и контроля над их поведением. Они позволяют создавать сценарии, в которых мы можем указывать, каким образом должен вести себя Mock-объект при вызове определенных методов. Это особенно полезно для тестирования сложных взаимодействий между объектами.
Способы создания Mock-объектов с помощью Mockito
Mockito предоставляет несколько способов создания Mock-объектов. Один из наиболее удобных способов – использование статического метода mock() класса Mockito. Он позволяет создать Mock-объекты для любого интерфейса или класса. Mockito также предлагает другие варианты, такие как использование аннотаций @Mock и @Spy, а также использование конструктора Mockito.mock().
Настройка поведения Mock-объектов
Mockito позволяет легко настраивать поведение Mock-объектов. С помощью метода when() мы можем указывать, какой результат должен возвращать Mock-объект при вызове определенных методов с определенными аргументами. Мы также можем указывать, какие исключения должны быть выброшены при вызове метода. Mockito предоставляет также богатый набор методов для настройки поведения, таких как thenReturn(), thenThrow(), thenAnswer() и многие другие.
Пример использования Mockito для проверки вызова методов
Давайте рассмотрим простой пример использования Mockito для проверки вызова метода. Предположим, у нас есть класс UserService, который содержит методы для работы с пользователями. Мы хотим убедиться, что метод getUserById() был вызван ровно один раз с аргументом 1. Вот как мы можем это сделать с помощью Mockito:
// Создаем Mock-объект UserService
UserService userService = Mockito.mock(UserService.class);
// Вызываем метод, который мы хотим протестировать
userService.getUserById(1);
// Проверяем, что метод getUserById() был вызван ровно один раз с аргументом 1
Mockito.verify(userService, Mockito.times(1)).getUserById(1);
Таким образом, мы можем легко проверить, что метод был вызван с правильными аргументами и в нужное количество раз. Mockito предоставляет различные методы проверки вызовов, такие как times(), atLeastOnce(), never() и другие.
Проверка количества вызовов методов
Помимо проверки того, что метод был вызван, Mockito также позволяет контролировать количество вызовов методов. Мы можем указать точное количество вызовов с помощью метода times(), а также указать минимальное и максимальное количество вызовов с помощью методов atLeast() и atMost(). Например:
userService.getUserById(1);
// Проверяем, что метод getUserById() был вызван два раза
Mockito.verify(userService, Mockito.times(2)).getUserById(1);
// Проверяем, что метод getUserById() был вызван по меньшей мере 3 раза
Mockito.verify(userService, Mockito.atLeast(3)).getUserById(1);
// Проверяем, что метод getUserById() был вызван не более 5 раз
Mockito.verify(userService, Mockito.atMost(5)).getUserById(1);
Проверка аргументов, переданных в методы
Mockito также предоставляет возможность проверять аргументы, переданные в вызываемые методы. Мы можем использовать методы eq(), any(), anyInt(), anyString() и многие другие для указания правильного ожидания аргументов. Например:
userService.getUserById(1);
// Проверяем, что метод getUserById() был вызван с аргументом, равным 1
Mockito.verify(userService).getUserById(Mockito.eq(1));
// Проверяем, что метод getUserById() был вызван с любым аргументом
Mockito.verify(userService).getUserById(Mockito.anyInt());
// Проверяем, что метод getUserById() был вызван с аргументом, соответствующим регулярному выражению
Mockito.verify(userService).getUserById(Mockito.matches("\\d+"));
Таким образом, мы можем гибко контролировать аргументы, передаваемые в методы при проверке вызова методов.
Игнорирование вызовов методов для проверки
Mockito также предоставляет возможность игнорировать вызовы определенных методов при проверке. Это полезно, например, когда мы хотим проверить вызов какого-то основного метода, не обращая внимания на вспомогательные методы. Мы можем использовать метод Mockito.ignoreStubs() для этой цели. Например:
// Создаем Mock-объект UserService
UserService userService = Mockito.mock(UserService.class);
// Задаем поведение метода getUserName()
Mockito.when(userService.getUserName(1)).thenReturn("John Doe");
// Вызываем метод, который мы хотим протестировать
userService.getUserById(1);
// Проверяем, что метод getUserById() был вызван
Mockito.verify(userService).getUserById(1);
// Игнорируем вызов метода getUserName()
Mockito.verify(userService, Mockito.ignoreStubs()).getUserName(Mockito.anyInt());
Таким образом, мы можем продолжить проверку вызова основного метода, не обращая внимания на другие методы.
Это лишь небольшой обзор основных возможностей Mockito для проверки вызова методов. Mockito предлагает еще множество других методов и функций для более гибкой настройки и контроля поведения Mock-объектов. Более подробную информацию можно найти в официальной документации Mockito.
Проверка вызова методов с помощью Mockito
При написании тестов очень важно убедиться, что определенные методы были вызваны с правильными аргументами и в нужном порядке. Mockito предлагает мощные средства для проверки вызова методов на мок-объектах.
Основные методы проверки вызова методов Mockito
Для проверки вызова методов Mockito предоставляет несколько основных методов. Один из них – verify(). Этот метод позволяет проверить, что определенный метод был вызван определенное количество раз с определенными аргументами. Например:
userService.getUserById(1);
// Проверяем, что метод getUserById() был вызван один раз с аргументом 1
Mockito.verify(userService, Mockito.times(1)).getUserById(1);
Проверка количества вызовов методов
Mockito предлагает различные методы для проверки количества вызовов методов. Один из наиболее распространенных – times(). С помощью этого метода мы можем указать точное количество вызовов метода, которое ожидаем. Например:
userService.getUserById(1);
userService.getUserById(2);
// Проверяем, что метод getUserById() был вызван два раза
Mockito.verify(userService, Mockito.times(2)).getUserById(Mockito.anyInt());
Мы также можем использовать другие методы, такие как atLeastOnce(), чтобы проверить, что метод был вызван хотя бы один раз, или never(), чтобы проверить, что метод не был вызван вообще.
Проверка аргументов, переданных в методы
Помимо проверки количества вызовов, Mockito также позволяет проверять аргументы, переданные в вызываемые методы. Мы можем использовать методы eq(), any(), anyInt(), anyString() и другие для указания ожидаемых аргументов. Например:
userService.getUserById(1);
userService.getUserById(2);
// Проверяем, что метод getUserById() был вызван с аргументом, равным 1
Mockito.verify(userService).getUserById(Mockito.eq(1));
// Проверяем, что метод getUserById() был вызван с любым аргументом int
Mockito.verify(userService).getUserById(Mockito.anyInt());
Мы также можем использовать регулярные выражения для проверки аргументов, переданных в методы.
Игнорирование вызовов методов для проверки
Иногда нам может потребоваться игнорировать вызовы определенных методов при проверке. Mockito предоставляет метод ignoreStubs(), который позволяет нам это сделать. Например:
// Создаем Mock-объект UserService
UserService userService = Mockito.mock(UserService.class);
// Задаем поведение метода getUserName()
Mockito.when(userService.getUserName(1)).thenReturn("John Doe");
// Вызываем метод, который мы хотим протестировать
userService.getUserById(1);
// Проверяем, что метод getUserById() был вызван
Mockito.verify(userService).getUserById(Mockito.anyInt());
// Игнорируем вызов метода getUserName()
Mockito.verify(userService, Mockito.ignoreStubs()).getUserName(Mockito.anyInt());
Таким образом, мы можем проверять вызовы основных методов, игнорируя вызовы вспомогательных методов.
Это лишь небольшой обзор возможностей Mockito для проверки вызова методов. Более подробную информацию и примеры использования вы можете найти в официальной документации Mockito.
Примеры использования Mockito для проверки вызова методов
В этом разделе мы рассмотрим несколько примеров использования Mockito для проверки вызова методов и убедимся, насколько это удобно и мощно.
Простой пример использования Mockito для проверки вызова метода
Допустим, у нас есть класс CarDao, который содержит методы для работы с данными автомобилей. Давайте протестируем, что метод saveCar() был вызван один раз с правильным автомобилем. Вот как это можно сделать с помощью Mockito:
// Создаем Mock-объект CarDao
CarDao carDao = Mockito.mock(CarDao.class);
// Вызываем метод, который мы хотим протестировать
Car car = new Car("ABC123", "Toyota", "Camry");
carDao.saveCar(car);
// Проверяем, что метод saveCar() был вызван один раз с правильным автомобилем
Mockito.verify(carDao, Mockito.times(1)).saveCar(Mockito.eq(car));
Так мы можем убедиться, что метод saveCar() был вызван с аргументом, соответствующим созданному нами объекту Car.
Проверка вызова метода с заданными аргументами
Часто нам может потребоваться проверить вызов метода с определенными аргументами. Mockito предоставляет метод verify() для проверки вызова метода с конкретными значениями аргументов. Например:
// Создаем Mock-объект CarDao
CarDao carDao = Mockito.mock(CarDao.class);
// Вызываем метод, который мы хотим протестировать с заданными аргументами
carDao.getCarByModel("Toyota", 2020);
// Проверяем, что метод getCarByModel() был вызван с заданными аргументами
Mockito.verify(carDao).getCarByModel(Mockito.eq("Toyota"), Mockito.eq(2020));
Таким образом, мы можем проверить, что метод вызывается с определенными аргументами.
Проверка вызова метода определенное количество раз
Мы также можем проверить, что метод вызывается определенное количество раз. Например, предположим, что нам нужно удостовериться, что метод processOrder() вызывается два раза при обработке нескольких заказов. Вот как это можно сделать:
// Создаем Mock-объект OrderProcessor
OrderProcessor orderProcessor = Mockito.mock(OrderProcessor.class);
// Вызываем метод, который мы хотим протестировать несколько раз
orderProcessor.processOrder(new Order("ABC123"));
orderProcessor.processOrder(new Order("XYZ789"));
// Проверяем, что метод processOrder() был вызван два раза
Mockito.verify(orderProcessor, Mockito.times(2)).processOrder(Mockito.any(Order.class));
Таким образом, мы можем контролировать количество вызовов метода при его проверке.
Комбинированные проверки вызова методов
Mockito также позволяет комбинировать проверки вызова методов с другими параметрами, такими как проверка аргументов и количество вызовов. Например:
// Создаем Mock-объект UserService
UserService userService = Mockito.mock(UserService.class);
// Вызываем метод, который мы хотим протестировать
userService.getUserById(1);
userService.getUserById(2);
// Проверяем, что метод getUserById() был вызван два раза с аргументами 1 и 2
Mockito.verify(userService, Mockito.times(2)).getUserById(Mockito.anyInt());
Mockito.verify(userService).getUserById(Mockito.eq(1));
Mockito.verify(userService).getUserById(Mockito.eq(2));
Таким образом, мы можем комбинировать различные проверки для уточненного контроля вызова методов.
Это лишь некоторые примеры использования Mockito для проверки вызова методов. Mockito предоставляет множество методов и возможностей для более сложной настройки и проверки вызовов методов на мок-объектах. Более подробную информацию и примеры использования вы можете найти в официальной документации Mockito.
Mockito и исключения
Mockito предоставляет удобные возможности для проверки вызова методов, выбрасывающих исключения. Это позволяет вам удостовериться, что ваш код правильно обрабатывает исключения и принимает соответствующие действия.
Проверка вызова метода, выбрасывающего исключение
Один из способов проверки вызова метода, выбрасывающего исключение, – использование метода verify(). Мы можем указать, какое исключение ожидаем, и Mockito автоматически проверит, что метод выбрасывает исключение с нужным типом. Например:
// Создаем Mock-объект UserService
UserService userService = Mockito.mock(UserService.class);
// Ожидаем, что метод getUserById() выбросит исключение IllegalArgumentException
Mockito.when(userService.getUserById(Mockito.anyInt())).thenThrow(new IllegalArgumentException());
// Вызываем метод, который мы хотим протестировать
userService.getUserById(1);
// Проверяем, что метод getUserById() выбросил исключение IllegalArgumentException
Mockito.verify(userService).getUserById(Mockito.eq(1));
Настройка возвращаемого значения при исключении
Иногда мы можем захотеть указать, какое значение должно быть возвращено, когда метод выбрасывает исключение. Mockito позволяет настраивать возвращаемые значения при выбрасывании исключения с помощью метода thenReturn(). Например:
// Создаем Mock-объект UserService
UserService userService = Mockito.mock(UserService.class);
// Ожидаем, что метод getUserById() выбросит исключение IllegalArgumentException
Mockito.when(userService.getUserById(Mockito.eq(1))).thenThrow(new IllegalArgumentException("Invalid user ID"));
// Вызываем метод, который мы хотим протестировать
String result = userService.getUserName(1);
// Проверяем, что метод getUserById() выбросил исключение IllegalArgumentException
// и убеждаемся, что возвращается значение по умолчанию
assertEquals("Unknown", result);
Таким образом, мы можем управлять возвращаемым значением при выбрасывании исключения.
Игнорирование вызова метода, выбрасывающего исключение
Sоbкакой же недавней версии Mockito необходимо использовать метод doThrow(), чтобы указать, что метод должен выбрасывать исключение. Для проверки вызова метода, выбрасывающего исключение, мы можем использовать метод verify(). Например:
// Создаем Mock-объект UserService
UserService userService = Mockito.mock(UserService.class);
// Задаем поведение метода getUserById()
Mockito.doThrow(new IllegalArgumentException()).when(userService).getUserById(Mockito.eq(1));
// Вызываем метод, который мы хотим протестировать
userService.getUserById(1);
// Проверяем, что метод getUserById() был вызван
Mockito.verify(userService).getUserById(Mockito.eq(1));
Таким образом, мы можем игнорировать вызов метода, выбрасывающего исключение, и проверять только факт его вызова.
Это лишь некоторые примеры использования Mockito для проверки вызова методов, выбрасывающих исключения. Mockito предоставляет еще множество других методов и возможностей для настройки и проверки таких сценариев. Более подробную информацию и примеры использования можно найти в официальной документации Mockito.
