Configuring MediatR

Apizr offers an integration with MediatR, following the Mediator pattern, available only with the extended approach. Mediator pattern ensures to keep all the thing as loosely coupled as we can between our ViewModel/ViewControler and our Data Access Layer. As everything should be loosely coupled between Views and ViewModels (MVVM) or ViewControlers (MVC) thanks to data binding, MediatR offers you to keep it all loosely coupled between your VM/VC and your DAL too. Please read the official documentation to know more about MediatR. The main benefit in using it with Apizr is to offer you a very simple and unified way to send your request, no matter from where or about what. Simple and unified because instead of injecting/resolving each api interface you need to get your data, you just have to use the IMediator interface, everywhere, every time.

Registering

Please first install this integration package:

Project	Current	V-Next
Apizr.Integrations.MediatR

Then you'll be able to register with this option:

options => options.WithMediation()

And don't forget to register MediatR itself as usual:

services.AddMediatR(YOUR_REQUESTHANDLER_ASSEMBLIES);

Where YOUR_REQUESTHANDLER_ASSEMBLIES should be the assemblies containing your custom request handlers, if you get some (Apizr MediatR request handlers will be auto registered).

Using

When registered, you don't have to inject/resolve anything else than IMediator, in order to play with your api services (both classic and crud). Everything you need to do then, is sending your request by calling:

var result = await _mediator.Send(YOUR_REQUEST_HERE);

Where YOUR_REQUEST_HERE could be:

Classic API:

With no result:
- ExecuteUnitRequest<TWebApi>: execute any method from TWebApi
- ExecuteUnitRequest<TWebApi, TModelData, TApiData>: execute any method from TWebApi with TModelData mapped with TApiData
With result:
- ExecuteResultRequest<TWebApi, TApiData>: execute any method from TWebApi with a TApiData request/result data
- ExecuteResultRequest<TWebApi, TModelData, TApiData>: execute any method from TWebApi with TModelData request/result data mapped with TApiData
- ExecuteResultRequest<TWebApi, TModelResultData, TApiResultData, TApiRequestData, TModelRequestData>: execute any method from TWebApi, sending TApiRequestData mapped from TModelRequestData, then returning TModelResultData mapped from TApiResultData

CRUD API:

Read:
- ReadQuery<TResultData>: get the TResultData entity matching an int key
- ReadQuery<TResultData, TKey>: get the TResultData entity matching a TKey
ReadAll:
- ReadAllQuery<TReadAllResult>: get TReadAllResult with IDictionary<string, object> optional query parameters
- ReadAllQuery<TReadAllParams, TReadAllResult>: get TReadAllResult with TReadAllParams optional query parameters
Create:
- CreateCommand<TModelData>: create a TModelData entity
Update:
- UpdateCommand<TRequestData>: update the TRequestData entity matching an int key
- UpdateCommand<TKey, TRequestData>: update the TRequestData entity matching a TKey
Delete:
- DeleteCommand<T>: delete the T entity matching an int key
- DeleteCommand<T, TKey>: delete the T entity matching a TKey

Writting things shorter, instead of injecting/resolving IMediator, you could do it with IApizrMediator or IApizrCrudMediator. Everything you need to do then, is sending your request by calling something like:

// Classic
var result = await _apizrMediator.SendFor<TWebApi>(YOUR_API_METHOD_HERE);

// OR CRUD
var result = await _apizrCrudMediator.SendReadAllQuery<TReadAllResult>();

Classic mediator methods:

No result:
- SendFor<TWebApi>: execute any method from TWebApi
- SendFor<TWebApi, TModelData, TApiData>: execute any method from TWebApi with TModelData mapped with TApiData
With result:
- SendFor<TWebApi, TApiData>: execute any method from TWebApi with a TApiData request/result data
- SendFor<TWebApi, TModelData, TApiData>: execute any method from TWebApi with TModelData request/result data mapped with TApiData
- SendFor<TWebApi, TModelResultData, TApiResultData, TApiRequestData, TModelRequestData>: execute any method from TWebApi, sending TApiRequestData mapped from TModelRequestData, then returning TModelResultData mapped from TApiResultData

