REQUESTS - Offline Availability

Offline Availability

• Have you ever found a case where you have a cache, but it just doesn’t care about the user’s current network status?
• Have you ever wanted to ensure data is available for your app the next time it launches, but the user is disconnected?

When you are building a mobile app, you need to consider offline availability. This is especially true for apps that are used in the field or in areas where network connectivity is spotty.

Note

Offline availability is installed by default with the UseMaui setup.

The offline availability middleware is used as part of the default middleware installed by Shiny.Mediator.Maui OR Shiny.Mediator.Blazor. Like most other middleware, you simply need to mark your IRequestHandler.Handle method(s) with the attribute [Offline] or using the Configuration system.

Obviously, offline only works for request handlers with a return value.

Fine grained control over offline data is available via Request Keys

Offline should not be considered a “cache”. If online connectivity is detected, the offline middleware will keep making calls to your handler. Consider using the (Caching Middleware)[./caching] if you are looking for a performance based cache setup

Request Handler Example

public class MyRequestHandler : IRequestHandler<MyRequest, IReadOnlyList<MyThingData>>
{
    [OfflineAvailable]
    public async Task<IReadOnlyList<MyThingData>> Handle(MyRequest request, CancellationToken cancellationToken)
    {
        // each return will overwrite the previous return value
    }
}

Note

Above is configured with the OfflineAvailableAttribute. You can also configure the Microsoft Extensions Configuration using the following:

{
    "Mediator": {
        "Offline": {
            "MyNamespace.SomeHttpRequest": true
        }
    }
}

For more info about configuration, see Middleware Configuration

Danger

Configuration does allow you to specify wildcard/globs * to specify all handlers in a namespace use Offline. WE STRONGLY DISCOURAGE THIS. This feature is something you want to be very explicit about.

Controlling HOW the offline data is stored

Often, there are times you want to store data based on the parameter arguments within your request. Trying to build these keys for you can be a bit tricky, so we have a simple interface to help you out instead.

The offline middleware looks at your IRequest implementation. You can also implement the IRequestKey interface which is part of the Shiny.Mediator.Contracts library. This allows you to ‘build’ a key from possible arguments in your request object.

Example

public record MyRequest(string Arg1, int Arg2) : IRequest<IReadOnlyList<MyThingData>>, IRequestKey
{
    public string GetKey() => $"{this.Arg1}-{this.Arg2}";
}