HttpClient - This instance has already started
Singletons are the correct approach. Using scoped or transient will prevent connection pooling and lead to perf degradations and port exhaustion.
If you have consistent defaults then those can be initialized once when the service is registered:
var client = new HttpClient();
client.BaseAddress = new Uri("http://example.com/");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
services.AddSingleton<HttpClient>(client);
...
var incoming = new Uri(uri, UriKind.Relative); // Don't let the user specify absolute.
var response = await _client.GetAsync(incoming);
If you don't have consistent defaults then BaseAddress and DefaultRequestHeaders should not be used. Create a new HttpRequestMessage instead:
var incoming = new Uri(uri, UriKind.Relative); // Don't let the user specify absolute urls.
var outgoing = new Uri(new Uri("http://example.com/"), incoming);
var request = new HttpRequestMessage(HttpMethod.Get, outgoing);
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var response = await _client.SendAsync(request);
This is the design of the class HttpClient .Net Core Source.
The interesting method here is the CheckDisposedOrStarted()
.
private void CheckDisposedOrStarted()
{
CheckDisposed();
if (_operationStarted)
{
throw new InvalidOperationException(SR.net_http_operation_started);
}
}
Now this is called when setting the properties
BaseAddress
Timeout
MaxResponseContentBufferSize
So if you are planning to reuse the HttpClient
instance you should setup a single instance that presets those 3 properties and all uses must NOT modify these properties.
Alternativly you can create a factory or use simple AddTransient(...)
. Note that AddScoped
is not best suited here as you will recieve the same instance per request scope.
Edit Basic Factory
Now a factory is nothing more than a service that is responsible for providing an instance to another service. Here is a basic factory to build your HttpClient
now realize this is only the most basic you can extend this factory to do as you wish and presetup every instance of the HttpClient
public interface IHttpClientFactory
{
HttpClient CreateClient();
}
public class HttpClientFactory : IHttpClientFactory
{
static string baseAddress = "http://example.com";
public HttpClient CreateClient()
{
var client = new HttpClient();
SetupClientDefaults(client);
return client;
}
protected virtual void SetupClientDefaults(HttpClient client)
{
client.Timeout = TimeSpan.FromSeconds(30); //set your own timeout.
client.BaseAddress = new Uri(baseAddress);
}
}
Now why did I use and interface? This is done as using dependency injection and IoC we can easily "swap" parts of the application out very easily. Now instead of trying to access the HttpClientFactory
we access the IHttpClientFactory
.
services.AddScoped<IHttpClientFactory, HttpClientFactory>();
Now in your class, service or controller you would request the factory interface and generate an instance.
public HomeController(IHttpClientFactory httpClientFactory)
{
_httpClientFactory = httpClientFactory;
}
readonly IHttpClientFactory _httpClientFactory;
public IActionResult Index()
{
var client = _httpClientFactory.CreateClient();
//....do your code
return View();
}
The key here is.
- The factory is responsible for generating the client instance and will manage the defaults.
- We are requesting the interface not the implementation. This helps us keep our components disconnected and allow for a more modular design.
- The service is registered as a Scoped instance. Singletons have their uses but in this case you are more likely to want a scoped instance.
Scoped lifetime services are created once per request.