CRUD mediator methods:

Read:
- SendReadQuery<TApiEntity, TApiEntityKey>: get the TApiEntity matching a TApiEntityKey
- SendReadQuery<TModelEntity, TApiEntity, TApiEntityKey>: get the TModelEntity mapped from TApiEntity and matching a TApiEntityKey
ReadAll:
- SendReadAllQuery<TReadAllResult>: get TReadAllResult with IDictionary<string, object> optional query parameters
- SendReadAllQuery<TModelReadAllResult, TApiReadAllResult>: get TModelReadAllResult mapped from TApiReadAllResult
- SendReadAllQuery<TReadAllResult, TReadAllParams>: get TReadAllResult with TReadAllParams optional query parameters
- SendReadAllQuery<TModelReadAllResult, TApiReadAllResult, TReadAllParams>: get TModelReadAllResult mapped from TApiReadAllResult with TReadAllParams optional query parameters
Create:
- SendCreateCommand<TApiEntity>: create a TApiEntity
- SendCreateCommand<TModelEntity, TApiEntity>: create a TApiEntity mapped from TModelEntity
Update:
- SendUpdateCommand<TApiEntity, TApiEntityKey>: update the TApiEntity entity matching a TApiEntityKey
- SendUpdateCommand<TModelEntity, TApiEntity, TApiEntityKey>: update the TApiEntity mapped from TModelEntity and matching a TApiEntityKey
Delete:
- SendDeleteCommand<TApiEntity, TApiEntityKey>: delete the TApiEntity matching a TApiEntityKey

Writting things shorter than ever, instead of injecting/resolving IMediator, IApizrMediator or IApizrCrudMediator, you could do it with IApizrMediator<TWebApi> or IApizrCrudMediator<TApiEntity, TApiEntityKey, TReadAllResult, TReadAllParams>.

Tip

Apizr Registry

Note that if you were using the registry feature while configuring, you'll be able to inject/resolve IApizrMediationRegistry instead and then just get an IApizrMediator<TWebApi> or IApizrCrudMediator<TApiEntity, TApiEntityKey, TReadAllResult, TReadAllParams> thanks to its Get methods.

Everything you need to do then, is sending your request by calling something like:

// Classic
var result = await _apizrMediator.SendFor(YOUR_API_METHOD_HERE);

// OR CRUD
var result = await _apizrCrudMediator.SendReadAllQuery();

Classic typed mediator methods:

No result:
- SendFor: execute any method from TWebApi
- SendFor<TModelData, TApiData>: execute any method from TWebApi with TModelData mapped with TApiData
With result:
- SendFor<TApiData>: execute any method from TWebApi with a TApiData request/result data
- SendFor<TModelData, TApiData>: execute any method from TWebApi with TModelData request/result data mapped with TApiData
- SendFor<TModelResultData, TApiResultData, TApiRequestData, TModelRequestData>: execute any method from TWebApi, sending TApiRequestData mapped from TModelRequestData, then returning TModelResultData mapped from TApiResultData

CRUD typed mediator methods:

Read:
- SendReadQuery: get the TApiEntity matching a TApiEntityKey
- SendReadQuery<TModelEntity>: get the TModelEntity mapped from TApiEntity and matching a TApiEntityKey
ReadAll:
- SendReadAllQuery: get TReadAllResult with TReadAllParams optional query parameters
- SendReadAllQuery<TModelReadAllResult>: get TModelReadAllResult mapped from TApiReadAllResult with TReadAllParams optional query parameters
Create:
- SendCreateCommand: create a TApiEntity
- SendCreateCommand<TModelEntity>: create a TApiEntity mapped from TModelEntity
Update:
- SendUpdateCommand: update the TApiEntity entity matching a TApiEntityKey
- SendUpdateCommand<TModelEntity>: update the TApiEntity mapped from TModelEntity and matching a TApiEntityKey
Delete:
- SendDeleteCommand: delete the TApiEntity matching a TApiEntityKey