Dio HTTP cache interceptor with multiple stores respecting HTTP directives (or not).

Also available as client for http package.

HTTP directives:

Stores

• BackupCacheStore: Combined store with primary and secondary.
• DriftCacheStore: Cache with Drift Get it.
• FileCacheStore: Cache with file system (Does nothing on web platform) Get it.
• HiveCacheStore: Cache using hive_ce package Get it.
• IsarCacheStore: Cache using Isar package (available on all platforms) Get it.
• ObjectBoxCacheStore: Cache using ObjectBox package (no web support) Get it.
• SembastCacheStore: Cache using Sembast package Get it.
• MemCacheStore: Volatile cache with LRU strategy.

Usage

import 'package:dio_cache_interceptor/dio_cache_interceptor.dart';

// Global options
final options = const CacheOptions(
  // A default store is required for interceptor.
  store: MemCacheStore(),

  // All subsequent fields are optional to get a standard behaviour.
  
  // Default.
  policy: CachePolicy.request,
  // Returns a cached response on error for given status codes.
  // Defaults to `[]`.
  hitCacheOnErrorCodes: [500],
  // Allows to return a cached response on network errors (e.g. offline usage).
  // Defaults to `false`.
  hitCacheOnNetworkFailure: true,
  // Overrides any HTTP directive to delete entry past this duration.
  // Useful only when origin server has no cache config or custom behaviour is desired.
  // Defaults to `null`.
  maxStale: const Duration(days: 7),
  // Default. Allows 3 cache sets and ease cleanup.
  priority: CachePriority.normal,
  // Default. Body and headers encryption with your own algorithm.
  cipher: null,
  // Default. Key builder to retrieve requests.
  keyBuilder: CacheOptions.defaultCacheKeyBuilder,
  // Default. Allows to cache POST requests.
  // Assigning a [keyBuilder] is strongly recommended when `true`.
  allowPostMethod: false,
);

// Add cache interceptor with global/default options
final dio = Dio()..interceptors.add(DioCacheInterceptor(options: options));

// ...

// Requesting with global options => status(200) => Content is written to cache store.
var response = await dio.get('https://www.foo.com');
// Requesting with global options => status(304 => 200) => Content is read from cache store.
response = await dio.get('https://www.foo.com');

// Requesting by modifying policy with refresh option
// for this single request => status(200) => Content is written to cache store.
response = await dio.get('https://www.foo.com',
  options: options.copyWith(policy: CachePolicy.refresh).toOptions(),
);

Handling cache with client only

Follow those intructions if needed.

Options

CacheOptions is widely available on interceptor and on requests to take precedence.

See documentation for all properties.

Encryption

Optionally, you can encrypt body and headers with your own algorithm via CacheCipher.

Features and bugs

Please file feature requests and bugs at the issue tracker.

License

License.