Flutter实用工具插件wind_utils的使用

wind_utils 是一个用于 Dart 的通用工具库，包含多种实用功能，如 JSON 操作、路径匹配等。以下是该插件的主要功能及使用示例。

主要功能

1. JSON 工具

JSON 提供了 JSON 序列化的静态工具。

示例代码

import 'package:wind_utils/json/json.dart';

void main() {
  // 定义一个对象
  Map<String, dynamic> data = {
    "name": "John",
    "age": 30,
    "isStudent": false
  };

  // 将对象序列化为 JSON 字符串
  String jsonString = JSON.stringify(data);
  print("JSON 字符串: $jsonString");

  // 将 JSON 字符串反序列化为对象
  Map<String, dynamic> parsedData = JSON.parse(jsonString);
  print("解析后的对象: $parsedData");
}

2. JSONSerializer

JSONSerializer 是基于 built_value 的泛型 JSON 序列化工具。

示例代码

import 'package:wind_utils/json/json_serializer.dart';

// 定义一个数据模型
class Person extends JsonSerializable {
  final String name;
  final int age;

  Person({required this.name, required this.age});

  factory Person.fromJson(Map<String, dynamic> json) =>
      _$PersonFromJson(json);

  Map<String, dynamic> toJson() => _$PersonToJson(this);
}

void main() {
  // 创建一个对象
  Person person = Person(name: "Alice", age: 25);

  // 序列化对象为 JSON
  String jsonString = JSONSerializer.toJson(person);
  print("序列化后的 JSON: $jsonString");

  // 反序列化 JSON 为对象
  Person parsedPerson = JSONSerializer.fromJson(Person.serializer, jsonString);
  print("反序列化后的对象: ${parsedPerson.name}, ${parsedPerson.age}");
}

3. AntPathMatcher

AntPathMatcher 提供了类似于 Spring 的 Ant 风格路径匹配功能。

示例代码

import 'package:wind_utils/match/ant_path_matcher.dart';

void main() {
  AntPathMatcher matcher = AntPathMatcher();

  // 匹配路径
  bool match1 = matcher.match("/users/*", "/users/123");
  print("匹配结果: $match1"); // 输出: true

  bool match2 = matcher.match("/users/{id}", "/users/123");
  print("匹配结果: $match2"); // 输出: true
}

4. qs dart

qs dart 提供了查询字符串的解析功能。

示例代码

import 'package:wind_utils/query_string/qs.dart';

void main() {
  // 定义查询字符串
  String queryString = "name=John&age=30&isStudent=false";

  // 解析查询字符串
  Map<String, dynamic> queryMap = Qs.parse(queryString);
  print("解析后的查询参数: $queryMap");
}

使用步骤

1. 添加依赖： 在 pubspec.yaml 文件中添加以下依赖：

   dependencies:
     wind_utils: ^x.x.x
   

2. 运行构建命令： 如果使用了 built_value，需要运行以下命令：

   flutter packages pub run build_runner watch
   flutter packages pub run build_runner build test --delete-conflicting-outputs