Flutter请求管理插件uigitdev_request_holder的使用

uigitdev_request_holder 是一个用于管理HTTP请求的Flutter插件，它提供了一个结构化的请求管理框架。本文将介绍如何使用这个插件来发送和处理HTTP请求。

使用示例

以下是一个完整的示例代码，展示了如何使用 uigitdev_request_holder 插件来获取并显示数据。

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  uigitdev_request_holder: ^latest_version

请确保替换 ^latest_version 为最新的版本号。

2. 创建模型类

定义一个模型类 PostModel 来映射从API返回的数据：

class PostModel {
  int? userId;
  int? id;
  String? title;
  String? body;

  PostModel.fromJson(Map<String, dynamic> json) {
    userId = json['userId'];
    id = json['id'];
    title = json['title'];
    body = json['body'];
  }
}

3. 创建请求类

创建一个继承自 HTTPRequestHolder<PostModel> 的请求类 PostRequest，用于配置和发送请求：

import 'package:uigitdev_request_holder/src/http_request_holder.dart';

class PostRequest extends HTTPRequestHolder<PostModel> {
  final int id;

  PostRequest({required this.id});

  [@override](/user/override)
  HTTPRequestProtocol get protocol => HTTPRequestProtocol.HTTP;

  [@override](/user/override)
  String get host => 'jsonplaceholder.typicode.com';

  [@override](/user/override)
  String get path => '/posts/$id';

  [@override](/user/override)
  HTTPRequestMethod get method => HTTPRequestMethod.GET;

  [@override](/user/override)
  JSONParserType get parserType => JSONParserType.MAP;

  [@override](/user/override)
  JSONMapParser<PostModel>? get mapParser => PostModel.fromJson;

  [@override](/user/override)
  HTTPRequestHolderSettings get settings {
    return HTTPRequestHolderSettings(
      isDebugPrint: true,
    );
  }

  [@override](/user/override)
  HTTPRequestHolderDummyResponse? get dummyResponse {
    return HTTPRequestHolderDummyResponse(
      isDummyResponse: false,
      duration: const Duration(seconds: 2),
      json: {
        "userId": 1,
        "id": 1,
        "title": "Dummy title response",
        "body": "Use this function if you want to see dummy data.",
      },
      dummyErrorResponse: HTTPRequestHolderDummyErrorResponse(
        isDummyErrorResponse: false,
        error: HTTPRequestHolderErrorResponse(
          statusCode: 404,
          body: {
            'error': 'Dummy error response',
          },
        ),
      ),
    );
  }
}

4. 构建UI

在主应用程序中构建UI，并使用 FutureBuilder 来异步加载数据：

import 'package:flutter/material.dart';
import 'package:uigitdev_request_holder/src/http_request_holder.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: SizedBox(
          width: double.maxFinite,
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              _postDataBuilder(),
            ],
          ),
        ),
      ),
    );
  }

  Widget _postDataBuilder() {
    return FutureBuilder<PostModel?>(
      future: PostRequest(id: 1).send(),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.done) {
          if (snapshot.hasData) {
            return Text(snapshot.data!.title.toString());
          } else {
            if (snapshot.hasError) {
              if (snapshot.error is HTTPRequestHolderErrorResponse) {
                final error = snapshot.error as HTTPRequestHolderErrorResponse;
                return Text('statusCode: ${error.statusCode}\nbody: ${error.body}');
              }
              return Text('Error: ${snapshot.error}');
            } else {
              return const Text('No data');
            }
          }
        } else {
          return const Text('Loading');
        }
      },
    );
  }
}