# ricardorueda/mediatr architecture

> Architecture diagram of the GitHub repository ricardorueda/mediatr, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ricardorueda/mediatr
- Repository: https://github.com/ricardorueda/mediatr

## Overview

##### Project type and purpose
- MediatR is an open-source .NET library (in-process messaging framework) implementing the Mediator pattern. It provides a zero-dependency core engine plus a contracts-only package, DI integration, pipeline behaviors, and sample applications demonstrating usage with various DI containers.

##### File structure
- Top-level directories:
- src – two projects:
◦ MediatR.Contracts (defines IRequest, INotification, IStreamRequest, Unit)
◦ MediatR (core implementation)
- samples – sample console/ASP.NET Core apps showing integration with Autofac, DryIoc, Lamar, LightInject, SimpleInjector, Windsor, Microsoft.Extensions.DependencyInjection, and custom publish strategies
- test – unit tests (MediatR.Tests) and benchmarks (MediatR.Benchmarks)
- Key sub-folders under src/MediatR:
- Entities, Internal – core object graphs and ordering logic
- Pipeline – pre/post processors, exception handlers, open-generic behaviors
- NotificationPublishers – different strategies for Publish (Task.WhenAll, foreach-await)
- MicrosoftExtensionsDI – ServiceCollectionExtensions and ServiceRegistrar for wiring into the Microsoft DI container
- Registration – centralized registration logic
- Wrappers – adapter classes for handlers
- Build scripts (Build.ps1, Push.ps1), GitHub workflows, NuGet.Config, and solution file tie everything together.

##### README for additional insights
- Purpose: “Simple mediator implementation in .NET,” supports request/response, commands, queries, notifications, streaming, sync/async, generic variance.
- Highlights: contracts-only package, DI registration via IServiceCollection extensions, ability to add custom behaviors, pre/post processors, stream behaviors, exception handlers.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Consumer Apps"
        Consumer["Consumer App"]:::samples
    end

    Contracts["MediatR.Contracts"]:::contracts
    ContractsDefs["IRequest / INotification / IStreamRequest / Unit"]:::contracts

    subgraph "Mediator Core"
        MediatorCore["Mediator Core"]:::core
        IMediator["IMediator / ISender / IPublisher"]:::core
        MediatorCs["Mediator.cs"]:::core
        NotificationHandlerExecutor["NotificationHandlerExecutor"]:::core
        Entities["Entities / Internal"]:::core
    end

    subgraph "Pipeline Behaviors"
        PreProc["RequestPreProcessorBehavior"]:::pipeline
        PostProc["RequestPostProcessorBehavior"]:::pipeline
        ExceptionProc["RequestExceptionProcessorBehavior"]:::pipeline
        OpenGeneric["Open-generic Behaviors"]:::pipeline
    end

    subgraph "Notification Publishers"
        TaskAll["TaskWhenAllPublisher"]:::core
        Foreach["ForeachAwaitPublisher"]:::core
    end

    subgraph "DI Integration"
        ServiceCollectionExt["ServiceCollectionExtensions"]:::di
        MediatrServiceConfig["MediatrServiceConfiguration"]:::di
        ExceptionStrategy["RequestExceptionActionProcessorStrategy"]:::di
    end

    Registration["ServiceRegistrar"]:::di

    subgraph "Wrappers"
        NotifWrapper["NotificationHandlerWrapper"]:::core
        ReqWrapper["RequestHandlerWrapper"]:::core
        StreamWrapper["StreamRequestHandlerWrapper"]:::core
    end

    container[(DI Container)]:::container

    Consumer -->|"calls Send/Publish"| IMediator
    IMediator -->|uses| MediatorCs
    MediatorCs -->|resolves via| ServiceFactory[/"ServiceFactory"/]:::di
    ServiceFactory -->|resolves| PreProc
    ServiceFactory -->|resolves| PostProc
    ServiceFactory -->|resolves| ExceptionProc
    ServiceFactory -->|resolves| OpenGeneric
    ServiceFactory -->|resolves| ReqWrapper
    ServiceFactory -->|resolves| NotifWrapper
    ServiceFactory -->|resolves| StreamWrapper
    MediatorCs -->|"executes notifications"| NotificationHandlerExecutor
    NotificationHandlerExecutor -->|uses| TaskAll
    NotificationHandlerExecutor -->|uses| Foreach
    ServiceCollectionExt -->|registers types into| container
    MediatrServiceConfig -->|configures| container
    ExceptionStrategy -->|configures| container
    Registration -->|registers handlers| container
    container -->|resolves| IMediator

    Contracts -->|defines contracts for| IMediator
    Contracts -->|contains definitions| ContractsDefs

    click Contracts "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR.Contracts"
    click ContractsDefs "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR.Contracts/IRequest.cs"
    click ContractsDefs "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR.Contracts/INotification.cs"
    click ContractsDefs "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR.Contracts/IStreamRequest.cs"
    click ContractsDefs "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR.Contracts/Unit.cs"
    click Contracts "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR.Contracts/MediatR.Contracts.csproj"
    click MediatorCs "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Mediator.cs"
    click IMediator "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/IMediator.cs"
    click ServiceCollectionExt "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/MicrosoftExtensionsDI/ServiceCollectionExtensions.cs"
    click MediatrServiceConfig "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/MicrosoftExtensionsDI/MediatrServiceConfiguration.cs"
    click ExceptionStrategy "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/MicrosoftExtensionsDI/RequestExceptionActionProcessorStrategy.cs"
    click Registration "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Registration/ServiceRegistrar.cs"
    click TaskAll "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/NotificationPublishers/TaskWhenAllPublisher.cs"
    click Foreach "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/NotificationPublishers/ForeachAwaitPublisher.cs"
    click PreProc "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Pipeline/RequestPreProcessorBehavior.cs"
    click PostProc "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Pipeline/RequestPostProcessorBehavior.cs"
    click ExceptionProc "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Pipeline/RequestExceptionProcessorBehavior.cs"
    click OpenGeneric "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Pipeline/IRequestPreProcessor.cs"
    click NotifWrapper "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Wrappers/NotificationHandlerWrapper.cs"
    click ReqWrapper "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Wrappers/RequestHandlerWrapper.cs"
    click StreamWrapper "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Wrappers/StreamRequestHandlerWrapper.cs"
    click NotificationHandlerExecutor "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/NotificationHandlerExecutor.cs"
    click Entities "https://github.com/ricardorueda/mediatr/blob/master/src/MediatR/Entities/OpenBehavior.cs"

    classDef core fill:#D0E8FF,stroke:#0366d6
    classDef contracts fill:#E5E5E5,stroke:#666666
    classDef pipeline fill:#FFF4D6,stroke:#D4A017,stroke-dasharray:5 5
    classDef di fill:#D6F5D6,stroke:#2E8B57
    classDef container fill:#FFFFFF,stroke:#228B22,stroke-width:2,shape:cylinder
    classDef samples fill:#FFE5B4,stroke:#FFA500
```
