/// <summary>
/// Adds the <see cref="IInMemoryClientFactory"/> and related services
/// to the <see cref="IServiceCollection"/> and configures a named
/// <see cref="InMemoryClient"/>.
/// </summary>
/// <param name="services">
/// The <see cref="IServiceCollection"/>.
/// </param>
/// <param name="name">
/// The logical name of the <see cref="InMemoryClient"/> to configure.
/// </param>
/// <param name="configureClient">
/// A delegate that is used to configure an <see cref="InMemoryClient"/>.
/// </param>
/// <returns>
/// An <see cref="IInMemoryClientFactory"/> that can be used to configure the client.
/// </returns>
/// <remarks>
/// <para>
/// <see cref="InMemoryClient"/> instances that apply the provided
/// configuration can be retrieved using
/// <see cref="IInMemoryClientFactory.CreateAsync"/> and providing
/// the matching name.
/// </para>
/// <para>
/// Use <see cref="Options.DefaultName"/> as the name to configure
/// the default client.
/// </para>
/// </remarks>
public static IInMemoryClientBuilder AddInMemoryClient(
this IServiceCollection services,
string name,
Action <IInMemoryClient> configureClient)
{
if (services == null)
{
throw new ArgumentNullException(nameof(services));
}
if (name == null)
{
throw new ArgumentNullException(nameof(name));
}
if (configureClient == null)
{
throw new ArgumentNullException(nameof(configureClient));
}
AddInMemoryClient(services);
var builder = new DefaultInMemoryClientBuilder(services, name);
builder.ConfigureInMemoryClient(configureClient);
return(builder);
}
/// <summary>
/// Adds the <see cref="IInMemoryClientFactory"/> and related services
/// to the <see cref="IServiceCollection"/> and configures a named
/// <see cref="InMemoryClient"/>.
/// </summary>
/// <param name="services">
/// The <see cref="IServiceCollection"/>.
/// </param>
/// <param name="name">
/// The logical name of the <see cref="InMemoryClient"/> to configure.
/// </param>
/// <param name="configureClientAsync">
/// A delegate that is used to configure an <see cref="InMemoryClient"/>.
/// </param>
/// <returns>
/// An <see cref="IInMemoryClientFactory"/> that can be used to configure the client.
/// </returns>
/// <remarks>
/// <para>
/// <see cref="InMemoryClient"/> instances that apply the provided
/// configuration can be retrieved using
/// <see cref="IInMemoryClientFactory.CreateAsync"/> and providing
/// the matching name.
/// </para>
/// <para>
/// Use <see cref="Options.DefaultName"/> as the name to configure
/// the default client.
/// </para>
/// </remarks>
public static IInMemoryClientBuilder AddInMemoryClientAsync(
this IServiceCollection services,
string name,
Func <IServiceProvider, IInMemoryClient, CancellationToken, ValueTask>
configureClientAsync)
{
if (services == null)
{
throw new ArgumentNullException(nameof(services));
}
if (name == null)
{
throw new ArgumentNullException(nameof(name));
}
if (configureClientAsync == null)
{
throw new ArgumentNullException(nameof(configureClientAsync));
}
AddInMemoryClient(services);
var builder = new DefaultInMemoryClientBuilder(services, name);
builder.ConfigureInMemoryClientAsync(configureClientAsync);
return(builder);
}