HttpClient.Cache 0.0.2

HttpClient.Cache

HTTP/1.1 compliant caching layer for the .NET HttpClient. A prerelease package is availble on nuget.

It supports file based caching of responses based on the HTTP/1.1 caching headers specified in RFC7234.

Features

• Pluggable caching for HttpClient
• Customizable cache key computation (supports both shared and private caching)
• Extensible cache entry and cache handler interfaces (defaults to file based caching)
• Easy integration with dependency injection

Getting Started

Installation

Add the package reference to your project:

dotnet add package HttpClient.Cache

Usage

1. Register the cache handler and related services on your HttpClient.
2. Use the HttpClient as usual.

Note that all uses of the cache goes via HttpClient, so caching can easily be obtained using e.g generated clients such as Refit clients.

Example

// Register the caching client on a HttpClient in your Program.cs
services.AddHttpClient("cachedClient")
        .AddResponseCache(); // Defaults to using the shared, file based cache.

// Use the client as normally
var client = httpClientFactory.CreateClient("cachedClient");

var firstResponse = await client.GetAsync("https://example.com/"); // Returns a "non-private" Cache-Control header
var secondResponse = await client.GetAsync("https://example.com/");
Assert.Equal(CacheType.None, firstResponse.GetCacheType()); // This response was not obtained from cache.
Assert.Equal(CacheType.Shared, secondResponse.GetCacheType()); // This response was obtained from the shared (not private) cache.

Note that the usage here is different compared to e.g. Replicant.

Custom Caches

It is possible to use a custom cache for a client. Consider the following example:

var cache = new FileCache("/some/cache/directory");
services.AddHttpClient("cachedClient")
        .AddResponseCache(cache);

FileCache implements IHttpCache and this is an extension point if one wants to use a different, non-file based cache implementation.

Key Components

• CacheHandler: HTTP message handler that manages caching logic. This handler can be registered on a HttpClient as a message handler layer.
• IHttpCache: Interface for cache storage implementations. The default file based implementation is FileCache.

Alternatives

• Replicant

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please open issues or submit pull requests for improvements and bug fixes.