Многие ответы меня не убеждают.
Прежде всего, представьте, что вы хотите провести модульное тестирование метода, который использует HttpClient
. Вы не должны создавать экземпляры HttpClient
непосредственно в своей реализации. Вы должны внедрить factory с ответственностью за предоставление вам экземпляра HttpClient
. Таким образом, вы можете позже смоделировать эту фабрику и вернуть то, что HttpClient
захотите (например, макет, HttpClient
а не настоящий).
Итак, у вас будет такая фабрика:
public interface IHttpClientFactory
{
HttpClient Create();
}
И реализация:
public class HttpClientFactory
: IHttpClientFactory
{
public HttpClient Create()
{
var httpClient = new HttpClient();
return httpClient;
}
}
Конечно, вам нужно будет зарегистрировать эту реализацию в своем контейнере IoC. Если вы используете 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
extends 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
Проблема заключается в выставлении a в вашем интерфейсе. Вы заставляете своего клиента использоватьHttpClient
конкретный класс. Вместо этого, вы должны разоблачить абстракции изHttpClient
.