Flutter功能扩展插件double_extension的使用

Flutter功能扩展插件double_extension的使用

Features（功能）

该插件提供了对double类型的功能扩展，包括从动态数据解析为double类型、设置默认值、限制允许的值范围等功能。这些功能可以帮助开发者更安全地处理数据类型转换。

Getting Started（入门指南）

要开始使用double_extension插件，首先需要将其添加到您的pubspec.yaml文件中：

dependencies:
  double_extension: ^1.0.0 # 替换为最新版本号

然后运行以下命令以安装依赖：

flutter pub get

Usage（使用示例）

以下是使用double_extension插件的完整示例代码：

import 'package:double_extension/double_extension.dart'; // 导入扩展包

void main() {
  // 创建一个包含不同类型值的Map
  final map = {
    'nullValue': null, // 空值
    'notNullValue': 3.14, // 正常数值
    'notAllowableValue': 5 // 不在允许范围内
  };

  // 打印原始Map结构
  print('Map: ${map.toStructuredString()}'); 

  // 示例1：从空值解析，使用默认值
  print('\n从空值解析，使用默认值:');
  print(DoubleExtension.fromDynamicE(map['nullValue'], defaultValue: 1.1));

  // 示例2：从不存在的键解析，使用默认值
  print('\n从不存在的键解析，使用默认值:');
  print(DoubleExtension.fromDynamicE(map['expectedValue'], defaultValue: 2.2));

  // 示例3：从正常数值解析，默认值未使用
  print('\n从正常数值解析，默认值未使用:');
  print(DoubleExtension.fromDynamicE(map['notNullValue'], defaultValue: 3.3));

  // 示例4：从不允许的值解析，抛出异常
  print('\n从不允许的值解析，抛出异常:');
  try {
    final value = DoubleExtension.fromDynamicE(
      map['notAllowableValue'], // 值不在允许范围内
      defaultValue: 1.0,
      allowableValues: {1.0, 2.0, 3.0} // 允许的值集合
    );
  } catch (e) {
    print(e); // 捕获并打印异常信息
  }

  // 示例5：自定义异常信息
  print('\n带名称参数的示例，自定义异常信息:');
  try {
    final value = DoubleExtension.fromDynamicE(
      map['notAllowableValue'], // 值不在允许范围内
      name: 'notAllowableValue', // 参数名称
      defaultValue: 1.0,
      allowableValues: {1.0, 2.0, 3.0} // 允许的值集合
    );
  } catch (e) {
    print(e); // 捕获并打印异常信息
  }

  // 示例6：禁用空值检查
  print('\n禁用空值检查:');
  final valueWithNullCheckDisabled = DoubleExtension.fromDynamicE(
    map['nullValue'], // 允许空值
    nullAllowed: true // 启用空值支持
  );
  print(valueWithNullCheckDisabled);
}

Additional Information（更多信息）

• 贡献与反馈： 如果您发现任何问题或有改进建议，请提交至GitHub仓库。

• 许可证： 该插件遵循MIT开源协议，您可以自由使用、修改和分发。

输出示例

运行上述代码后，输出结果如下：

Map: {
  nullValue: null,
  notNullValue: 3.14,
  notAllowableValue: 5
}

从空值解析，使用默认值:
1.1

从不存在的键解析，使用默认值:
2.2

从正常数值解析，默认值未使用:
3.14

从不允许的值解析，抛出异常:
double_extension.NotAllowableValueException: The value '5' for parameter 'notAllowableValue' is not allowed. Allowed values are {1.0, 2.0, 3.0}.

带名称参数的示例，自定义异常信息:
double_extension.NotAllowableValueException: The value '5' for parameter 'notAllowableValue' is not allowed. Allowed values are {1.0, 2.0, 3.0}.

禁用空值检查:
null