Я не переконаний у багатьох відповідях.
Перш за все, уявіть, що ви хочете перевірити метод, який використовує HttpClient. Ви не повинні створювати інстанцію HttpClientбезпосередньо у своїй реалізації. Ви повинні ввести фабрику, відповідальну за те, щоб надати вам примірник HttpClient. Таким чином, ви зможете пізніше знущатися з цієї фабрики та повертатися, що HttpClientхочете (наприклад: макет, HttpClientа не справжній).
Отже, у вас є завод на зразок наступного:
public interface IHttpClientFactory
{
HttpClient Create();
}
І реалізація:
public class HttpClientFactory
: IHttpClientFactory
{
public HttpClient Create()
{
var httpClient = new HttpClient();
return httpClient;
}
}
Звичайно, вам потрібно буде зареєструвати у вашому IoC Container цю реалізацію. Якщо ви використовуєте Autofac, це буде щось на кшталт:
builder
.RegisterType<IHttpClientFactory>()
.As<HttpClientFactory>()
.SingleInstance();
Тепер ви мали б належну та перевірену реалізацію. Уявіть, що ваш метод має щось на кшталт:
public class MyHttpClient
: IMyHttpClient
{
private readonly IHttpClientFactory _httpClientFactory;
public SalesOrderHttpClient(IHttpClientFactory httpClientFactory)
{
_httpClientFactory = httpClientFactory;
}
public async Task<string> PostAsync(Uri uri, string content)
{
using (var client = _httpClientFactory.Create())
{
var clientAddress = uri.GetLeftPart(UriPartial.Authority);
client.BaseAddress = new Uri(clientAddress);
var content = new StringContent(content, Encoding.UTF8, "application/json");
var uriAbsolutePath = uri.AbsolutePath;
var response = await client.PostAsync(uriAbsolutePath, content);
var responseJson = response.Content.ReadAsStringAsync().Result;
return responseJson;
}
}
}
Тепер тестова частина. HttpClientрозширюється HttpMessageHandler, що є абстрактним. Давайте створимо "макет", HttpMessageHandlerякий приймає делегата, так що коли ми використовуємо макет, ми також можемо налаштувати кожну поведінку для кожного тесту.
public class MockHttpMessageHandler
: HttpMessageHandler
{
private readonly Func<HttpRequestMessage, CancellationToken, Task<HttpResponseMessage>> _sendAsyncFunc;
public MockHttpMessageHandler(Func<HttpRequestMessage, CancellationToken, Task<HttpResponseMessage>> sendAsyncFunc)
{
_sendAsyncFunc = sendAsyncFunc;
}
protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
{
return await _sendAsyncFunc.Invoke(request, cancellationToken);
}
}
І тепер, і за допомогою Moq (і FluentAssertions, бібліотеки, яка робить тести одиниць більш читаними), у нас є все необхідне для тестування нашого методу PostAsync, який використовує HttpClient
public static class PostAsyncTests
{
public class Given_A_Uri_And_A_JsonMessage_When_Posting_Async
: Given_WhenAsync_Then_Test
{
private SalesOrderHttpClient _sut;
private Uri _uri;
private string _content;
private string _expectedResult;
private string _result;
protected override void Given()
{
_uri = new Uri("http://test.com/api/resources");
_content = "{\"foo\": \"bar\"}";
_expectedResult = "{\"result\": \"ok\"}";
var httpClientFactoryMock = new Mock<IHttpClientFactory>();
var messageHandlerMock =
new MockHttpMessageHandler((request, cancellation) =>
{
var responseMessage =
new HttpResponseMessage(HttpStatusCode.Created)
{
Content = new StringContent("{\"result\": \"ok\"}")
};
var result = Task.FromResult(responseMessage);
return result;
});
var httpClient = new HttpClient(messageHandlerMock);
httpClientFactoryMock
.Setup(x => x.Create())
.Returns(httpClient);
var httpClientFactory = httpClientFactoryMock.Object;
_sut = new SalesOrderHttpClient(httpClientFactory);
}
protected override async Task WhenAsync()
{
_result = await _sut.PostAsync(_uri, _content);
}
[Fact]
public void Then_It_Should_Return_A_Valid_JsonMessage()
{
_result.Should().BeEquivalentTo(_expectedResult);
}
}
}
Очевидно, що цей тест є дурним, і ми справді випробовуємо наш макет. Але ви отримуєте ідею. Ви повинні перевірити значущу логіку залежно від вашої реалізації, наприклад ..
- якщо статус коду відповіді не 201, чи повинен він кидати виняток?
- якщо текст відповіді неможливо проаналізувати, що має бути?
- тощо.
Метою цієї відповіді було перевірити те, що використовує HttpClient, і це приємний чистий спосіб зробити це.
HttpClientінтерфейсу у вашому інтерфейсі - це проблема. Ви змушуєте свого клієнта використовуватиHttpClientконкретний клас. Замість цього, ви повинні викрити абстракції зHttpClient.