Dart http 客户端 - Dart

Dart http 客户端是 Dart 语言提供的一种支持进行 http 交互的工具。它提供了简单易用的 api，并且支持异步操作，让开发者可以更加方便地实现网络请求。本文将为大家介绍 Dart http 客户端的使用方法及其相关特性。

安装

使用 Dart http 客户端前，我们需要将其添加至我们的 Dart 项目依赖中。

dependencies:
  http: ^0.12.0+2

在安装完成后，我们需要导入 Dart http 客户端所提供的 api。

import 'package:http/http.dart' as http;

发送请求

Dart http 客户端提供了多种方式来发送网络请求，本文我们将为大家介绍其中两种方式：get 请求和 post 请求。

get 请求

GET 请求用于获取某个资源，这里我们将向服务端请求一张图片。

// get 请求
var url = 'https://picsum.photos/200/300'; // request url
var response = await http.get(url); // send get request

以上代码中，我们生成了一个请求链接，然后调用 http 客户端提供的 get 方法，向该链接发送了一个 get 请求。

post 请求

POST 请求用于向服务器提交数据，这里我们将向服务端提交一个表单数据。

// post 请求
var url = 'https://example.com/path'; // request url
var data = {'name': 'jerry', 'age': 18}; // form data
var response = await http.post(url, body: data); // send post request

以上代码中，我们生成了一个请求链接和表单数据，然后调用 http 客户端提供的 post 方法，向该链接发送了一个 post 请求。

响应

当我们发送请求后，服务器将会以响应的方式返回数据，我们需要通过解析响应来得到我们需要的数据。Dart http 客户端提供了 response 类来表示从服务器返回的响应数据。

获取响应状态

我们可以使用 http.Response 对象上的 statusCode 属性来获取服务端返回的响应状态码。

if (response.statusCode == 200) {
    // 200 means success
} else {
    // handle error
}

以上代码中，当 http 响应的状态码为 200 时代表操作成功，我们可以通过该状态码来判断该次请求的是否成功。

获取响应内容

每个 http 响应都包含了一些基本的信息，例如 header 信息，请求 url 等。我们也可以通过 response 类上的 body 属性来获取服务端返回的具体内容。

print(response.body);

以上代码中，我们使用了 response.body 属性来打印出服务端返回的具体内容。

异常处理

在发送网络请求时，有可能会发生一些异常情况，例如网络断开，或者请求 url 错误等。Dart http 客户端提供了一些异常类来让我们捕获这些异常并进行相应操作。

try {
  var response = await http.get('http://example.com/404');
} catch (e) {
  // handle exception
}

在以上代码中，我们使用 try catch 语句块来捕获异常，并在 catch 块中处理异常。

处理 cookie

Dart http 客户端还能很方便地处理 cookie。通过 cookieJar 属性可以获取一个 HttpCookieJar 的实例，它提供了 add 和 get 方法用于增加和获取 cookie。

http.Cookie cookie = http.Cookie('name', 'value');
List<http.Cookie> cookies = [cookie];
http.CookieJar cookieJar = http.CookieJar();
cookieJar.addCookies(cookies);

以上代码中，我们创建了一个 Cookie 集合，将其添加到了 cookieJar 实例中。

结论

Dart http 客户端是 Dart 语言提供的一种简单方便的进行 http 交互的工具，具备异步、回调等特性。通过介绍，相信读者们已经了解了如何使用 Dart http 客户端发送网络请求、获取响应结果、异常处理等操作，并且能够使用 cookieJar 类对 cookie 进行操作。