ASP.NET Core: подход к написанию интеграционных тестов для WebAPI

Интеграционное тестирование Web Api
Взгляд с бэкенда
Отойди в сторону, qa
Мой час настал

О чем идет речь
Под интеграционным тестированием понимаем тестирование
взаимодействия между частями системы после проведения
модульного тестирования.
Рамки процесса:
• от нескольких классов (традиционно, за be);
• до работы всего приложения в целом (как правило, за qa).
2

Hand-made реализация
3
ASP.NET
Core
Web Api
Минусы:
• Долго;
• Ненадежно;
• Сложность поддержки;
• Высокий Bus factor.

Автоматизированная реализация
Минусы:
• Все еще не быстро;
• Сложность автоматизации проверки всего необходимого (почта,
логи и так далее).
4
ASP.NET
Core
Web ApiClientTests

xUnit
Автоматизированная реализация+
Решаемые проблемы:
• Не нужно развертывать отдельное приложение с Api;
• Отсутствие тормозов, вызванных сетью;
• Возможность автоматизировать почти все проверки.
5
ASP.NET
Core
Client
ICollectionFixture
Tests
TestServer
Web Api

TestServer
Сервер для тестирования приложений ASP.NET Core, эмулирующий
сетевые взаимодействия в памяти.
Доступен в пакете Microsoft.AspNetCore.TestHost.
Используемые члены:
1. TestServer(IWebHostBuilder builder);
2. HttpMessageHandler CreateHandler();
3. Uri BaseAddress.
6

ICollectionFixture<TFixture>
Интерфейс xUnit, применяющийся для маркировки коллекции
тестов, разделяющих общую фикстуру.
Используется совместно с двумя атрибутами xUnit
1. CollectionDefinitionAttribute, маркирующим реализацию
ICollectionFixture и принимающим в конструкторе имя
коллекции тестов;
2. CollectionAttribute, маркирующим класс с тестами и
принимающим в конструкторе имя коллекции тестов, в которую
входит класс.
7

Общая фикстура тестов
• Создание зависимостей, над которыми мы хотим получить
контроль при тестировании;
• Конфигурирование и запуск тестируемого приложения при
помощи TestServer;
• Подгрузка конфигурации для прогона и запуска тестов.
8

Базовый класс тестов
• Получение общей фикстуры с содержащимся в ней тестируемым
приложением и контролируемыми зависимостями;
• Создание клиента тестируемого сервиса, взаимодействующего с
переданным в фикстуре экземпляром TestServer.
9

xUnit
Что в итоге получилось
10
[CollectionDefinition(nameof(ApiTestsCollection))]
public class ApiTestsCollection : ICollectionFixture<ApiTestsFixture> {}
[Collection(nameof(ApiTestsCollection))]
public class ValuesControllerTests : ...
{
protected readonly ValuesService Client;
}
Tests
…………………………………….
public class ApiTestsFixture : IDisposable
{
public TestServer Server { get; }
public Mock<ILogger> MockLogger { get; }
public IConfigurationRoot Configuration { get; }
public int TimeoutInMilliseconds { get; }
.........................
}
[Collection(nameof(ApiTestsCollection))]
public class AccountControllerTests : ...
{
protected readonly AccountService Client;
}
Tests
ASP.NET
Core
Web Api

Ссылки
Тулинг:
1. https://www.nuget.org/packages/Microsoft.AspNetCore.TestHost;
2. https://www.nuget.org/packages/xunit.
Документация:
1. https://docs.microsoft.com/en-us/aspnet/core/testing/integration-
testing;
2. https://andrewlock.net/introduction-to-integration-testing-with-xunit-
and-testserver-in-asp-net-core/.
Примеры:
1. https://github.com/litichevskiydv/WebInfrastructure/tree/master/src/Inf
rastructure/Web.Testing;
2. https://github.com/litichevskiydv/WebInfrastructure/tree/master/test/
Web.Tests.
11

ASP.NET Core: подход к написанию интеграционных тестов для WebAPI

Recommended

More Related Content

What's hot (20)

Similar to ASP.NET Core: подход к написанию интеграционных тестов для WebAPI (20)

ASP.NET Core: подход к написанию интеграционных тестов для WebAPI