Flutter基础功能扩展插件lens_base的使用

Flutter基础功能扩展插件lens_base的使用

理由

有时，你希望允许应用程序的其他部分读取和修改某个值，但不希望暴露整个对象或其内部结构。

简而言之，你需要两个操作：

• 获取当前值
• 设置新值

这就是镜头（lenses）的作用。它们封装了值并提供了一种读取和修改它的方法，而无需暴露对象本身。它们也是可组合的，因此可以轻松修改列表中的特定项或映射中的条目。

使用方法

预定义镜头

这个包提供了Lens接口的基本实现，称为DirectLens。它允许你将一个getter和一个setter组合成一个对象。

// 创建一个DirectLens对象
final lens = DirectLens(
  get: () => /* 获取值 */,
  set: (value) => /* 设置值 */,
);
// 这个对象可以在应用中传递，并用于读取和修改值

特殊化镜头

除了标准的Lens类之外，这个包还提供了更多特殊化的类，这些类提供了额外的实用方法：

• NumberLens – 用于（可能有界）数值。

  可以配置可选的最小值和最大值以及增量。添加了两个方法：increment和decrement。

  // NumberLens示例
  NumberLens<int> lens;
  lens.get(); // 42
  lens.increment(); // 43
  lens.decrement(5); // 38
  

• BoolLens – 用于布尔值。

  添加了一个toggle方法。

  // BoolLens示例
  BoolLens lens;
  lens.get();    // true
  lens.toggle(); // false
  

• EnumLens – 用于枚举值。不仅适用于实际的enum，而且适用于任何具有有限数量值的类型。

  添加了一个next方法，该方法循环遍历值。

  // EnumLens示例
  enum MyEnum { a, b, c }
  EnumLens<MyEnum> lens;
  lens.get();  // MyEnum.a
  lens.next(); // MyEnum.b
  

• ListLens – 用于值列表。

  添加了添加、删除和修改元素的方法。它还提供了一种“深入查看”的方法，为列表中的特定元素获取镜头。

  // ListLens示例
  ListLens<int> lens;
  lens.get(); // [1, 2, 3]
  lens.add(4); // [1, 2, 3, 4]
  lens.removeAt(1); // [1, 3, 4]
  lens[1].set(100); // [1, 100, 4]
  

• MapLens – 用于值映射。

  添加了添加、删除和修改特定条目的方法，还可以一次性修改所有条目。

  // MapLens示例
  MapLens<String, int> lens;
  lens.get(); // {'a': 1, 'b': 2}
  lens.updateAll((key, value) => value * 2); // {'a': 2, 'b': 4}
  lens['a'].set(42); // {'a': 42, 'b': 4}
  lens['c'].set(3); // {'a': 42, 'b': 4, 'c': 3}
  lens['b'].remove(); // {'a': 42, 'c': 3}
  

完整示例Demo

下面是一个完整的Flutter应用示例，展示如何使用lens_base插件来管理应用状态。

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: LensDemo(),
    );
  }
}

class LensDemo extends StatefulWidget {
  [@override](/user/override)
  _LensDemoState createState() => _LensDemoState();
}

class _LensDemoState extends State<LensDemo> {
  // 使用NumberLens管理计数器状态
  final NumberLens<int> counterLens = NumberLens<int>(
    get: () => _counter,
    set: (value) => setState(() => _counter = value),
    min: 0,
    max: 100,
    increment: 1,
  );

  int _counter = 0;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Lens Base Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '${counterLens.get()}',
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
      floatingActionButton: Column(
        mainAxisAlignment: MainAxisAlignment.end,
        children: [
          FloatingActionButton(
            onPressed: () => counterLens.increment(),
            tooltip: 'Increment',
            child: Icon(Icons.add),
          ),
          SizedBox(height: 10),
          FloatingActionButton(
            onPressed: () => counterLens.decrement(),
            tooltip: 'Decrement',
            child: Icon(Icons.remove),
          ),
        ],
      ),
    );
  }
}