文章目录
前言
reqwest 是一个简单而强大的 RUST HTTP 客户端，用于浏览器异步 HTTP 请求。支持 xmlHttpRequest, JSONP, CORS, 和 CommonJS 约束。
Reqwest 简单易用，功能强大，包括异步和阻塞模式，可以处理各种类型的请求数据，支持 HTTP 代理、TLS 加密、Cookie 存储等功能，另外还包括了对 WASM 的支持。
一、安装与引用
在项目的 Cargo.toml 中添加依赖：
[dependencies]
reqwest = {
version = "0.11", features = ["json"] }
tokio = {
version = "1", features = ["full"] }
然后在你的程序中引用该库
use std::collections::HashMap;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let resp = reqwest::get("https://httpbin.org/ip")
.await?
.json::<HashMap<String, String>>()
.await?;
println!("{:#?}", resp);
Ok(())
}
以上代码引用了reqwest库，并且创建了一个请求，这个请求的api是
https://httpbin.org/ip
返回当前请求浏览器的ip地址，也就是你当前的ip地址。
运行该示例，看看效果
可以看到，获取到了api返回的json信息，里面包含我当前的ip地址。
二、用法
1. 创建GET请求
如果是单个请求，可以使用get方法
let body = reqwest::get("https://www.rust-lang.org")
.await?
.text()
.await?;
println!("body = {:?}", body);
如果你还要进行其他的多个请求，最好创建个
Client进行复用。
2. 创建POST请求
有以下几种方式你可以设置POST请求体（body）。
1.最基本的方法就是使用RequestBuilder的body方法。只需要设置body的原始数据就好。它接收各种类型，包括String和Vec<u8>。如果你想自定义类型，你可以使用reqwest::Body结构。
let client = reqwest::Client::new();
let res = client.post("http://httpbin.org/post")
.body("the exact body that is sent")
.send()
.await?;
2. 表单
在请求体中发送表单数据是非常常见的。这可以使用任何可以序列化为表单数据的类型来完成。他的类型可以是元组，也可以是HashMap，或者自定义类型，只要你实现了Serialize特质。
// 请求体是`foo=bar&baz=quux`
let params = [("foo", "bar"), ("baz", "quux")];
let client = reqwest::Client::new();
let res = client.post("http://httpbin.org/post")
.form(¶ms)
.send()
.await?;
3. JSON格式
RequestBuilder上还有一个json方法工具，其工作方式与表单方法类似。它可以接受任何可以序列化为JSON的值。JSON功能是非常有必要的。
// 请求体 `{"lang":"rust","body":"json"}`
let mut map = HashMap::new();
map.insert("lang", "rust");
map.insert("body", "json");
let client = reqwest::Client::new();
let res = client.post("http://httpbin.org/post")
.json(&map)
.send()
.await?;
4. 重定向
默认Client会自动的处理重定向，，最大重定向链为10跳。要想自定义这个行为，可以“redirect::Policy”与“ClientBuilder”一起使用。
一个URL，重定向到另一个URL，若是直接跳转，为1跳；若其中夹着一个中转，那么就是2跳，中间夹着N个中转，那就是N+1跳。
5. Cookies
可以使用ClientBuilder上的cookie_store方法启用会话cookie的自动存储和发送。
6. 代理
系统代理默认是启用的
如果你用的是Socks，代理http和https可以使用环境变量http_proxy和https_proxy来提供代理，你可以这么设置代理（仅Linux环境）
export https_proxy=socks5://127.0.0.1:1086
如果你是Windows环境，那么可以用一个reqwest::Proxy结构体，例如
let proxy = reqwest::Proxy::http("https://secure.example")?;
其中"https://secure.example"是个获取代理的URL。此代理会拦截所有请求，然后使用"https://secure.example"的代理。
可以为客户端配置多个代理规则。客户端将按照添加的顺序检查每个代理。这可能意味着，首先添加带有优先拦截规则的代理，如Proxy::all，将阻止列表中后面的代理工作，因此请小心。
启用socks代理
let proxy = reqwest::Proxy::http("socks5://192.168.1.1:9000")?;
7. 使用阻塞请求
阻塞客户端将阻塞要当前线程的执行，而不是直接返回继续执行。但是reqwest::blocking中的功能不能在异步运行时内执行，否则在尝试阻塞时会死机。
在项目的 Cargo.toml 中添加依赖：
reqwest = {
version = "0.11", features = ["blocking", "json"] }
然后代码这么写
use std::collections::HashMap;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let resp = reqwest::blocking::get("https://httpbin.org/ip")?
.json::<HashMap<String, String>>()?;
println!("{:#?}", resp);
Ok(())
}
1. 创建GET请求
阻塞Response 结构体实现了Rust的Read特质，因此许多有用的标准库和第库都有方便的方法，可以在任何可以接受读取的地方获取响应。
let body = reqwest::blocking::get("https://www.rust-lang.org")?
.text()?;
println!("body = {:?}", body);
注意，如果你想要发多个请求，建议创建个Client
2. 创建POST请求
创建POST请求与非阻塞的基本上是一致的，但是如果你想自定义请求体类型的话，就需要使用reqwest::blocking::Body::new()构造方法，也是只有这里与非阻塞的不同，其他的请参考非阻塞的。
let client = reqwest::blocking::Client::new();
let res = client.post("http://httpbin.org/post")
.body("the exact body that is sent")
.send()?;
总结
本期内容学习了纯 Rust 编写的 HTTP 客户端——reqwest，学了其请求HTTP接口的一些方法，
- 创建GET、POST请求
- 使用代理
- 重定向
- 处理Cookies
该库在各类编程语言中，基本上都属于比较重要的一部分，能够发起请求，就可以与web服务器进行交互，能够进行交互，就可以实现更多功能，它必将成为后续相当重要的一部分。