Flutter 封装 dio，支持 Restful Api

背景

Dio 是 Flutter 社区开源的网络请求库。

为什么要封装 dio？

做一些公共处理。

要做哪些公共处理？

• 统一处理请求前缀；（https://novel.dkvirus.com/api/v1 不用每个请求都加前缀）
• 统一打印请求信息；
• 统一打印响应信息；
• 统一打印报错信息；
• 返回数据自动转 json 格式；

对于 Flutter 新手，仅仅想要发送网络请求，复制下面代码并直接使用吧。

快速开始

添加 dio 依赖

编辑 项目根目录/pubspec.yaml，找到 dependecies 属性，添加 dio 依赖。

dependencies:
  flutter:
    sdk: flutter

  dio: 1.0.13

添加工具类

新建 项目根目录/utils/HttpUtils.dart，将下面内容 copy 进去。

import 'package:dio/dio.dart';
import 'dart:async';

/*
 * 封装 restful 请求
 * 
 * GET、POST、DELETE、PATCH
 * 主要作用为统一处理相关事务：
 *  - 统一处理请求前缀；
 *  - 统一打印请求信息；
 *  - 统一打印响应信息；
 *  - 统一打印报错信息；
 */
class HttpUtils {

  /// global dio object
  static Dio dio;

  /// default options
  static const String API_PREFIX = 'https://novel.dkvirus.com/api/v1';
  static const int CONNECT_TIMEOUT = 10000;
  static const int RECEIVE_TIMEOUT = 3000;

  /// http request methods
  static const String GET = 'get';
  static const String POST = 'post';
  static const String PUT = 'put';
  static const String PATCH = 'patch';
  static const String DELETE = 'delete';

  /// request method
  static Future

使用示例

import 'dart:async';
import '../utils/HttpUtils.dart';

// GET 请求
// 返回的结果直接就是 json 格式
// 要使用 await，必须在方法名后面加上 async
_handleGetShelf () async {
  var result = await HttpUtils.request(
    '/gysw/shelf', 
    method: HttpUtils.GET,
    data: {
      'id': 1,
    }
  );
}


// POST 请求
_handleAddShelf () async {
  var result = await HttpUtils.request(
    '/gysw/shelf', 
    method: HttpUtils.POST,
    data: {
      'id': 1,
    }
  );
}

// PUT 请求
_handleEditShelf () async{
  var result = await HttpUtils.request(
    '/gysw/shelf/:id', 
    method: HttpUtils.PUT,
    data: {
      'id': 1,
    }
  );
}

// DELETE 请求
_handleDelShelf () async {
  var result = await HttpUtils.request(
    '/gysw/shelf/:id', 
    method: HttpUtils.DELETE,
    data: {
      'id': 1,
    }
  );
}

最后

如果在使用过程遇到问题，欢迎下方留言交流。