Flutter模拟商店API插件custom_fake_store_api_co的使用

本仓库包含了一个与Fake Store API交互的Flutter插件，提供了数据模型、错误处理，并展示了如何在遵循干净架构的Flutter应用中使用它。

特性

• 消费Fake Store API。
• 提供用于表示商店信息的数据模型。
• 使用dartz库进行错误处理。
• 展示了在Flutter应用中使用该插件的示例，遵循干净架构。

使用

要将custom_fake_store_api_co插件集成到你的Flutter应用中，请按照以下步骤操作：

导入包

在Dart文件中导入该包：

import 'package:custom_fake_store_api_co/custom_fake_store_api_co.dart';

安装

在pubspec.yaml文件的dependencies部分添加以下依赖：

dependencies:
  custom_fake_store_api_co:
    git:
      url: https://github.com/tiancris01/CUSTOM_FAKE_STORE_API_CO.git
      ref: main

然后运行：

flutter pub get

初始化插件

创建一个FakeStoreApiClient类的实例：

final apiClient = FakeStoreApiClient();

你可以使用apiClient对象来发起API调用并从Fake Store API获取数据。例如，获取产品列表可以使用getProducts方法：

final products = await apiClient.getProducts();

你还可以使用dartz库中的Either类型来处理错误。如果在获取产品时发生错误，可以这样处理：

final result = await apiClient.getProducts();

result.fold(
  (error) {
    // 处理错误
  },
  (products) {
    // 使用产品列表
  },
);

确保查看custom_fake_store_api_co包的文档以了解更多详细信息。

示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用custom_fake_store_api_co插件：

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: ProductListScreen(),
    );
  }
}

class ProductListScreen extends StatefulWidget {
  [@override](/user/override)
  _ProductListScreenState createState() => _ProductListScreenState();
}

class _ProductListScreenState extends State<ProductListScreen> {
  late Future<List<ProductModel>> _futureProducts;
  final CustomFakeStoreApiCo _api = CustomFakeStoreApiCo();

  [@override](/user/override)
  void initState() {
    super.initState();
    _futureProducts = _api.getProducts();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Fake Store API 示例'),
      ),
      body: FutureBuilder<List<ProductModel>>(
        future: _futureProducts,
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return Center(child: CircularProgressIndicator());
          } else if (snapshot.hasError) {
            return Center(child: Text('错误: ${snapshot.error}'));
          } else if (!snapshot.hasData || snapshot.data!.isEmpty) {
            return Center(child: Text('未找到产品'));
          } else {
            final products = snapshot.data!;
            return ListView.builder(
              itemCount: products.length,
              itemBuilder: (context, index) {
                final product = products[index];
                return ListTile(
                  title: Text(product.title),
                  subtitle: Text('\$${product.price}'),
                  leading: Image.network(product.image),
                );
              },
            );
          }
        },
      ),
    );
  }
}