/// <summary>
/// Registers the base type to be resolved as subscriber. The actual types have to be added to the
/// <see cref="IServiceCollection" /> separately.
/// </summary>
/// <typeparam name="TSubscriber">
/// The base type of the subscribers (class or interface).
/// </typeparam>
/// <param name="silverbackBuilder">
/// The <see cref="ISilverbackBuilder" /> that references the <see cref="IServiceCollection" /> to add
/// the subscriber to.
/// </param>
/// <param name="options">
/// The <see cref="TypeSubscriptionOptions" />.
/// </param>
/// <returns>
/// The <see cref="ISilverbackBuilder" /> so that additional calls can be chained.
/// </returns>
/// <remarks>
/// The subscribers will have to be registered twice (with the base type and the type itself:
/// <c>.AddScoped<BaseType, Subscriber>.AddScoped<Subscriber></c>).
/// </remarks>
public static ISilverbackBuilder AddSubscribers <TSubscriber>(
this ISilverbackBuilder silverbackBuilder,
TypeSubscriptionOptions options)
where TSubscriber : class
{
Check.NotNull(silverbackBuilder, nameof(silverbackBuilder));
Check.NotNull(options, nameof(options));
silverbackBuilder.BusOptions.Subscriptions.AddTypeSubscriptionIfNotExists(
typeof(TSubscriber),
options);
return(silverbackBuilder);
}
/// <summary>
/// Adds a scoped subscriber of the type specified in <paramref name="subscriberType" /> to the
/// <see cref="IServiceCollection" />.
/// </summary>
/// <param name="silverbackBuilder">
/// The <see cref="ISilverbackBuilder" /> that references the <see cref="IServiceCollection" /> to add
/// the subscriber to.
/// </param>
/// <param name="subscriberType">
/// The type of the subscriber to register and the implementation to use.
/// </param>
/// <param name="options">
/// The <see cref="TypeSubscriptionOptions" />.
/// </param>
/// <returns>
/// The <see cref="ISilverbackBuilder" /> so that additional calls can be chained.
/// </returns>
public static ISilverbackBuilder AddTransientSubscriber(
this ISilverbackBuilder silverbackBuilder,
Type subscriberType,
TypeSubscriptionOptions options)
{
Check.NotNull(silverbackBuilder, nameof(silverbackBuilder));
Check.NotNull(subscriberType, nameof(subscriberType));
Check.NotNull(options, nameof(options));
silverbackBuilder.Services.AddTransient(subscriberType);
silverbackBuilder.BusOptions.Subscriptions.AddTypeSubscriptionIfNotExists(
subscriberType,
options);
return(silverbackBuilder);
}
/// <summary>
/// Adds a singleton subscriber of the type specified in <typeparamref name="TSubscriber" /> with an
/// instance specified in <paramref name="implementationInstance" /> to the
/// <see cref="IServiceCollection" />.
/// </summary>
/// <typeparam name="TSubscriber">
/// The type of the subscriber to register.
/// </typeparam>
/// <param name="silverbackBuilder">
/// The <see cref="ISilverbackBuilder" /> that references the <see cref="IServiceCollection" /> to add
/// the subscriber to.
/// </param>
/// <param name="implementationInstance">
/// The instance of the service.
/// </param>
/// <param name="options">
/// The <see cref="TypeSubscriptionOptions" />.
/// </param>
/// <returns>
/// The <see cref="ISilverbackBuilder" /> so that additional calls can be chained.
/// </returns>
public static ISilverbackBuilder AddSingletonSubscriber <TSubscriber>(
this ISilverbackBuilder silverbackBuilder,
TSubscriber implementationInstance,
TypeSubscriptionOptions options)
where TSubscriber : class
{
Check.NotNull(silverbackBuilder, nameof(silverbackBuilder));
Check.NotNull(implementationInstance, nameof(implementationInstance));
Check.NotNull(options, nameof(options));
silverbackBuilder.Services.AddSingleton(implementationInstance);
silverbackBuilder.BusOptions.Subscriptions.AddTypeSubscriptionIfNotExists(
typeof(TSubscriber),
options);
return(silverbackBuilder);
}
/// <summary>
/// Adds a scoped subscriber of the type specified in <typeparamref name="TSubscriber" /> with a factory
/// specified in <paramref name="implementationFactory" /> to the <see cref="IServiceCollection" />.
/// </summary>
/// <typeparam name="TSubscriber">
/// The type of the subscriber to add.
/// </typeparam>
/// <param name="silverbackBuilder">
/// The <see cref="ISilverbackBuilder" /> that references the <see cref="IServiceCollection" /> to add
/// the subscriber to.
/// </param>
/// <param name="implementationFactory">
/// The factory that creates the service.
/// </param>
/// <param name="options">
/// The <see cref="TypeSubscriptionOptions" />.
/// </param>
/// <returns>
/// The <see cref="ISilverbackBuilder" /> so that additional calls can be chained.
/// </returns>
public static ISilverbackBuilder AddScopedSubscriber <TSubscriber>(
this ISilverbackBuilder silverbackBuilder,
Func <IServiceProvider, TSubscriber> implementationFactory,
TypeSubscriptionOptions options)
where TSubscriber : class
{
Check.NotNull(silverbackBuilder, nameof(silverbackBuilder));
Check.NotNull(implementationFactory, nameof(implementationFactory));
Check.NotNull(options, nameof(options));
silverbackBuilder.Services.AddScoped(implementationFactory);
silverbackBuilder.BusOptions.Subscriptions.AddTypeSubscriptionIfNotExists(
typeof(TSubscriber),
options);
return(silverbackBuilder);
}
/// <summary>
/// Adds a singleton subscriber of the type specified in <paramref name="subscriberType" /> with an
/// instance specified in <paramref name="implementationInstance" /> to the
/// <see cref="IServiceCollection" />.
/// </summary>
/// <param name="silverbackBuilder">
/// The <see cref="ISilverbackBuilder" /> that references the <see cref="IServiceCollection" /> to add
/// the subscriber to.
/// </param>
/// <param name="subscriberType">
/// The type of the subscriber to register.
/// </param>
/// <param name="implementationInstance">
/// The instance of the service.
/// </param>
/// <param name="options">
/// The <see cref="TypeSubscriptionOptions" />.
/// </param>
/// <returns>
/// The <see cref="ISilverbackBuilder" /> so that additional calls can be chained.
/// </returns>
public static ISilverbackBuilder AddSingletonSubscriber(
this ISilverbackBuilder silverbackBuilder,
Type subscriberType,
object implementationInstance,
TypeSubscriptionOptions options)
{
Check.NotNull(silverbackBuilder, nameof(silverbackBuilder));
Check.NotNull(subscriberType, nameof(subscriberType));
Check.NotNull(implementationInstance, nameof(implementationInstance));
Check.NotNull(options, nameof(options));
silverbackBuilder.Services.AddSingleton(subscriberType, implementationInstance);
silverbackBuilder.BusOptions.Subscriptions.AddTypeSubscriptionIfNotExists(
subscriberType,
options);
return(silverbackBuilder);
}
/// <summary>
/// Adds a scoped subscriber of the type specified in <paramref name="subscriberType" /> with a factory
/// specified in <paramref name="implementationFactory" /> to the <see cref="IServiceCollection" />.
/// </summary>
/// <param name="silverbackBuilder">
/// The <see cref="ISilverbackBuilder" /> that references the <see cref="IServiceCollection" /> to add
/// the subscriber to.
/// </param>
/// <param name="subscriberType">
/// The type of the subscriber to register.
/// </param>
/// <param name="implementationFactory">
/// The factory that creates the service.
/// </param>
/// <param name="options">
/// The <see cref="TypeSubscriptionOptions" />.
/// </param>
/// <returns>
/// The <see cref="ISilverbackBuilder" /> so that additional calls can be chained.
/// </returns>
public static ISilverbackBuilder AddScopedSubscriber(
this ISilverbackBuilder silverbackBuilder,
Type subscriberType,
Func <IServiceProvider, object> implementationFactory,
TypeSubscriptionOptions options)
{
Check.NotNull(silverbackBuilder, nameof(silverbackBuilder));
Check.NotNull(subscriberType, nameof(subscriberType));
Check.NotNull(implementationFactory, nameof(implementationFactory));
Check.NotNull(options, nameof(options));
silverbackBuilder.Services.AddScoped(subscriberType, implementationFactory);
silverbackBuilder.BusOptions.Subscriptions.AddTypeSubscriptionIfNotExists(
subscriberType,
options);
return(silverbackBuilder);
}
/// <summary>
/// Adds a singleton subscriber of the type specified in <typeparamref name="TSubscriber" /> to this
/// <see cref="ISilverbackBuilder" />.
/// </summary>
/// <typeparam name="TSubscriber">
/// The type of the subscriber to add.
/// </typeparam>
/// <param name="silverbackBuilder">
/// The <see cref="ISilverbackBuilder" /> that references the <see cref="IServiceCollection" /> to add
/// the subscriber to.
/// </param>
/// <param name="options">
/// The <see cref="TypeSubscriptionOptions" />.
/// </param>
/// <returns>
/// The <see cref="ISilverbackBuilder" /> so that additional calls can be chained.
/// </returns>
public static ISilverbackBuilder AddSingletonSubscriber <TSubscriber>(
this ISilverbackBuilder silverbackBuilder,
TypeSubscriptionOptions options)
where TSubscriber : class =>
AddSingletonSubscriber(silverbackBuilder, typeof(TSubscriber), options);
