Flutter插件do_what_now的使用_do_what_now是一个专为Dart（包括Flutter）设计的结果处理包

Flutter插件do_what_now的使用_do_what_now是一个专为Dart（包括Flutter）设计的结果处理包

DoWhatNow.Dart 是一个专为Dart（包括Flutter）设计的结果处理包。它采用了流式API和函数式错误处理方法，旨在简化错误处理过程。

代码示例

Flutter插件do_what_now快速开始

首先，确保你已经在你的 pubspec.yaml 文件中添加了 do_what_now 依赖项：

dependencies:
  do_what_now: ^x.x.x

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

使用 DoWhat 类

DoWhat 类是一个不可变类，用于存储成功的值或错误列表。它主要用于处理成功或失败的结果。

创建有效的 DoWhat

final doWhat = create<String>('value');

if(doWhat.isSuccess) {
  // 这是真的，因为 'value' 字符串是有效的
}

创建无效的 DoWhat

final doWhat = create<String>(_oppsReturnedNull());

if(doWhat.isFailure) {
  // 这是真的，因为该方法返回了一个空字符串
}

...
String? _oppsReturnedNull() {
  //... 一些错误导致返回空字符串
  return null;
}

使用 from 方法

final result = from<int>(2, (value) => value == 2);
result.isSuccess // 这是真的，因为传递给 from 方法的值是 '2'，并且谓词评估为真。

创建成功的 DoWhat

final Thing thing = Thing();
final doWhat = success(thing); // 这现在是一个成功的 doWhat，并可以进行处理。

创建失败的 DoWhat

final doWhat = failure(message('这是一个失败的事情')); 

使用 What 对象

What 对象用于存储失败信息。你可以创建自己的 What 子类来存储不同类型的信息。

class WhatMessage extends What<String> {
  WhatMessage(String message) : super(Why.message, message);
  @override
  String _getMessage() => error!;
}

WhatMessage message(String message) => WhatMessage(message);

示例代码

下面是一个完整的示例代码，展示了如何使用 DoWhat 和 What 处理HTTP请求。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('DoWhatNow Example')),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              happyHttpExample();
            },
            child: Text('Happy HTTP Example'),
          ),
        ),
      ),
    );
  }
}

void happyHttpExample() {
  final doWhat = create<String>('http://getusers')
    .ensure(
      (url) => url.startsWith('http://'), // 验证
      (url) => message('$url does not start with http://')) // 提供错误信息  
    .tryMap<HttpResponse>((url) => getRequest(url)) // 转换
    .ensure(
      (httpResponse) => httpResponse.statusCode == 200, // 验证
      (httpResponse) => message('Status Code ${httpResponse.statusCode}'))
    .ensure(
      (httpResponse) => httpResponse.body != null, // 验证
      (httpResponse) => message('Http response contains no data'))
    .tryMap<User>((httpResponse) => User.fromMap(httpResponse.body!)); // 当知道响应体不为空时

  if (doWhat.isSuccess) {
    print(doWhat); // 将显示用户.toString()
  }

  if (doWhat.isFailure) {
    print(doWhat); // 将显示错误信息
  }
}

HttpResponse getRequest(String url) {
  return url.isNotEmpty 
    ? HttpResponse(200, {'email': 'something@something.com', 'name': 'some thing'})
    : HttpResponse(400, null);
}

class HttpResponse {
  final int statusCode;
  final Map<String, dynamic>? body;

  const HttpResponse(this.statusCode, this.body);
}

class User {
  final String name;
  final String email;
  bool eaten;

  User(this.email, this.name) : eaten = false;

  factory User.fromMap(Map<String, dynamic> map) {
    return User(
      map['email'] as String, 
      map['name'] as String);
  }

  @override
  String toString() {
    return 'name: $name, email: $email';
  }
}

组合多个 DoWhat

如果你需要组合多个 DoWhat 的结果，可以使用 combine 方法。

void combineExample() {
  final doWhat = combine(
    getUserAccount('apple'), 
    getUserAccount('bannana'))
    .ensure(
      (users) => users.$1.name == 'apple' && users.$2.name == 'bannana', 
      (users) => message('One or More Users are Not Value'))
    .map<Villian>((users) => Villian.eatUsers(users.$1, users.$2))
    .ensure(
      (villian) => villian.user1.eaten && villian.user2.eaten, 
      (villian) => message('The villian didn\'t eat the users'));

  print(doWhat);
}

DoWhat<User> getUserAccount(String name) => 
  create(name)
    .map<String>((name) => 'http://getusers/$name') // 映射到URL
    .ensure(
      (url) => url.startsWith('http://'), // 验证
      (url) => message('$url does not start with http://')) // 提供错误信息  
    .tryMap<HttpResponse>((url) => getRequest(url, name: name)) // 尝试映射到HTTP响应
    .ensure(
      (httpResponse) => httpResponse.statusCode == 200, // 验证
      (httpResponse) => message('Status Code ${httpResponse.statusCode}'))
    .ensure(
      (httpResponse) => httpResponse.body != null, // 验证
      (httpResponse) => message('Http response contains no data'))
    .tryMap<User>((httpResponse) => User.fromMap(httpResponse.body!)); // 尝试映射到用户对象