Rystem.RepositoryFramework.Cache 6.2.0

There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Rystem.RepositoryFramework.Cache --version 6.2.0                
NuGet\Install-Package Rystem.RepositoryFramework.Cache -Version 6.2.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Rystem.RepositoryFramework.Cache" Version="6.2.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Rystem.RepositoryFramework.Cache --version 6.2.0                
#r "nuget: Rystem.RepositoryFramework.Cache, 6.2.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Rystem.RepositoryFramework.Cache as a Cake Addin
#addin nuget:?package=Rystem.RepositoryFramework.Cache&version=6.2.0

// Install Rystem.RepositoryFramework.Cache as a Cake Tool
#tool nuget:?package=Rystem.RepositoryFramework.Cache&version=6.2.0                

What is Rystem?

Cache

Examples

You can add a repository (with default blob integration for instance) and after attack an in memory cache for all methods. The RefreshTime is a property that adds an Expiration date to the cached value, in the example below you can see that after 20 seconds the in memory cache requests again to the repository pattern a new value for each key. The Methods is a flag that allows to setup what operations have to be cached.

Query → query will be cached with this key

var keyAsString = $"{nameof(RepositoryMethods.Query)}_{typeof(T).Name}_{FactoryName}_{filter.ToKey()}";

Operation → operation will be cached with this key

var keyAsString = $"{nameof(RepositoryMethods.Operation)}_{operation.Name}_{typeof(T).Name}_{FactoryName}_{filter.ToKey()}";

Get → query will be cached with this key

var keyAsString = $"{nameof(RepositoryMethods.Get)}_{typeof(T).Name}_{FactoryName}_{key.AsString()}";

Exist → query will be cached with this key

var keyAsString = $"{nameof(RepositoryMethod.Exist)}_{typeof(T).Name}_{FactoryName}_{key.AsString()}";

Now you can understand the special behavior for commands. If you set Insert and/or Update and/or Delete, during any command if you allowed it for each command automatically the framework will update the cache value, with updated or inserted value or removing the deleted value. The code below allows everything

x.Methods = RepositoryMethod.All

In the example below you're setting up the following behavior: setting up a cache only for Get operation, and update the Get cache when exists a new Insert or an Update, or a removal when Delete operation were perfomed.

x.Methods = RepositoryMethod.Get | RepositoryMethod.Insert | RepositoryMethod.Update | RepositoryMethod.Delete

Setup in DI

services
    .AddRepository<Plant, int>(settings =>
    {
        settings
            .WithInMemory();
        settings
            .WithInMemoryCache(x =>
            {
                x.ExpiringTime = TimeSpan.FromSeconds(1);
                x.Methods = RepositoryMethods.All;
            });
    });

Usage

You always will find the same interface. For instance

IRepository<Plant, int> repository

or if you added a query pattern or command pattern

IQuery<Plant, int> query 
ICommand<Plant, int> command

Distributed Cache

Based on this link you may use the standard interface IDistributedCache instead of create a custom IDistributedCache<T, TKey, TState>. For instance you may choose between three libraries: Distributed SQL Server cache, Distributed Redis cache, Distributed NCache cache. You need to add the cache

builder.Services.AddStackExchangeRedisCache(options =>
 {
     options.Configuration = builder.Configuration.GetConnectionString("MyRedisConStr");
     options.InstanceName = "SampleInstance";
 });

then you add the IDistributedCache implementation to your repository patterns or CQRS.

.AddRepository<Country, CountryKey>(builder =>
{
    builder
        .WithInMemory(inMemoryBuilder =>
        {
            inMemoryBuilder
                .PopulateWithRandomData(NumberOfEntries, NumberOfEntries);
        });
    builder
        .WithDistributedCache(distributedCacheBuilder =>
        {
            distributedCacheBuilder.ExpiringTime = TimeSpan.FromSeconds(10);
        });
});

or a mix of them

.AddRepository<Country, CountryKey>(builder =>
{
    builder
        .WithInMemory(inMemoryBuilder =>
        {
            inMemoryBuilder
                .PopulateWithRandomData(NumberOfEntries, NumberOfEntries);
        });
    builder
        .WithInMemoryCache(inMemoryCacheBuilder =>
        {
            inMemoryCacheBuilder.ExpiringTime = TimeSpan.FromSeconds(10);
        })
        .WithDistributedCache(distributedCacheBuilder =>
        {
            distributedCacheBuilder.ExpiringTime = TimeSpan.FromSeconds(10);
        });
});

and as always you will use the standard interface that is automatically integrated in the repository flow.

IRepository<User, string> repository;

The same is valid for ICommand and IQuery.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Rystem.RepositoryFramework.Cache:

Package Downloads
Rystem.RepositoryFramework.Cache.Azure.Storage.Blob

