Flutter功能未明确定义插件celer的使用

celer #

专为快速异步文件写入设计

由JS steno 移植而来

Celer 在拉丁语中的意思是“快”。

特性 #

Celer 使得频繁或并发地向同一文件写入变得快速且安全。

• ⚡ 在特定情况下非常快（见基准测试）
• 包含以Flutter方式实现的基准测试/测试

注意

在单次写入等正常情况下，它可能比普通的dart:io方法更慢。

开始使用 #

无需特别启动。

使用 #

/// 数据设置代码
final dir = await Directory.systemTemp.createTemp('celer-test-');
final celerFile = File(p.join(dir.path, 'celer.txt'));
final data = String.fromCharCodes(List.filled(1024, 'x'.codeUnitAt(0)));
final dataset = List.generate(1000, (index) => data);
/// 使用
/// 初始化Celer写入器
final celer = CelerWriter(celerFile.path);
/// 写入
/// 反复向同一文件写入数据
await Future.wait(dataset.map((e) => celer.write(e)));

额外信息 #

在基准测试中，我们测量并比较了向同一文件写入kb和mb大小文本1000次所需的时间。

向同一文件写入1KB数据 x 1000
celer(Runtime): 5820.627906976744 us.
io(Runtime): 115485.27777777778 us.
-----------------------------------
向同一文件写入1MB数据 x 1000
celer(Runtime): 22048.14285714286 us.
io(Runtime): 7442817.0 us.

你可以通过以下命令自行运行基准测试：

dart run benchmark/tester.dart

免责声明

你的计算机上可能会有不同的测量结果。

完整示例代码

import 'dart:io';
import 'package:celer/celer.dart';
import 'package:path/path.dart' as p;

Future<void> main() async {
  /// 设置数据
  final dir = await Directory.systemTemp.createTemp('celer-test-');
  final celerFile = File(p.join(dir.path, 'celer.txt'));
  final data = String.fromCharCodes(List.filled(1024, 'x'.codeUnitAt(0)));
  final dataset = List.generate(1000, (index) => data);

  /// 使用Celer写入器
  final celer = CelerWriter(celerFile.path);
  await Future.wait(dataset.map((e) => celer.write(e)));
}