Drogecode.Blazor.ExpireStorage 0.2.3

Drogecode.Blazor.ExpireStorage

Adds a wrapper on top of Blazored.LocalStorage and Blazored.SessionStorage to expire items from localstorage and sessionstorage after a specified time.

Blazored is archived, I will build my own implementation.

Installing

To install the package add the following line to you csproj file replacing x.x.x with the latest version number (found at the top of this file):

<PackageReference Include="Drogecode.Blazor.ExpireStorage" Version="x.x.x" />

You can also install via the .NET CLI with the following command:

dotnet add package Drogecode.Blazor.ExpireStorage

If you're using Visual Studio you can also install via the built in NuGet package manager.

Setup

You will need to register the expire storage services with the service collection in your Startup.cs file in Blazor Server.

public void ConfigureServices(IServiceCollection services)
{
    services.AddExpireStorage();
}

Or in your Program.cs file in Blazor WebAssembly.

public static async Task Main(string[] args)
{
    var builder = WebAssemblyHostBuilder.CreateDefault(args);
    builder.RootComponents.Add<App>("app");

    builder.Services.AddExpireStorage();

    await builder.Build().RunAsync();
}

If you use Blazored.LocalStorage or Blazored.SessionStorage with configuration those will need to be registered before Drogecode.Blazor.ExpireStorage.

Usage (Blazor WebAssembly)

example

@inject Drogecode.Blazor.ExpireStorage.IExpireStorageService storageService

@code {
    
    public async Task<YourObjectResponse?> GetDayItemsAsync(DateRange dateRange, Guid userId, CancellationToken clt)
    {
        var cacheKey = "CACHE_KEY_HERE"
        var response = await storageService.CachedRequestAsync(cacheKey),
            async () => await apiClient.GetItemsAsync(),
            new CachedRequest{CachedAndReplace = true},
            new YourObjectResponse(),
            clt);
        return response;
    }

}

Options

CachedRequest

You can give optional settings to the CachedRequest object.

• OneCallPerSession - If true, the result will be returned from sessionstorage if it is not expired. Default: false
• OneCallPerCache - If true, the result will be returned from localstorage if it is not expired. Default: false
• IgnoreCache - If true, never return a cached result. Default: false
• ExpireLocalStorage - The time to expire the result in localstorage. Default: 7 days.
• ExpireSessionStorage - The time to expire the result in sessionstorage. Default: 15 minutes.
• CachedAndReplace - If true, The cached result will be returned and the cache will be refreshed for the next call. Default: false
• AlwaysCacheWhenOffline - If true, the cached result will be returned when offline, except when IgnoreCache is true. Default: false
• RetryOnJsonException - If true, If a JSON exception occurs, the cache will be cleared and the request will be retried. Default: true

Global settings

On, for example, MainLayout.razor.cs, you can set the Postfix to be used for all requests. This is useful if you have multiple users using the same app from the same browser.

ExpireStorageService.Postfix = userId.ToString();

ExpireStorageService knows two properties to monitor if the app is offline.

IsOffline is true when the last request had an HttpRequestException.

ExpireStorageService.IsOffline and ExpireStorageService.IsOfflineChanged

ICacheableResponse

If a response object implements ICacheableResponse, the FromCache property will be set to true if the result was retrieved from cache.

using Drogecode.Blazor.ExpireStorage;
public class YourObjectResponse : ICacheableResponse
{
    ...
    public HandledBy HandledBy { get; set; }
    ...
}