Rystem.RepositoryFramework allows you to use correctly concepts like repository pattern, CQRS and DDD. You have interfaces for your domains, auto-generated api, auto-generated HttpClient to simplify connection "api to front-end", a functionality for auto-population in memory of your models, a functionality to simulate exceptions and waiting time from external sources to improve your implementation/business test and load test.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
9.0.0-rc.1 70 10/18/2024
6.2.0 181,901 10/9/2024
6.1.1 90 10/9/2024
6.1.0 47,844 9/29/2024
6.0.24 111 9/11/2024
6.0.23 103 7/18/2024
6.0.21 120 6/18/2024
6.0.20 117 6/16/2024
6.0.19 111 6/14/2024
6.0.18 105 6/14/2024
6.0.17 104 6/14/2024
6.0.16 100 6/10/2024
6.0.15 119 6/9/2024
6.0.14 120 5/24/2024
6.0.13 118 5/23/2024
6.0.12 108 5/23/2024
6.0.11 127 5/20/2024
6.0.9 134 5/20/2024
6.0.7 117 5/18/2024
6.0.6 108 5/10/2024
6.0.5 118 5/10/2024
6.0.4 154 4/3/2024
6.0.3 1,195 3/25/2024
6.0.2 180 3/11/2024
6.0.0 1,000 11/21/2023
6.0.0-rc.6 106 10/25/2023
6.0.0-rc.5 77 10/25/2023
6.0.0-rc.4 70 10/23/2023
6.0.0-rc.3 66 10/19/2023
6.0.0-rc.2 76 10/18/2023
6.0.0-rc.1 78 10/16/2023
5.0.20 515 9/25/2023
5.0.19 509 9/10/2023
5.0.18 490 9/6/2023
5.0.17 472 9/6/2023
5.0.16 549 9/5/2023
5.0.15 495 9/5/2023
5.0.14 491 9/5/2023
5.0.13 486 9/1/2023
5.0.12 459 8/31/2023
5.0.11 488 8/30/2023
5.0.10 513 8/29/2023
5.0.9 495 8/24/2023
5.0.8 504 8/24/2023
5.0.7 510 8/23/2023
5.0.6 538 8/21/2023
5.0.5 520 8/21/2023
5.0.4 549 8/16/2023
5.0.3 612 8/2/2023
5.0.2 568 8/2/2023
5.0.1 594 8/1/2023
5.0.0 596 7/31/2023
4.1.26 623 7/20/2023
4.1.25 587 7/16/2023
4.1.24 700 6/13/2023
4.1.23 610 6/13/2023
4.1.22 1,010 5/30/2023
4.1.21 603 5/20/2023
4.1.20 315,632 4/19/2023
4.1.19 95,552 3/20/2023
4.1.18 712 3/20/2023
4.1.17 685 3/16/2023
4.1.16 692 3/16/2023
4.1.15 684 3/15/2023
4.1.14 1,774 3/9/2023
4.1.13 713 3/7/2023
4.1.12 863 2/10/2023
4.1.11 742 1/26/2023
4.1.10 757 1/22/2023
4.1.9 729 1/20/2023
4.1.8 741 1/18/2023
4.1.7 730 1/18/2023
4.1.6 744 1/17/2023
4.1.1 777 1/4/2023
4.1.0 777 1/1/2023
3.1.5 757 12/21/2022
3.1.3 764 12/12/2022
3.1.2 747 12/7/2022
3.1.1 761 12/7/2022
3.1.0 818 12/2/2022
3.0.29 753 12/1/2022
3.0.28 776 12/1/2022
3.0.27 817 11/23/2022
3.0.25 881 11/23/2022
3.0.24 882 11/18/2022
3.0.23 875 11/18/2022
3.0.22 877 11/15/2022
3.0.21 869 11/14/2022
3.0.20 907 11/13/2022
3.0.19 1,011 11/2/2022
3.0.18 879 11/2/2022
3.0.17 934 10/29/2022
3.0.16 935 10/29/2022
3.0.15 922 10/29/2022
3.0.14 1,064 10/24/2022
3.0.13 944 10/24/2022
3.0.12 934 10/17/2022
3.0.11 980 10/10/2022
3.0.10 979 10/6/2022
3.0.9 969 10/6/2022
3.0.8 962 10/6/2022
3.0.7 900 10/6/2022
3.0.6 970 10/5/2022
3.0.5 847 10/5/2022
3.0.4 983 10/5/2022
3.0.3 961 10/3/2022
3.0.2 952 9/30/2022
3.0.1 968 9/30/2022
2.0.17 853 9/29/2022
2.0.16 993 9/27/2022
2.0.15 1,043 9/27/2022
2.0.14 1,031 9/26/2022
2.0.13 991 9/26/2022
2.0.12 987 9/26/2022
2.0.11 1,015 9/25/2022
2.0.10 1,062 9/25/2022
2.0.9 1,027 9/22/2022
2.0.8 979 9/22/2022
2.0.6 1,012 9/20/2022
2.0.5 1,146 9/20/2022
2.0.4 987 9/20/2022
2.0.2 1,013 9/20/2022
2.0.1 1,065 9/13/2022
2.0.0 980 8/19/2022
1.1.24 1,074 7/30/2022
1.1.23 1,046 7/29/2022
1.1.22 895 7/29/2022
1.1.21 1,009 7/29/2022
1.1.20 1,023 7/29/2022
1.1.19 1,025 7/27/2022
1.1.17 1,080 7/27/2022
1.1.16 1,001 7/26/2022
1.1.15 1,023 7/25/2022
1.1.14 1,020 7/25/2022
1.1.13 1,004 7/22/2022
1.1.12 1,040 7/19/2022
1.1.11 1,031 7/19/2022
1.1.10 993 7/19/2022
1.1.9 1,030 7/19/2022
1.1.8 1,059 7/18/2022
1.1.7 1,016 7/18/2022
1.1.6 1,020 7/18/2022
1.1.5 1,050 7/17/2022
1.1.4 902 7/17/2022
1.1.3 1,170 7/17/2022
1.1.2 1,021 7/17/2022
1.1.0 1,042 7/17/2022
1.0.2 1,003 7/15/2022
1.0.1 898 7/15/2022
1.0.0 1,043 7/8/2022
0.10.7 1,000 7/7/2022
0.10.2 1,033 7/2/2022
0.10.1 1,050 7/1/2022
0.10.0 928 7/1/2022
0.9.10 1,001 6/20/2022
0.9.9 1,005 6/11/2022
0.9.7 890 6/9/2022
0.9.6 915 6/9/2022