Flutter数据处理与空值处理插件nullable_absent的使用

Flutter数据处理与空值处理插件nullable_absent的使用

特性

简单包装类，用于表示 absent 值。 当你为包含 nullable 字段的类创建 copyWith 方法时，可能需要它。

开始使用

在 pubspec.yaml 文件中添加依赖项：

dependencies:
  nullable_absent: ^2.0.0

使用示例

对于包含 nullable 字段的类，并且你想拥有 copyWith 函数。

class MyData {
  final String id;
  final String? name;

  MyData({required this.id, required this.name});

  MyData copyWith({
    String? id,
    NullableAbsent<String> name = const NullableAbsent.absent(),
  }) {
    return MyData(
        id: id ?? this.id, 
        name: NullableAbsent(this.name).apply(name),
    );
  }

  [@override](/user/override)
  String toString() {
    return [id, name ].toString();
  }
}

对于非 null 字段，我们可以使用 String? 来指定 id 的新值，或者直接将其设为 null 来使用旧值。 但对于 nullable 字段，我们有时想将其设为 null，有时想使用旧值。因此 String? 不够用。

MyData copyWith({String? id}) {
  return MyData(
      id: id ?? this.id, 
      name: name ?? this.name, // 如果我们想要将 name 设为 null
  );
}

有了 nullable_absent，我们可以区分 set to null 或 use old value，如下所示。

MyData copyWith({
  String? id,
  NullableAbsent<String> name = const NullableAbsent.absent(),
}) {
  return MyData(
      id: id ?? this.id, 
      name: NullableAbsent(this.name).apply(name),
  );
}

apply(newValue) 是一个方便的方法来创建结果值。

额外信息

你可以使用 typedef 来使代码更简洁。

typedef $T = NullableAbsent<T>

// copyWith 示例代码
MyData copyWith({
  String? id,
  $<String> name = const $.absent(),
}) {
  return MyData(
      id: id ?? this.id, 
      name: $(this.name).apply(name));
}

// 使用示例
final dataWithNewName = data.copyWith(name: $("new_name"));

示例代码

import 'package:nullable_absent/nullable_absent.dart';

void main() {
  final data = MyData(id: "id", name: "name");
  print("data: $data");
  final dataWithNewName = data.copyWith(name: NullableAbsent("new_name"));
  print("dataWithNewName: $dataWithNewName");
  final dataWithNullName = data.copyWith(name: NullableAbsent(null));
  print("dataWithNullName: $dataWithNullName");
  final dataWithNewId = data.copyWith(id: "new_id");
  print("dataWithNewId: $dataWithNewId");
}

class MyData {
  final String id;
  final String? name;

  MyData({required this.id, required this.name});

  MyData copyWith({
    String? id,
    NullableAbsent<String> name = const NullableAbsent.absent(),
  }) {
    return MyData(
        id: id ?? this.id, 
        name: NullableAbsent(this.name).apply(name));
  }

  [@override](/user/override)
  String toString() {
    return [id, name ].toString();
  }
}