В общих чертах механизм MediatR устроен довольно несложно. Для начала необходимо добавить в проект NuGet-пакет MediatR. В программе должны быть определены различные задачи, которые системе предстоит выполнять (к примеру, добавление элемента в список дел, смена имени пользователя и т.п.). В терминологии MediatR такие задачи именуются запросами. Они представляют собой простые классы, которые наследуют интерфейс IRequest. Этот интерфейс выступает в роли маркера и не содержит никаких методов или свойств.
class CreateToDoItem : IRequest{ public string ToDoItemText { get; set; }}
Подобные классы не включают в себя бизнес-логику. Их задача — служить контейнерами для данных, которые нужны для совершения операции.
Для чего же нужен параметр T в интерфейсе IRequest? Дело в том, что операции могут возвращать какие-либо данные. Допустим, при добавлении новой записи в список дел может понадобиться её уникальный номер. Именно для этих целей и предусмотрен параметр T. В приведённом примере мы ожидаем получить числовой идентификатор созданной задачи.
Далее потребуется код, который непосредственно реализует нужную логику. В MediatR эта часть называется обработчиком запроса. Такой обработчик должен имплементировать интерфейс IRequestHandler<TRequest, TResponse>, причём TRequest обязательно должен быть наследником IRequest<TResponse>:
class CreateToDoItemHandler : IRequestHandler<CreateToDoItem, int> { public Task<int> Handle(CreateToDoItem request, CancellationToken cancellationToken) { ... } }
Данный интерфейс обязывает нас создать метод Handle, который в асинхронном режиме выполняет необходимые действия и возвращает результат.
Финальный шаг — связать запрос с его обработчиком. В MediatR для этой цели применяется контейнер внедрения зависимостей. Если вы работаете с ASP.NET Core, удобно использовать пакет MediatR.Extensions.Microsoft.DependencyInjection. Однако MediatR совместим и с множеством других контейнеров.
services.AddMediatR(typeof(Startup));
Поясним: services — это объект, реализующий интерфейс IServiceCollection, который обычно доступен внутри метода ConfigureServices в классе Startup. Указанная команда анализирует сборку, где находится класс Startup, и автоматически регистрирует все обнаруженные обработчики запросов.
Теперь можно отправлять запросы на выполнение. Для этого понадобится объект, реализующий интерфейс IMediator. Он также автоматически регистрируется в контейнере при вызове AddMediatR.
var toDoItemId = await mediator.Send(createToDoItemRequest);
Всё работает просто: MediatR самостоятельно отыскивает подходящий обработчик для переданного запроса, запускает его и возвращает полученный результат.


