Flutter辅助选项配置插件helper_options的使用

Helper options

一个通用的包，用于以更优雅的方式处理对象和小部件。

• 冗余的getter：在非选项方法中，getter可能会重复出现。
• 非选项方法需要使用liftNonNull或!：这可能导致更多的bug，因为你有更多的getter和变量名。
• 箭头方法更短：使用选项方法可以让你编写更简洁的代码。
• 如果Dart开发者决定用其他符号替换!：你可能需要在100万个地方进行修改。
• 可以在类中添加更多帮助方法：而不是单独添加到不同的文件中。（开放Pull Request）
• 避免类型转换：使用可选类型时，!操作符与定义为T?的对象上的T相同，因此没有类型转换问题。
• Flutter开发者不推荐使用!：建议尽可能避免使用它。
• 允许调用者继续链式调用：支持箭头方法。

注意：此包还包含一些有用的扩展，以简化代码。

示例说明

这是一个通用类，用于确定对象的状态：

// 一个示例类对象
class User {
  const User(this.username);
  final String username;
}

传统方式

// 在业务逻辑中
User? user = await api.getUser();
if (user == null) {
  // 执行此操作
  final userName = user.username;
} else {
  // 执行此操作
}

使用helper_options

// 在业务逻辑中
Option<User> user = Option.of(await api.getUser());
if (user.isPresent) {
  // 获取值并执行此操作
  final userName = user.value.username;
} else {
  // 执行此操作
}

看起来很酷吧！

你可以探索选项类的其他方法：

// 这个选项类还有其他帮助方法，例如：
user.empty(); // 创建一个空的Option。
user.filter(); // 如果存在且匹配谓词，则返回具有此Option值的Option。否则，返回空的Option。
user.flatMap(); // 如果存在，则返回通过将映射器应用于此Option的值而提供的Option。否则，返回空的Option。
user.orElse(); // 如果存在，则返回此Option的值。否则，返回其他值。
user.orNull(); // 如果存在，则返回此Option的值。否则，返回null。
user.orElseThrow(); // 如果存在，则返回此Option的值。否则，抛出调用supplyError()的结果。
user.ifPresent(final val) {
  // 如果存在，调用consume()与此Option的值。否则，如果传入orElse，则调用它，否则什么都不做。
}

OptionWidget

在另一个示例中，我们将使用一个超级OptionWidget来生成小部件，当数据存在时：

传统方式

class CustomWidget extends StatelessWidget {
  const CustomWidget({this.user});
  final User? user;

  bool get isEmptyUser => user == null;
  
  @override
  Widget build(final BuildContext context) {
    if (isEmptyUser) {
      return SizedBox();
    }

    return childWidget();
  }
}

// 然后在父级组件中这样调用：

ParentWidget(
  child: CustomWidget(user: user),
);

使用CustomWidget

ParentWidget(
  child: OptionWidget<User>(
    option: Option.of(user), // 将用户包装为Option
    empty: OffStage(), // 可选的小部件，用于空状态
    builder: (final context, final user) {
      return Child(); // 当数据存在时构建子部件
    },
  ),
),