short_term_caching 是一个用于 Flutter 的短期缓存管理插件，它可以帮助你在应用中轻松地管理短期缓存数据。这个插件适用于那些需要临时存储数据，但又不需要长期保存的场景，比如缓存 API 响应、临时用户数据等。

安装

首先，你需要在 pubspec.yaml 文件中添加 short_term_caching 依赖：

dependencies:
  flutter:
    sdk: flutter
  short_term_caching: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

1. 初始化缓存

在使用缓存之前，你需要初始化缓存管理器。通常你可以在应用的 main 函数中进行初始化：

import 'package:short_term_caching/short_term_caching.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ShortTermCaching.init();
  runApp(MyApp());
}

2. 存储数据

你可以使用 ShortTermCaching 来存储数据。数据可以是任何类型，但通常建议存储字符串、JSON 或其他简单数据类型。

await ShortTermCaching.save('key', 'value');

3. 读取数据

你可以通过键来读取缓存中的数据：

String? value = await ShortTermCaching.read<String>('key');
if (value != null) {
  print('Cached value: $value');
} else {
  print('No cached value found');
}

4. 删除数据

如果你不再需要某个缓存项，可以将其删除：

await ShortTermCaching.delete('key');

5. 清除所有缓存

你可以清除所有缓存数据：

await ShortTermCaching.clearAll();

高级用法

设置缓存过期时间

你可以为缓存项设置过期时间，当缓存项过期后，它将自动被删除。

await ShortTermCaching.save('key', 'value', Duration(minutes: 10));

监听缓存变化

你可以监听缓存的变化，以便在缓存更新时执行某些操作。

ShortTermCaching.addListener('key', (value) {
  print('Cache updated: $value');
});

示例

以下是一个完整的示例，展示了如何使用 short_term_caching 插件来管理缓存：

import 'package:flutter/material.dart';
import 'package:short_term_caching/short_term_caching.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ShortTermCaching.init();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Short Term Caching Example')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () async {
                  await ShortTermCaching.save('key', 'Hello, Caching!');
                  print('Data saved');
                },
                child: Text('Save Data'),
              ),
              ElevatedButton(
                onPressed: () async {
                  String? value = await ShortTermCaching.read<String>('key');
                  if (value != null) {
                    print('Cached value: $value');
                  } else {
                    print('No cached value found');
                  }
                },
                child: Text('Read Data'),
              ),
              ElevatedButton(
                onPressed: () async {
                  await ShortTermCaching.delete('key');
                  print('Data deleted');
                },
                child: Text('Delete Data'),
              ),
              ElevatedButton(
                onPressed: () async {
                  await ShortTermCaching.clearAll();
                  print('All cache cleared');
                },
                child: Text('Clear All Cache'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}