Flutter工具集插件nv_tooling的使用

Flutter工具集插件nv_tooling的使用

Result

Result 类受 Rust 同名类型的启发。它提供了一种更谨慎的方式来处理异常。特别是在进行 API 调用时，很容易忘记处理某些异常。这个类不会让你这样做。

有两个方法可以返回一个 Result 对象，分别是 resultOf 和 exceptionOf，它们分别创建带有 Result 或 Exception 对象的 Result 实例。

此外，还提供了 access(...) 方法，该方法接受两个回调函数来处理 Result 和 Exception 的两种情况。

另外，还有一个 map(...) 方法允许轻松地对 Result 类进行变异操作，而无需处理两种情况。

// 这种方式类型比较长，所以可以创建别名使它们更具可读性
typedef AsyncResultOrException = Future<Result<SomeObject, FreezedErrorUnion>>;

// 假设我们在这里执行一些远程工作
AsyncResultOrException getObjectFromServer() async => resultOf(SomeObject());

final Result<SomeObject, FreezedErrorUnion> myObjects = await getObjectFromServer(true);

// 注意这会改变类型
final newMyObjects = myObjects.map(failure: (failure) => 'Something went wrong'); 

// 最后在你的小部件中，访问你的数据（并处理错误情况）
Text(
    newMyObjects.access(
        (myObject) => myObject.toString(), 
        (failure) => failure,
    )
);

// 最重要的是，它添加了 `unwrap` 方法，该方法在 `Result` 是成功的情况下返回数据，否则抛出 `Exception`。
final obj = newMyObjects.unwrap();

Selection/OptionalSelection

这种类型将所有选项以及选定的选项放在一个地方。如果你有一个字符串列表，并希望用户选择一个，有时你可能需要知道选定的选项以及所有可用的选项。

OptionalSelection 允许选择为 null，而 Selection 确保始终有一个项目被选中。

final selection = Selection(
    options: ['Hello', 'my', 'friend'], 
    selected: 'my',
);

可迭代扩展

mapGrouped

根据 groupBy 回调分组元素，然后对每个单独的组应用 groupBuilder 方法。

final names = ['Alex', 'Anna', 'Bill', 'Benny'];
final namesGrouped = Map.fromEntries(
    names.mapGrouped(
        groupBy: (name) => name[0], 
        groupBuilder: (key, values) => MapEntry(key, values),
    ),
);

print(namesGrouped);

// 输出:
// { 'A': ['Alex', 'Anna'], 'B': ['Bill', 'Benny'] }

mapIndexed

在映射时提供元素的索引。

final names = ['Alex', 'Anna', 'Bill', 'Benny'];
final namesWithIndex = names.mapIndexed(
    (index, element) => '$index: $element',      
);

print(namesWithIndex);

// 输出:
// ['0: Alex', '1: Anna', '2: Bill', '3: Benny']

separatedBy

在可迭代对象的每个元素之间插入提供的元素。

final names = ['Alex', 'Anna', 'Bill'];
final namesWithJolo = names.separatedBy('Jolo');

print(namesWithJolo);

// 输出:
// ['Alex', 'Jolo', 'Anna', 'Jolo', 'Bill']

完整示例代码

import 'package:example/data/data.dart';
import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatelessWidget {
  MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Fake HTTP call'),
            Text(
              Data().getWeather().access(
                    (success) => 'weather: ${success.weather}\n'
                        'chance of rain: ${success.propRain}\n'
                        'temperature: ${success.tempInDegrees}',
                    (failure) => failure.map(
                      noConnection: (_) => 'Make sure you\'re connected to the internet!',
                      unauthorized: (_) => 'You are not allowed to view this!',
                    ),
                  ),
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
    );
  }
}