/// <summary>
/// Adds the <see cref="IVkApiFactory"/> and related services to the <see cref="IServiceCollection"/> and configures
/// a binding between the <typeparamref name="TClient" /> type and a named <see cref="IVkApi"/>.
/// </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="ITypedVkApiFactory{TClient}" /> for more details about authoring typed clients.
/// </typeparam>
/// <typeparam name="TImplementation">
/// The implementation type of the typed client. They type specified will be instantiated by the
/// <see cref="ITypedVkApiFactory{TImplementation}"/>
/// </typeparam>
/// <param name="services">The <see cref="IServiceCollection"/>.</param>
/// <param name="name">The logical name of the <see cref="IVkApi"/> to configure.</param>
/// <param name="configureClient">A delegate that is used to configure an <see cref="IVkApi"/>.</param>
/// <returns>An <see cref="IVkApiBuilder"/> that can be used to configure the client.</returns>
/// <remarks>
/// <para>
/// <see cref="IVkApi"/> instances that apply the provided configuration can be retrieved using
/// <see cref="IVkApiFactory.CreateVkApi(string)"/> and providing the matching name.
/// </para>
/// <para>
/// <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="IVkApi" />
/// 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.DefaultName"/> as the name to configure the default client.
/// </para>
/// </remarks>
public static IVkApiBuilder AddVkApi <TClient, TImplementation>(this IServiceCollection services, string name,
Action <IServiceProvider, IVkApi> configureClient)
where TClient : class
where TImplementation : class, TClient
{
if (services == null)
{
throw new ArgumentNullException(nameof(services));
}
if (name == null)
{
throw new ArgumentNullException(nameof(name));
}
if (configureClient == null)
{
throw new ArgumentNullException(nameof(configureClient));
}
AddVkApi(services);
var builder = new DefaultVkApiBuilder(services, name);
builder.ConfigureVkApi(configureClient);
builder.AddTypedVkApi <TClient, TImplementation>();
return(builder);
}
/// <summary>
/// Adds the <see cref="IVkApiFactory"/> and related services to the <see cref="IServiceCollection"/> and configures
/// a named <see cref="IVkApi"/>.
/// </summary>
/// <param name="services">The <see cref="IServiceCollection"/>.</param>
/// <param name="name">The logical name of the <see cref="IVkApi"/> to configure.</param>
/// <param name="configureApi">A delegate that is used to configure an <see cref="IVkApi"/>.</param>
/// <returns>An <see cref="IVkApiBuilder"/> that can be used to configure the api.</returns>
/// <remarks>
/// <para>
/// <see cref="IVkApi"/> instances that apply the provided configuration can be retrieved using
/// <see cref="IVkApiFactory.CreateVkApi"/> and providing the matching name.
/// </para>
/// <para>
/// Use <see cref="Options.DefaultName"/> as the name to configure the default api.
/// </para>
/// </remarks>
public static IVkApiBuilder AddVkApi(this IServiceCollection services, string name,
Action <IVkApi> configureApi)
{
if (services == null)
{
throw new ArgumentNullException(nameof(services));
}
if (name == null)
{
throw new ArgumentNullException(nameof(name));
}
if (configureApi == null)
{
throw new ArgumentNullException(nameof(configureApi));
}
AddVkApi(services);
var builder = new DefaultVkApiBuilder(services, name);
builder.ConfigureVkApi(configureApi);
return(builder);
}
/// <summary>
/// Adds the <see cref="IVkApiFactory"/> and related services to the <see cref="IServiceCollection"/> and configures
/// a binding between the <typeparamref name="TClient"/> type and a named <see cref="IVkApi"/>. 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="ITypedVkApiFactory{TClient}" /> for more details about authoring typed clients.
/// </typeparam>
/// <param name="services">The <see cref="IServiceCollection"/>.</param>
/// <returns>An <see cref="IVkApiBuilder"/> that can be used to configure the client.</returns>
/// <remarks>
/// <para>
/// <see cref="IVkApi"/> instances that apply the provided configuration can be retrieved using
/// <see cref="IVkApiFactory.CreateVkApi(string)"/> and providing the matching name.
/// </para>
/// <para>
/// <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="IVkApi" />
/// 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 IVkApiBuilder AddVkApi <TClient>(this IServiceCollection services)
where TClient : class
{
if (services == null)
{
throw new ArgumentNullException(nameof(services));
}
AddVkApi(services);
var name = typeof(TClient).Name;
var builder = new DefaultVkApiBuilder(services, name);
builder.AddTypedVkApi <TClient>();
return(builder);
}