Flutter核心功能扩展插件zam_core的使用

Zam Core库

Zam Core库是由zamstation开发的所有包的核心库。

包含的组件

• Builder
• Callback
• Exception
• Lifecycle
• Identifiable
• Serialize
• Model
• ViewModel
• Entity

详细了解这些组件请查看这里。

如何使用

ParameterizedBuilder

ParameterizedBuilder 可以用于构建具有特定类型的对象。

final ParameterizedBuilder<Type, Car> carBuilder;
// ...
final car = carBuilder(HondaCivic);

ParameterizedCallback

ParameterizedCallback 是一个可以处理不同类型参数的回调函数。

final ParameterizedCallback<double, int> roundOffStrategy;
// ...
final price = roundOffStrategy(8.458);

NamedException

NamedException 是对内置 Exception 类的包装，提供了更详细的异常信息，如严重程度和解决方案。

构造简单问题：

final exception = NamedException.create('Provided value is -26 which is negative.');

或者构建更详细的异常信息：

final exception = NamedException.create(
  'Provided value is -26 which is negative.',
  solution: 'Please provide a positive value.',
  severity: ExceptionSeverity.critical,
);

Cloneable

Cloneable 接口允许对象克隆自身。

[@immutable](/user/immutable)
class Triangle implements Cloneable<Triangle> {
  final double base;
  final double height;

  const Triangle(this.base, this.height);

  [@override](/user/override)
  Triangle clone() {
    return Triangle(this.base, this.height);
  }
}

Model

Model 类是一个不可变的数据模型，通常用于表示应用中的数据实体。

[@immutable](/user/immutable)
class BmiModel extends Model {
  final double weight;
  final double height;
  final double value;

  [@override](/user/override)
  get props => [weight, height];

  const BmiModel(this.weight, this.height) : value = weight / (height * height);
}

ViewModel

ViewModel 类是UI逻辑的抽象，通常与视图层绑定。

[@immutable](/user/immutable)
class HeightViewModel extends ViewModel {
  final double value;

  [@override](/user/override)
  get props => [value];

  const HeightViewModel(this.value);
}

Entity

Entity 类用于持久化和表示应用中的数据实体。

[@immutable](/user/immutable)
class BmiEntity extends Entity<BmiModel> {
  [@override](/user/override)
  final String key = '';
  final double weight;
  final double height;

  [@override](/user/override)
  get props => [weight, height];

  const BmiEntity({
    required this.weight,
    required this.height,
  });

  BmiEntity.fromJson(Json json)
      : this(
          weight: json['weight'] as double,
          height: json['height'] as double,
        );

  BmiEntity.fromModel(BmiModel model)
      : this(
          weight: model.weight,
          height: model.height,
        );

  [@override](/user/override)
  Json toJson() {
    return {
      'key': this.key,
      'weight': this.weight,
      'height': this.height,
    };
  }

  [@override](/user/override)
  BmiModel toModel() {
    return BmiModel(this.weight, this.height);
  }
}

要了解更多内容，请移步到示例部分，或者查看GitHub上的示例。

状态

贡献者

• Amsakanna

许可证

BSD 3-Clause License

完整示例Demo

import 'package:zam_core/zam_core.dart';

void main() {
  //
  // Cloneable
  //
  final triangle = Triangle(6, 4);
  final clonedTriangle = triangle.clone();
  assert(triangle != clonedTriangle);

  //
  // Exceptions
  //
  final emptyException = NamedException.empty();
  print(emptyException);
  // EmptyException has occured.
  // > Problem: <none>
  // > Solution: <none>

  final unnamedException = NamedException.create(
    'Provided value is -26 which is negative.',
  );
  print(unnamedException);
  // UnnamedException has occured.
  // > Problem: Provided value is -26 which is negative.
  // > Solution: <none>

  final heightException = NamedException.create(
    'Provided value is -26 which is negative.',
    solution: 'Provide a positive value.',
    name: 'Height Exception',
  );
  print(heightException);
  // Height Exception has occured.
  // > Problem: Provided value is -26 which is negative.
  // > Solution: Provide a positive value.
}

[@immutable](/user/immutable)
class Triangle implements Cloneable<Triangle> {
  final double base;
  final double height;

  const Triangle(this.base, this.height);

  [@override](/user/override)
  Triangle clone() {
    return Triangle(base, height);
  }
}

[@immutable](/user/immutable)
class BmiModel extends Model {
  final double weight;
  final double height;
  final double value;

  [@override](/user/override)
  get props => [weight, height];

  const BmiModel(this.weight, this.height) : value = weight / (height * height);
}

[@immutable](/user/immutable)
class HeightViewModel extends ViewModel {
  final double value;

  [@override](/user/override)
  get props => [value];

  const HeightViewModel(this.value);
}

[@immutable](/user/immutable)
class BmiEntity extends Entity<BmiModel> {
  [@override](/user/override)
  final String key = '';
  final double weight;
  final double height;

  [@override](/user/override)
  get props => [weight, height];

  const BmiEntity({
    required this.weight,
    required this.height,
  });

  BmiEntity.fromJson(Json json)
      : this(
          weight: json['weight'] as double,
          height: json['height'] as double,
        );

  BmiEntity.fromModel(BmiModel model)
      : this(
          weight: model.weight,
          height: model.height,
        );

  [@override](/user/override)
  Json toJson() {
    return {
      'key': key,
      'weight': weight,
      'height': height,
    };
  }

  [@override](/user/override)
  BmiModel toModel() {
    return BmiModel(weight, height);
  }
}