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.
Get Started
$ dotnet add package Rystem.RepositoryFramework.Api.ClientReadme
What is Rystem?
Services extensions
You may add a repository client for your model. You may choose the domain (domain where the api is), and the custom path by default is "api", you may add custom configuration to the HttpClient and the service lifetime with singleton as default. The api url will be https://{domain}/{startingPath}/{ModelName}/{Type of Api (from Insert, Update, Delete, Get, Query, Exist)}
public static RepositoryBuilder<T, TKey> AddRepositoryApiClient<T, TKey>(this IServiceCollection services,
string domain,
string startingPath = "api",
Action<HttpClient>? configureClient = null,
ServiceLifetime serviceLifetime = ServiceLifetime.Singleton)
where TKey : notnull
You have the same client for CQRS, with command
public static RepositoryBuilder<T, TKey> AddCommandApiClient<T, TKey>(this IServiceCollection services,
string domain,
string startingPath = "api",
Action<HttpClient>? configureClient = null,
ServiceLifetime serviceLifetime = ServiceLifetime.Singleton)
where TKey : notnull
and query
public static RepositoryBuilder<T, TKey> AddQueryApiClient<T, TKey>(this IServiceCollection services,
string domain,
string startingPath = "api",
Action<HttpClient>? configureClient = null,
ServiceLifetime serviceLifetime = ServiceLifetime.Singleton)
where TKey : notnull
HttpClient to use your API (example)
You can add a client for a specific url
services.AddRepositoryApiClient<User, string>("localhost:7058");
and use it in DI with
IRepository<User, string> repository
Query and Command
In DI you install the services
services.AddCommandApiClient<User, string>("localhost:7058");
services.AddQueryApiClient<User, string>("localhost:7058");
And you may inject the objects
ICommand<User, string> command
IQuery<User, string> command
With TState
In DI you install the services, We're using a class Result as TState.
services.AddRepositoryApiClient<User, string, Result>("localhost:7058");
services.AddCommandApiClient<User, string, Result>("localhost:7058");
services.AddQueryApiClient<User, string, Result>("localhost:7058");
And you may inject the objects
IRepository<User, string, Result> repository
ICommand<User, string, Result> command
IQuery<User, string, Result> command
With string as default TKey
In DI you install the services
services.AddRepositoryApiClient<User>("localhost:7058");
services.AddCommandApiClient<User>("localhost:7058");
services.AddQueryApiClient<User>("localhost:7058");
And you may inject the objects
IRepository<User> repository
ICommand<User> command
IQuery<User> command
Interceptors
You may add a custom interceptor for every request
public static IServiceCollection AddRepositoryApiClientInterceptor<TInterceptor>(this IServiceCollection services,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped)
where TInterceptor : class, IRepositoryClientInterceptor
or a specific interceptor for every model
public static RepositoryBuilder<T, TKey, TState> AddApiClientSpecificInterceptor<T, TKey, TState, TInterceptor>(this RepositoryBuilder<T, TKey, TState> builder,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped)
where TInterceptor : class, IRepositoryClientInterceptor<T>
where TKey : notnull
or for a State as default TState
public static RepositoryBuilder<T, TKey> AddApiClientSpecificInterceptor<T, TKey, TInterceptor>(this RepositoryBuilder<T, TKey> builder,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped)
where TInterceptor : class, IRepositoryClientInterceptor<T>
where TKey : notnull
or for a State as default TState and string as default TKey
public static RepositoryBuilder<T> AddApiClientSpecificInterceptor<T, TInterceptor>(this RepositoryBuilder<T> builder,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped)
where TInterceptor : class, IRepositoryClientInterceptor<T>
Maybe you can use it to add a token as JWT o another pre-request things.
Default interceptor for Authentication with JWT
You may use the default interceptor to deal with the identity manager in .Net DI.
builder.Services.AddApiClientAuthorizationInterceptor();
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.AddApiClientSpecificAuthorizationInterceptor<YourModel>();