Rystem.RepositoryFramework allows you to use correctly concepts like repository pattern, CQRS and DDD. You have interfaces for your domains, auto-generated api, auto-generated HttpClient to simplify connection "api to front-end", a functionality for auto-population in memory of your models, a functionality to simulate exceptions and waiting time from external sources to improve your implementation/business test and load test.
$ dotnet add package Rystem.RepositoryFramework.Api.ClientYou can add a client for a specific url
builder.Services.AddRepository<User, string>(builder =>
{
builder
.WithApiClient()
.WithHttpClient("localhost:7058");
});
You may add a Polly policy to your api client for example:
var retryPolicy = HttpPolicyExtensions
.HandleTransientHttpError()
.Or<TimeoutRejectedException>()
.RetryAsync(3);
builder.Services.AddRepository<User, string>(builder =>
{
builder
.WithApiClient()
.WithHttpClient("localhost:7058")
.ClientBuilder
.AddPolicyHandler(retryPolicy);
});
and use it in DI with
IRepository<User, string> repository
In DI you install the services
services.AddCommand<User, string>(builder => {
builder
.WithApiClient()
.WithHttpClient("localhost:7058");
});
services.AddQuery<User, string>(builder => {
builder
.WithApiClient()
.WithHttpClient("localhost:7058");
});
And you may inject the objects
ICommand<User, string> command
IQuery<User, string> command
In DI you install the services with a bool key for example.
services.AddRepository<User, bool>(builder => {
builder
.WithApiClient()
.WithHttpClient("localhost:7058");
});
services.AddCommand<User, bool>(builder => {
builder
.WithApiClient()
.WithHttpClient("localhost:7058");
});
services.AddQuery<User, bool>(builder => {
builder
.WithApiClient()
.WithHttpClient("localhost:7058");
});
And you may inject the objects
IRepository<User, string> repository
ICommand<User, string> command
IQuery<User, string> command
You may add a custom interceptor for every request for every model
public static IServiceCollection AddApiClientInterceptor<TInterceptor>(this IServiceCollection services,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped)
where TInterceptor : class, IRepositoryClientInterceptor
or a specific interceptor for each model
public static IServiceCollection AddApiClientInterceptor<TInterceptor>(this IServiceCollection services,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped)
where TInterceptor : class, IRepositoryClientInterceptor
or for a string as default TKey
public static RepositorySettings<T, TKey> AddApiClientSpecificInterceptor<T, TKey, TInterceptor>(
this RepositorySettings<T, TKey> settings,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped)
where TInterceptor : class, IRepositoryClientInterceptor<T>
where TKey : notnull
Maybe you can use it to add a token as JWT o another pre-request things.
You may use the default interceptor to deal with the identity manager in .Net DI.
builder.Services.AddDefaultAuthorizationInterceptorForApiHttpClient();
This line of code inject an interceptor that works with ITokenAcquisition, injected by the framework during OpenId integration (for example AAD integration). Automatically it adds the token to each request.
You may use the default identity interceptor not on all repositories, you can specificy them with
builder.Services.AddRepository(builder => {
builder
.WithApiClient()
.WithHttpClient("localhost:7058")
.AddCustomAuthorizationInterceptorForApiHttpClient<T, TKey>();
});