Flutter插件fliq的使用方法

Fliq 是一个简单且流畅的 Flutter 库，用于构建 Restful 客户端。它的重点在于易用性和可读性。它提供了干净简洁的 API 来发送 HTTP 请求，支持诸如分层路径、查询参数、头部信息和 JSON 请求编码等功能。

开始使用Flutter插件fliq

1. 安装包

在你的 pubspec.yaml 文件中添加以下内容：

dependencies:
  fliq: ^1.0.0

然后运行：

flutter pub get

2. 导入 Fliq

import 'package:fliq/fliq.dart';

3. 创建实例

final client = Fliq();

4. 发送请求

// 示例 1: 分层路径
final response1 = await client
    .get('http://localhost:8080/api/book/1')
    .go();
print('示例 1: ${response1.statusCode}');

// 示例 2: 使用 path() 方法的分层路径
final response2 = await client
    .get('http://localhost:8080/api')
    .path('book')
    .path('1')
    .go();
print('示例 2: ${response2.statusCode}');

// 示例 3: 查询参数
final response3 = await client
    .get('/books')
    .query('page', '2')
    .go();
print('示例 3: ${response3.statusCode}');

// 示例 4: 头部信息
final response4 = await client
    .get('/book')
    .header('page', '2')
    .go();
print('示例 4: ${response4.statusCode}');

// 示例 5: JSON 请求编码
final response5 = await client
    .post('/book')
    .json({'id': '1', 'title': 'Harry Potter'})
    .go();
print('示例 5: ${response5.statusCode}');

功能

• 分层路径: 简单地构建 RESTful 端点的分层路径。
• 查询参数: 使用流畅 API 添加查询参数。
• 头部信息: 在请求中包含自定义头部信息，用于认证或其他用途。
• JSON 请求编码: 轻松发送 JSON 编码的请求体。
• JSON 响应解码: 使用提供的映射函数将 JSON 响应解码为 Dart 对象。
• 多种 HTTP 方法: 支持各种 HTTP 方法，包括 GET、POST、PUT 和 DELETE。

示例

查看 example.dart 文件以获取全面展示不同功能的使用示例。

贡献

欢迎贡献！如果你有任何问题或建议，可以打开 issue 或提交 pull request。让我们一起构建一个强大且用户友好的 Flutter Rest Client 库吧！

示例代码

以下是完整的示例代码：

import 'package:fliq/fliq.dart';

// 示例使用：
void main() async {
  try {
    final client = Fliq();

    // 示例 1: 分层路径
    final response1 = await client
        .get('http://localhost:8080/api/book/1')
        .go();
    print('示例 1: ${response1.statusCode}');

    // 示例 2: 使用 path() 方法的分层路径
    final response2 = await client
        .get('http://localhost:8080/api')
        .path('book')
        .path('1')
        .go();
    print('示例 2: ${response2.statusCode}');

    // 示例 3: 查询参数
    final response3 = await client
        .get('/books')
        .query('page', '2')
        .go();
    print('示例 3: ${response3.statusCode}');

    // 示例 4: 头部信息
    final response4 = await client
        .get('/book')
        .header('page', '2')
        .go();
    print('示例 4: ${response4.statusCode}');

    // 示例 5: JSON 请求编码
    final response5 = await client
        .post('/book')
        .json({'id': '1', 'title': 'Harry Potter'})
        .go();
    print('示例 5: ${response5.statusCode}');

    client.close();
  } catch (e) {
    print('错误: $e');
  }
}