Migration guide 4.1.0 > 5.0.1

Is there any plans for a migration guide, noticed Task<Unit> being used since the latest update. Current Wiki documentation doesn’t mention anything as of yet. Noticed the release is very new so potentially in the works?

More than happy to chip in if I can help anywhere.

[delight-by]

@TheRubble you can get rid of the Unit (specifically return Unit.Value) in handlers by using AsyncRequestHandler<Request>. Other places you’ll ever encounter the Unit are IMediator.Send that returns Task<Unit> and calling handlers without MediatR in tests - no big deal.

@jbogard What I don’t understand though is where the AsyncRequestHandler<Request, Response> did go? It’s absence now forces devs to use AsyncRequestHandler in one handlers and IRequestHandler in others - one more illogical thing for a new dev on the project to learn. Any plans to return it?

[jbogard]

Just to summarize the changes, there are 2 main flavors of requests: those that return a value, and those that do not. The ones that do not now implement IRequest<T> where T : Unit. This was to unify requests and handlers into one single type. The diverging types broke the pipeline for many containers, the unification means you can use pipelines for any kind of request.

It forced me to add the Unit type in all cases, so I’ve added some helper classes for you.

• IRequestHandler<T> - implement this and you will return Task<Unit>.
• AsyncRequestHandler<T> - inherit this and you will return Task.
• RequestHandler<T> - inherit this and you will return nothing (void).

For requests that do return values:

• IRequestHandler<T, U> - you will return Task<U>
• RequestHandler<T, U> - you will return U

I got rid of the AsyncRequestHandler<T, U> because it really wasn’t doing anything after the consolidation, a redundant base class.