在开发应用程序的时候常会需要连到互联网上取得一些数据或是发送一些数据出去,而这当中最常使用的协定就是 HTTP/HTTPS 了!在 Rust 编程语言中,若要使用 HTTP、HTTPS 协定来进行连接,在 crates.io 上虽然已经有很多现成的 HTTP 客户端套件可以使用,但用起来大多很复杂,有的还会需要链接许多动态函数库,导致程序不容易被部署。

Easy HTTP Request

「Easy HTTP Request」是笔者开发的套件,利用「hyper」这个 Rust 生态圈最常用的 HTTP 函数库来完成的简易 HTTP 客户端。提供 GET、POST、PUT、DELETE、HEAD 这五种常用的 HTTP 请求方法,无需处理「future」相关的程序(所以会在同一个线程下运作),可以限制 URL 资源的回应大小、转址次数、连接时间上限,也可以设置是否要允许连到内部网络(包含本地端和局域网路)的网址。

Crates.io

Cargo.toml

easy-http-request = "*"

使用方法

easy_http_request 这个 crate 提供的 HttpRequest 结构体,可以设置 HTTP 请求的标头(headers)、查找(query)和主体(body),数据类型使用泛型。如果想要方便一点,让它们的数据类型都是静态的字符串切片的话,可以使用 StaticHttpRequest 这个类型来产生 HttpRequest 的结构实体。如果想要让它们的数据类型都是 String 结构体的话,可以使用 DefaultHttpRequest 这个类型来产生 HttpRequest 的结构实体。

HttpRequest 结构体提供了 get、post、put、delete 和 head 这五种关联函数来快速产生 HttpRequest 的结构实体,且这五种关联函数都另外有以 _from_url_str 结尾的函数(如 get_from_url_str)。

最基本的使用范例如下:

use easy_http_request::DefaultHttpRequest;

fn main() {
    let response = DefaultHttpRequest::get_from_url_str("https://tool.magiclen.org/ip").unwrap().send().unwrap();

    println!("{}", String::from_utf8(response.body).unwrap());
}

以上程序可以印出目前电脑的对外 IP。

HttpRequest 的结构实体在使用 send 方法之后,拥有权就会被拿走,而不能再被使用了。如果要重复使用同一个 HttpRequest 的结构实体来发送请求的话,就要使用 send_preserved 方法。

另外,预设能接收的 HTTP 回应大小上限为 1 MiB,如果想要更改,可以去设置 HttpRequest 结构实体的 max_response_body_size 字段;预设能转跳的次数为 5 次,如果想要更改,可以去设置 HttpRequest 结构实体的 max_redirect_count 字段;预设并不会限制连接时间,如果想要更改,可以去设置 HttpRequest 结构实体的 max_connection_time 字段,时间单位是毫秒;预设会允许访问内部的网址,如果想要更改,可以去设置 HttpRequest 结构实体的 allow_localhost 字段。