query_core 是一个用于 Flutter 应用中进行数据查询的核心插件。它提供了一种简单而灵活的方式来执行各种数据查询操作，包括本地数据库查询、网络请求等。以下是如何使用 query_core 插件的核心步骤和示例。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 query_core 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  query_core: ^1.0.0  # 请使用最新版本

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

2. 初始化 QueryCore

在你的应用中初始化 QueryCore。通常，你可以在 main.dart 中进行初始化：

import 'package:query_core/query_core.dart';

void main() {
  QueryCore.initialize(
    defaultQueryExecutor: NetworkQueryExecutor(baseUrl: 'https://api.example.com'),
  );
  runApp(MyApp());
}

在这个例子中，我们使用 NetworkQueryExecutor 作为默认的查询执行器，并指定了基础 URL。

3. 定义数据模型

定义你的数据模型类。通常，这些类会映射到 API 返回的 JSON 数据或数据库中的表。

class User {
  final int id;
  final String name;
  final String email;

  User({required this.id, required this.name, required this.email});

  factory User.fromJson(Map<String, dynamic> json) {
    return User(
      id: json['id'],
      name: json['name'],
      email: json['email'],
    );
  }

  Map<String, dynamic> toJson() {
    return {
      'id': id,
      'name': name,
      'email': email,
    };
  }
}

4. 执行查询

使用 QueryCore 来执行查询操作。以下是一个从网络获取用户数据的示例：

import 'package:query_core/query_core.dart';

Future<List<User>> fetchUsers() async {
  final query = Query(
    path: '/users',
    method: QueryMethod.get,
  );

  final response = await QueryCore.execute(query);
  final List<dynamic> data = response.data;
  return data.map((json) => User.fromJson(json)).toList();
}

5. 在 UI 中使用查询结果

在你的 Flutter 应用中使用查询结果。例如，在 FutureBuilder 中显示用户列表：

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

class UserList extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('User List'),
      ),
      body: FutureBuilder<List<User>>(
        future: fetchUsers(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return Center(child: CircularProgressIndicator());
          } else if (snapshot.hasError) {
            return Center(child: Text('Error: ${snapshot.error}'));
          } else if (!snapshot.hasData || snapshot.data!.isEmpty) {
            return Center(child: Text('No users found.'));
          } else {
            final users = snapshot.data!;
            return ListView.builder(
              itemCount: users.length,
              itemBuilder: (context, index) {
                final user = users[index];
                return ListTile(
                  title: Text(user.name),
                  subtitle: Text(user.email),
                );
              },
            );
          }
        },
      ),
    );
  }
}

6. 处理错误和加载状态

在执行查询时，确保处理错误和加载状态。FutureBuilder 或 StreamBuilder 是处理异步数据的常用方式。

7. 自定义查询执行器

如果你需要自定义查询执行器（例如，使用本地数据库），你可以实现 QueryExecutor 接口并将其传递给 QueryCore.initialize。

class LocalDatabaseQueryExecutor implements QueryExecutor {
  [@override](/user/override)
  Future<QueryResponse> execute(Query query) async {
    // 实现本地数据库查询逻辑
  }
}

void main() {
  QueryCore.initialize(
    defaultQueryExecutor: LocalDatabaseQueryExecutor(),
  );
  runApp(MyApp());
}