/// <summary>
/// Adds the <see cref="IHttpClientFactory"/> and related services to the <see cref="IServiceCollection"/> and configures
/// a binding between the <typeparamref name="TClient"/> type and a named <see cref="HttpClient"/>. The client name
/// will be set to the full name of <typeparamref name="TClient"/>.
/// </summary>
/// <typeparam name="TClient">
/// The type of the typed client. They type specified will be registered in the service collection as
/// a transient service. See <see cref="ITypedHttpClientFactory" /> for more details about authoring typed clients.
/// </typeparam>
/// <param name="services">The <see cref="IServiceCollection"/>.</param>
/// <returns>An <see cref="IHttpClientBuilder"/> that can be used to configure the client.</returns>
/// <remarks>
/// <para>
/// <see cref="HttpClient"/> instances that apply the provided configuration can be retrieved using
/// <see cref="IHttpClientFactory.CreateClient(string)"/> and providing the matching name.
/// </para>
/// <para>
/// <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="HttpClient" />
/// can be retrieved from <see cref="IServiceProvider.GetService(Type)" /> (and related methods) by providing
/// <typeparamref name="TClient"/> as the service type.
/// </para>
/// <para>
/// Use <see cref="Options.Options.DefaultName"/> as the name to configure the default client.
/// </para>
/// </remarks>
public static IHttpClientBuilder AddHttpClient<TClient>(this IServiceCollection services)
where TClient : class
{
if (services == null)
{
throw new ArgumentNullException(nameof(services));
}
AddHttpClient(services);
var builder = new DefaultHttpClientBuilder(services, typeof(TClient).Name);
builder.AddTypedClient<TClient>();
return builder;
}
/// <summary>
/// Adds the <see cref="IHttpClientFactory"/> and related services to the <see cref="IServiceCollection"/> and configures
/// a binding between the <typeparamref name="TClient" /> type and a named <see cref="HttpClient"/>. The client name will
/// be set to the type name of <typeparamref name="TClient"/>.
/// </summary>
/// <typeparam name="TClient">
/// The type of the typed client. They type specified will be registered in the service collection as
/// a transient service. See <see cref="ITypedHttpClientFactory{TClient}" /> for more details about authoring typed clients.
/// </typeparam>
/// <param name="services">The <see cref="IServiceCollection"/>.</param>
/// <param name="configureClient">A delegate that is used to configure an <see cref="HttpClient"/>.</param>
/// <returns>An <see cref="IHttpClientBuilder"/> that can be used to configure the client.</returns>
/// <remarks>
/// <para>
/// <see cref="HttpClient"/> instances that apply the provided configuration can be retrieved using
/// <see cref="IHttpClientFactory.CreateClient(string)"/> and providing the matching name.
/// </para>
/// <para>
/// <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="HttpClient" />
/// can be retrieved from <see cref="IServiceProvider.GetService(Type)" /> (and related methods) by providing
/// <typeparamref name="TClient"/> as the service type.
/// </para>
/// </remarks>
public static IHttpClientBuilder AddHttpClient <TClient>(this IServiceCollection services, Action <IServiceProvider, HttpClient> configureClient)
where TClient : class
{
if (services == null)
{
throw new ArgumentNullException(nameof(services));
}
if (configureClient == null)
{
throw new ArgumentNullException(nameof(configureClient));
}
AddHttpClient(services);
var builder = new DefaultHttpClientBuilder(services, typeof(TClient).Name);
builder.ConfigureHttpClient(configureClient);
builder.AddTypedClient <TClient>();
return(builder);
}