Flutter模拟商店API交互插件dart_fake_store_api_wrapper的使用

Dart Fake Store API Wrapper

Dart Fake Store API Wrapper 是一个用于与 Fake Store API 交互的 Dart 库。该包提供了一种简单的方式来执行产品和购物车的 CRUD 操作。

特性

• 获取产品：列出所有可用的产品。
• 获取单个产品：通过其 ID 获取产品的详细信息。
• 将产品添加到购物车：将产品添加到购物车中。

安装

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

dependencies:
  dart_fake_store_api_wrapper: ^0.0.4

然后运行：

dart pub get

基本用法

以下是如何使用该包来获取产品、获取单个产品并将其添加到购物车的示例。

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final _apiWrapper = DartFakeStoreApiWrapper();
  String productsObtained = '';
  String singleProductObtained = '';
  String productAddedToCart = '';

  @override
  void initState() {
    super.initState();
    fetchData();
  }

  Future<void> fetchData() async {
    try {
      // 获取所有产品
      final productos = await _apiWrapper.runFetchProducts();
      setState(() {
        productsObtained = 'Products obtained: ${productos.length}';
      });

      // 获取单个产品
      final producto = await _apiWrapper.runFetchSingleProduct(1);
      setState(() {
        singleProductObtained = 'Product obtained: ${producto.title}';
      });

      // 将产品添加到购物车
      final cart = CartEntity(
        userId: 1,
        date: DateTime.now(),
        products: [
          ProductQuantityEntity(
            productId: 1,
            quantity: 2,
          ),
        ],
      );
      final carrito = await _apiWrapper.runSendProductToCart(cart);
      setState(() {
        for (var cart in carrito.products) {
          productAddedToCart = 'Products added to cart: ${cart.quantity}';
        }
      });
    } catch (e) {
      print(e);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(
              productsObtained,
              style: const TextStyle(fontSize: 16),
            ),
            const SizedBox(height: 20),
            Text(
              singleProductObtained,
              style: const TextStyle(fontSize: 16),
            ),
            const SizedBox(height: 20),
            Text(
              productAddedToCart,
              style: const TextStyle(fontSize: 16),
            ),
          ],
        ),
      ),
    );
  }
}

API

DartFakeStoreApiWrapper

runFetchProducts

Future<List<ProductEntity>> runFetchProducts();

获取可用产品的列表。

runFetchSingleProduct

Future<ProductEntity> runFetchSingleProduct(int productId);

通过其 ID 获取单个产品的详细信息。

runSendProductToCart

Future<CartEntity> runSendProductToCart(CartEntity cart);

将产品添加到购物车中。

runFetchCategories

Future<List<CategoryEntity>> runFetchCategories();

列出可用的类别。

模型

ProductEntity

class ProductEntity {
  final int id;
  final String title;
  final double price;
  final String description;
  final String category;
  final double rating;
  final String image;

  ProductEntity({
    required this.id,
    required this.title,
    required this.price,
    required this.description,
    required this.category,
    required this.rating,
    required this.image,
  });
}

表示具有详细信息的产品。

CartEntity

class CartEntity {
  final int id;
  final int userId;
  final String date;
  final List<CartProduct> products;

  CartEntity({
    required this.id,
    required this.userId,
    required this.date,
    required this.products,
  });
}

表示购物车。

CartProduct

class CartProduct {
  final int productId;
  final int quantity;

  CartProduct({
    required this.productId,
    required this.quantity,
  });
}

表示购物车中的产品。

测试

要运行单元测试，执行以下脚本：

chmod +x run_all_tests.sh
./run_all_tests.sh

覆盖报告

要打开测试覆盖率报告，执行以下命令：

open coverage/html/index.html