Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/engrajabi/mediatr.useful.behaviors
MediatR Useful Behavior In this repository; I tried to write and save the best popular behaviors that we use in mediatr in a professional way. And they will be added and improved over time. The best library to complete mediatr
https://github.com/engrajabi/mediatr.useful.behaviors
behavior behaviors cache caching enrich logging mediator mediator-pattern mediatr mediatr-behavior mediatr-extension
Last synced: 2 days ago
JSON representation
MediatR Useful Behavior In this repository; I tried to write and save the best popular behaviors that we use in mediatr in a professional way. And they will be added and improved over time. The best library to complete mediatr
- Host: GitHub
- URL: https://github.com/engrajabi/mediatr.useful.behaviors
- Owner: EngRajabi
- License: mit
- Created: 2022-12-22T09:27:11.000Z (about 2 years ago)
- Default Branch: develop
- Last Pushed: 2025-01-15T01:22:02.000Z (7 days ago)
- Last Synced: 2025-01-15T22:39:39.575Z (7 days ago)
- Topics: behavior, behaviors, cache, caching, enrich, logging, mediator, mediator-pattern, mediatr, mediatr-behavior, mediatr-extension
- Language: C#
- Homepage:
- Size: 109 KB
- Stars: 33
- Watchers: 2
- Forks: 4
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://raw.githubusercontent.com/EngRajabi/MediatR.Useful.Behaviors/master/LICENSE)
[](https://www.nuget.org/packages/MediatR.Useful.Behavior)
[](https://www.nuget.org/packages/MediatR.Useful.Behavior)
# The best behaviors of MediatR ( Enrich your mediatr project )
We all used mediatr many times. In mediatr, we have a very popular behavior feature that allows us to program aop and cross cutting. We have used it many times.
But it must have happened to you that you did not combine these behaviors together.
Instead of implementing these behaviors each time with our own knowledge, I decided to gather these behaviors together so that we can become better every day and have a collective participation in it.
In this package, I tried to collect the best and most useful behaviors of mediatr and Enrich your mediatr project. and put all the useful requirements of the program in it.
**Package** - [MediatR.Useful.Behavior](https://www.nuget.org/packages/MediatR.Useful.Behavior/)
**Currently, there are 4 very popular and efficient behaviors in this package
- Automatic caching with many features
- Automatic validation
- Automatic logging of unknown errors
- Logging slow commands
Add the package to your application using
```bash
dotnet add package MediatR.Useful.Behavior
```
# To use, you can add all behaviors at once. Or add each separately
- AddAllBehaviors: Add all behaviors
- AddCacheBehavior: Add behavior for cache
- AddValidationBehavior: Add validation behavior
- AddUnhandledExceptionBehavior: Add behavior for logging command exceptions
- AddPerformanceBehavior: Add behavior for logging slow commands (commands that take more than 1 second with warning log)
How to activate behaviors in the **Startup.cs(or Program.cs)** file
```csharp
// add AddAllBehaviors (cache, validation, unhandled log, performance log)
builder.Services.AddAllBehaviors();
```
By doing this, behaviors are added to the system. Also, all your validations are added to the system
# Cache
Your command must use the ICacheableRequest interface. This interface has several properties that must be set
To use cache, you must first introduce cache services to the system
```csharp
//for in memory cache (RAM)
builder.Services.AddMemoryCache();
//for distribute cache(Redis, Sql, ...)
builder.Services.AddDistributedMemoryCache();
```
```csharp
public sealed class TestCommandRq : IRequest, ICacheableRequest
{
public long Amount { get; set; }
public int UserId { get; set; }
public string CacheKey => $"myKey.{UserId}";
[JsonIgnore]
public Func ConditionExpiration => static _ => DateTimeOffset.Now.AddSeconds(10);
public bool UseMemoryCache => false;
}
```
Properties
- CacheKey:
CacheKey is your cache key. You can consider a simple key or the key can be a combination of values
- ConditionExpiration:
With ConditionExpiration you can consider a condition for cache expiration. For example, if the user role was equal to the admin value. The cache value should be 10 minutes. otherwise 10 seconds.
- UseMemoryCache:
If the specified value of UseMemoryCache is true, it means to use the memory cache. Otherwise, use distributed cache.
- ConditionFroSetCache:
You can decide based on your command output whether you need to cache or not.
For example, if the output of the user role list service is empty, it will not be cached.
Advanced example:
```csharp
public sealed class TestCommandAdRq : IRequest, ICacheableRequest
{
public long Amount { get; set; }
public int UserId { get; set; }
public string CacheKey => $"myKey.{UserId}";
[JsonIgnore]
public Func ConditionExpiration => res =>
UserId > 0 ? DateTimeOffset.Now.AddMinutes(10) : DateTimeOffset.Now.AddMinutes(1);
public bool UseMemoryCache => false;
[JsonIgnore]
public Func ConditionFroSetCache => rs => rs.Data?.Any() ?? false;
}
```
# Validation
Before executing your command, the system first executes all your validations.
For validation, you only need to define your model in this way
```csharp
public sealed class TestCommandRqValidation : AbstractValidator
{
public TestCommandRqValidation()
{
RuleFor(r => r.Amount).GreaterThan(0);
}
}
```
# Performance Log
If the command takes more than 1 second. The system records a warning log. With complete specifications of the command and input data.
example log
```csharp
Performance Long Running Request: TestCommandRq 3274 millisecond. {"amount":10000,"userId":0,"cacheKey":"myKey.0","useMemoryCache":false}
```
# Unhandled Log
If an Exception occurs in the command. This behavior records a log with full details.
example log
```csharp
Exception Request: Unhandled Exception for Request TestCommandRq {"amount":0,"userId":0,"cacheKey":"myKey.0","useMemoryCache":false}
FluentValidation.ValidationException: Validation failed:
-- Amount: 'Amount' must be greater than '0'. Severity: Error
at MediatR.Useful.Behavior.Behavior.ValidationBehaviour`2.Handle(TRequest request, RequestHandlerDelegate`1 next, CancellationToken cancellationToken) in F:\Projects\mediatR-useful-behavior\src\MediatR.Useful.Behavior\Behavior\ValidationBehaviour.cs:line 36
at MediatR.Useful.Behavior.Behavior.UnhandledExceptionBehaviour`2.Handle(TRequest request, RequestHandlerDelegate`1 next, CancellationToken cancellationToken) in F:\Projects\mediatR-useful-behavior\src\MediatR.Useful.Behavior\Behavior\UnhandledExceptionBehaviour.cs:line 21
```
## Contributing
Create an [issue](https://github.com/EngRajabi/MediatR.Useful.Behaviors/issues/new) if you find a BUG or have a Suggestion or Question. If you want to develop this project :
1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request
## Give a Star! ⭐️
If you find this repository useful, please give it a star. Thanks!
## License
MediatR.Useful.Behaviors is Copyright © 2022 [Mohsen Rajabi](https://github.com/EngRajabi) under the MIT License.