【一起学Rust | 进阶篇 | reqwest库】纯 Rust 编写的 HTTP 客户端——reqwest

简介: 【一起学Rust | 进阶篇 | reqwest库】纯 Rust 编写的 HTTP 客户端——reqwest



前言

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(&params)
    .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服务器进行交互,能够进行交互,就可以实现更多功能,它必将成为后续相当重要的一部分。

目录
相关文章
|
2月前
|
Rust 安全 开发者
Rust之旅:打造并发布你的首个Rust库
本文将引导读者走进Rust的世界,从基础概念讲起,逐步深入到如何创建、测试、打包和发布自己的Rust库。通过实际操作,我们将理解Rust的独特之处,并学会如何分享自己的代码到Rust社区,从而为开源世界做出贡献。
【计算机网络】如何让客户端构造一个HTTP请求-2
【计算机网络】如何让客户端构造一个HTTP请求-2
【计算机网络】如何让客户端构造一个HTTP请求-2
|
3月前
|
存储 前端开发 JavaScript
【计算机网络】如何让客户端构造一个HTTP请求-1
【计算机网络】如何让客户端构造一个HTTP请求-1
【计算机网络】如何让客户端构造一个HTTP请求-1
|
2月前
|
JavaScript
Node.js【GET/POST请求、http模块、路由、创建客户端、作为中间层、文件系统模块】(二)-全面详解(学习总结---从入门到深化)
Node.js【GET/POST请求、http模块、路由、创建客户端、作为中间层、文件系统模块】(二)-全面详解(学习总结---从入门到深化)
27 0
|
3月前
|
JavaScript
Node.js【GET/POST请求、http模块、路由、创建客户端、作为中间层、文件系统模块】(二)-全面详解(学习总结---从入门到深化)(上)
Node.js【GET/POST请求、http模块、路由、创建客户端、作为中间层、文件系统模块】(二)-全面详解(学习总结---从入门到深化)
29 0
|
3月前
|
JavaScript
Node.js【GET/POST请求、http模块、路由、创建客户端、作为中间层、文件系统模块】(二)-全面详解(学习总结---从入门到深化)(下)
Node.js【GET/POST请求、http模块、路由、创建客户端、作为中间层、文件系统模块】(二)-全面详解(学习总结---从入门到深化)
25 0
|
12天前
|
XML JSON JavaScript
推荐一个比较好用的c++版本http协议库-cpp-httplib
推荐一个比较好用的c++版本http协议库-cpp-httplib
31 1
|
26天前
|
测试技术 API Python
Python3 新一代Http请求库Httpx使用(详情版)(下)
Python3 新一代Http请求库Httpx使用(详情版)
|
26天前
|
XML JSON API
Python3 新一代Http请求库Httpx使用(详情版)(上)
Python3 新一代Http请求库Httpx使用(详情版)
|
1月前
|
监控 网络安全 C++
Qt 5.14.2 网络编程揭秘:构建高效HTTP客户端与文件下载器
Qt 5.14.2 网络编程揭秘:构建高效HTTP客户端与文件下载器