Add named registration for mongodb options

[snovak7]

Summary

We need options mechanism for registering MongoDb Client. Extensions methods are used here to have a good DX (developer experience)

Expectations

We have 3 different interfaces where we want to do register options for MongoDb Client

IServiceCollection - Console Apps, Manual Service Collection initialization
IHostBuilder - Orleans Server without Kestrel, ASP.NET Core Workers
WebApplicationBuilder/IApplicationBuilder - Orleans Server with Kestrel, ASP.NET Core Web Apps

⚠️ Each can be an entrypoint

sequenceDiagram

participant WebApplicationBuilder
participant IHostBuilder
participant IServiceCollection

WebApplicationBuilder->>IHostBuilder: Uses Host Property
IHostBuilder->>IServiceCollection: Uses ConfigureServices
IServiceCollection->>IServiceCollection: Registers needed services.
IServiceCollection->>IHostBuilder: Returns to HostBuilder
IHostBuilder->>WebApplicationBuilder: Returns to WebApplicationBuilder

Loading

This concept applies for all registration. Eventually need to dump this in a knowledge base!

Use cases

IServiceCollection

This interface registers only lowest level

Default

public static IServiceCollection AddMongoDbClientOptionsAsDefault(this IServiceCollection services, Action<MongoDbOptions> configureOptions) {...}

Named

public static IServiceCollection AddMongoDbClientOptions(this IServiceCollection services, string name, Action<MongoDbOptions>? configureOptions) {...}

IHostBuilder

Default

public static IHostBuilder AddMongoDbClientOptionsAsDefault(this IHostBuilder hostBuilder, Action<MongoDbOptions> configureOptions) {...}

Named

public static IHostBuilder AddMongoDbClientOptions(this IHostBuilder hostBuilder, string name, Action<MongoDbOptions> configureOptions) {...}

Because IHostBuilder has Configuration we can also apply 2 more overloads for each

With Options Builder

public static IHostBuilder AddMongoDbClientOptions(..., Action<OptionsBuilder<MongoDbOptions>> configureOptions) {...}

Bind directly to App Settings

public static IHostBuilder AddMongoDbClientOptions(..., string configSectionPath) {...}

WebApplicationBuilder

This one mostly applies all extensions method from IHostBuilder directly to .Host Property (Proxy)