MediatR.Useful.Behavior 1.0.3

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 put all the useful requirements of the program in it.

Package - MediatR.Useful.Behavior

Currently, there are 2 very popular and efficient behaviors in this package

• Automatic caching with many features
• Automatic validation

Add the package to your application using

dotnet add package MediatR.Useful.Behavior

How to activate behaviors in the Startup.cs(or Program.cs) file

        // add AddAllBehaviors (cache, validation)
        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

        //for in memory cache (RAM)
        builder.Services.AddMemoryCache();

        //for distribute cache(Redis, Sql, ...)
        builder.Services.AddDistributedMemoryCache();

public sealed class TestCommandRq : IRequest<TestCommandRs>, ICacheableRequest<TestCommandRs>
{
    public long Amount { get; set; }
    public int UserId { get; set; }

    public string CacheKey => $"myKey.{UserId}";
    public Func<TestCommandRs, DateTimeOffset> 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:

public sealed class TestCommandAdRq : IRequest<TestCommandRs>, ICacheableRequest<TestCommandRs>
{
   public long Amount { get; set; }
   public int UserId { get; set; }

   public string CacheKey => $"myKey.{UserId}";
   public Func<TestCommandRs, DateTimeOffset> ConditionExpiration => rs =>
       UserId > 0 ? DateTimeOffset.Now.AddMinutes(10) : DateTimeOffset.Now.AddMinutes(1);
   public bool UseMemoryCache => false;
   public Func<TestCommandRs, bool> 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

public sealed class TestCommandRqValidation : AbstractValidator<TestCommandRq>
{
   public TestCommandRqValidation()
   {
       RuleFor(r => r.Amount).GreaterThan(0);
   }
}

Contributing

Create an issue 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 under the MIT License.