https://github.com/shinyorg/mediator

A Mediator for your .NET Apps with some of the most awesome middleware around
https://github.com/shinyorg/mediator

Last synced: about 1 month ago
JSON representation

A Mediator for your .NET Apps with some of the most awesome middleware around

• Host: GitHub
• URL: https://github.com/shinyorg/mediator
• Owner: shinyorg
• License: mit
• Created: 2024-04-27T17:24:09.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-09-16T00:42:00.000Z (3 months ago)
• Last Synced: 2024-09-17T01:42:28.527Z (3 months ago)
• Language: C#
• Homepage:
• Size: 562 KB
• Stars: 20
• Watchers: 0
• Forks: 3
• Open Issues: 6
• Metadata Files:
  • Readme: readme.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-dotnet-maui - Shiny Mediator - square)](https://github.com/shinyorg/mediator/stargazers)|[](https://github.com/shinyorg/mediator/commits) (Plugins)

README

        
# Shiny Mediator



  



Mediator is a behavioral design pattern that lets you reduce chaotic dependencies between objects. The pattern restricts direct communications between the objects and forces them to collaborate only via a mediator object.

Shiny Mediator is a mediator pattern implementation, works for server, but also works great for apps.  Apps have pages with lifecycles that don't necessarily participate in the standard

dependency injection lifecycle.  .NET MAUI generally tends to favor the Messenger pattern.  We hate this pattern for many reasons

which we won't get into.  That being said, we do offer a messenger subscription in our Mediator for where interfaces

and dependency injection can't reach.

This project is heavily inspired by [MediatR](https://github.com/jbogard/mediatr) with some lesser features that we feel

were aimed more at server scenarios, while also adding some features we feel benefit apps

## Links

- Docs

  - [Main](https://shinylib.net/client/mediator/)

  - [Quick Start](https://shinylib.net/client/mediator/quick-start/)

- [Sample](https://github.com/shinyorg/mediator/tree/main/Sample)

- [End-to-End Architectural Layout Sample](https://github.com/shinyorg/mediatorsample)

## Features

- A Mediator for your .NET Apps (ASP.NET, Blazor, MAUI, basically anywhere in .NET)

- Request/Response "Command" Handling

- Event Publication

- Request & event middleware with some great "out of the box" scenarios for your app

- Think of "weak" message subscriptions without the fuss or mess to cleanup

- Our MAUI & Blazor integrations allow your viewmodels or pages to implement an IEventHandler interface(s) without them having to participate in the dependency injection provider

- We still have a "messagingcenter" type subscribe off IMediator for cases where you can't have your current type implement an interface

- Instead of Assembly Scanning, we have source generators to automatically wireup the necessary registrations for you! (WIP)

- Lightweight, No external dependencies, tiny bit of reflection

- Help remove service overrun and reduce your constructor fat

- Easy to Unit Test

- Direct Handler to ASP.NET Core endpoint

- OpenAPI Contract & Handler Generation

- Epic Out-of-the-Box Middleware

  - Offline Storage

  - Validation with Data Annotations or FluentValidation

  - Caching

  - Resiliency

  - User Exception Handling notifications

  - Exception Handling logging

  - Performance Time Logging

  - Main Thread Dispatching

  - Replayable Streams

  - Refresh Timer Streams

  - Registration straight from startup to mediator (we do the minimal api reg for you)

## Works With

- .NET MAUI

- Blazor Web Assembly

- ASP.NET Core - Handler to Endpoint

- MVVM Frameworks like Prism, ReactiveUI, & .NET MAUI Shell

- Any other .NET platform - but you'll have to come up with your own "event collector" for the out-of-state stuff