Rust 翻译计划——网络编程 curl 库 (上)

栏目: 编程语言 · Rust · 发布时间: 7年前

内容简介:Rust 翻译计划——网络编程 curl 库 (上)

本文目录:

  1. 简介
  2. 快速通道
  3. 翻译--curl库
    • easy模块
    • multi模块

1. 简介

虽然这个系列是属于Rust使用库翻译计划的系列之一,但是由于该库官网提供的使用文档几乎等于没有,所以本文实际上是简单翻译一下api文档后小生自己写的使用文档,Orz。

2. 快速通道

所有的翻译文章将集中导航于:Rust常用库翻译计划

3.翻译——curl库

该库主要实现了网络通信中作为客户端会使用到的几乎所有的函数,其中常用的遇到的需求,几乎都可以使用easy模块来实现。在easy模块中总共定义了八个Struct,十个枚举以及数不清的函数,其中函数按照功能大概可以分为以下几类:

  • 配置类函数
  • 构建类函数
  • 信息获取类
  • 纯粹操作类
  • 回调类函数

其中配置类函数占了绝大多数,这类函数主要用于设置发送请求时的请求头、验证信息等等一系列的配置选项,几乎全部是返回 Result<(), Error>,所以几乎等于没有返回值,直接每个函数调用后unwrap一下就可以了。构建类函数主要就是new和transfer,返回一个结构体实例。信息获取类函数即调用后获取头信息之类的相关信息的函数.纯粹操作类的函数即类似于perform这类,调用后会直接将请求发出,返回无意义的Result<(), Error>,也不需要传入参数,只是单纯的提示系统该执行某个操作了。最后回调类函数即使类似write_function这类,接受一个闭包作为参数,在执行固定操作完成后便会调用该闭包函数。

示例一:简单入门

extern crate curl;
use curl::easy::Easy;
use std::io::{
   Write,
   stdout
};
fn main() {
    let mut easy = Easy::new();
    easy.url("http://juejin.im").unwrap();
    easy.write_function(|data| {
        Ok(stdout().write(data).unwrap())
    }).unwrap();
    easy.perform().unwrap();
}
这个例子中使用了curl库,并且使用了easy模块的命名空间,首先使用new函数新建了一个easy实例,然后通过url函数设置了访问的主机地址,然后继续设置了拉取到数据后的回调函数write_function,传入一个闭包函数,参数data即为服务器返回的数据,该闭包返回一个Result

+ Send + 'static,所以直接一条语句顺便输出了服务器返回的data,然后调用perform函数,让请求正式发出。结果如下:

Rust 翻译计划——网络编程 curl 库 (上)
upload successful

可以看出确实获取到了服务器的返回的数据,不过由于服务器做了3xx重定向,导致拉取到了一个无意义的重定向以前的页面,所以要设置让系统跟随头文件的设置一起跳转

示例二:跟随重定向

extern crate curl;
use curl::easy::Easy;
use std::io::{
   Write,
   stdout
};
fn main() {
    let mut easy = Easy::new();
    easy.nobody(true).unwrap();
    easy.url("http://juejin.im").unwrap();
    easy.follow_location(true).unwrap();
    easy.write_function(|data| {
        Ok(stdout().write(data).unwrap())
    }).unwrap();
    easy.perform().unwrap();
    println!("last_Url:{:?}",easy.effective_url().unwrap().unwrap());
    println!("response_code:{:?}",easy.response_code().unwrap());
    println!("http_connectcode:{:?}",easy.http_connectcode().unwrap());
    println!("filetime:{:?}",easy.filetime().unwrap());
    println!("total_time:{:?}",easy.total_time().unwrap());
}

这个例子中,通过follow_location配置设置了跟随重定向跳转,所以可以获取到掘金首页的html,不过由于内容过大,影响观看,所以这里调用了nobody函数,配置不返回body体,然后顺便在结束后打印出一部分相关的信息。

Rust 翻译计划——网络编程 curl 库 (上)
upload successful

示例三:关于回调函数

fn main() {
    let mut easy = Easy::new();
    easy.url("http://www.yzyxw.online/api/round/getQuestion").unwrap();
    easy.post(true).unwrap();
    //easy.nobody(true).unwrap();
    easy.header_function(|data| {
        print!("header: {}", str::from_utf8(data).unwrap());
        true
    }).unwrap();
    easy.write_function(|data| {
        Ok(stdout().write(data).unwrap())
    }).unwrap();
    easy.read_function(|into| {
        Ok(stdin().read(into).unwrap())
    }).unwrap();
    easy.perform().unwrap();

}

这里分别实现了读写和头三个回调,其中头回调函数会在获得http头的是后将头信息作为参数传入闭包中,这里打印出了头信息,write回调会在获得服务器返回数据后调用闭包,将服务器返回数据传入闭包参数中。特别说明:如果设置了show_header(true),那么返回信息中会同时包含头信息。。关于读回调,主要是用于设置访问服务器时携带数据的方式之一,将标准输入数据拷贝仅回调的参数中,该数据将会被携带至服务器,为了能携带数据,这里将访问模式这是成了post。

当然,由于这里的操作都是从标准输入输出中读取的,在回调闭包中,对外部变量的借用是不被允许的,在回调外定义一个数据,在读回调中使用时不允许的,就像这样:

{% codeblock lang:rust %}

let mut info = &b"tasdasdadad"[..];

easy.read_function(|data| {

Ok(info.read(data).unwrap())

}).unwrap();

easy.perform().unwrap();

{% endcodeblock %}

结果:

Rust 翻译计划——网络编程 curl 库 (上)
upload successful

对于这种情况,该库引入了Transfer,使用transfer()会返回一个transfer实例,该实例拥有着对easy实例的一个可变借用,所以在调用该函数后一直到transfer生命周期结束前都不可以再使用easy句柄来进行一些操作,所以可以选择用大括弧将对应语句段包括起来,人为控制其生命周期。transfer同样实现了easy中所有的回调函数,用transfer可以实现上述不能实现的功能:

关于Transfer:

fn main() {
    let mut easy = Easy::new();
    easy.url("http://www.yzyxw.online/api/round/getQuestion").unwrap();
    easy.post(true).unwrap();
    //easy.nobody(true).unwrap();
    easy.header_function(|data| {
        print!("header: {}", str::from_utf8(data).unwrap());
        true
    }).unwrap();
    easy.write_function(|data| {
        Ok(stdout().write(data).unwrap())
    }).unwrap();
   let mut info = &b"tasdasdadad"[..];
    let mut tran=easy.transfer();
    tran.read_function(|data| {
        Ok(info.read(data).unwrap())
    }).unwrap();
    tran.perform().unwrap();

}

这时便可以在闭包内获取外部上下文引用

伪结语

在easy模块中共定义了七个回调设置函数,使用方式大同小异,剩下便是相关ssl验证,代理设置等等一系列的操作,基本全是通过一系列的设置函数实现的,就不一一赘述了。感兴趣的pong友们可以参考我简单翻译的api传送门,也可以参考官网比较详尽的英文api传送门.

对于该库另一个模块multi将在本文的下篇部分详细解释,同时也将整合各个api制作一份综合实例给喜欢Rust这门目前比较小众的语言的pong友们。

另外,更多Rust库翻译请关注Rust实用库翻译计划


以上所述就是小编给大家介绍的《Rust 翻译计划——网络编程 curl 库 (上)》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

编程卓越之道

编程卓越之道

Hyde R / 韩东海 / 电子工业出版社 / 2006-4-1 / 49.80

各位程序员一定希望自己编写的代码是能让老板赞赏、满意的代码;是能让客户乐意掏钱购买的代码;是能让使用者顺利使用的代码;是能让同行欣赏赞誉的代码;是能让自己引以为豪的卓越代码。本书作者为希望能编写出卓越代码的人提供了自己积累的关于卓越编程的真知灼见。它弥补了计算机科学和工程课程中被忽略的一个部分——底层细节,而这正是构建卓越代码的基石。具体内容包括:计算机数据表示法,二进制数学运算与位运算,内存组织......一起来看看 《编程卓越之道》 这本书的介绍吧!

XML 在线格式化
XML 在线格式化

在线 XML 格式化压缩工具

RGB HSV 转换
RGB HSV 转换

RGB HSV 互转工具

HEX CMYK 转换工具
HEX CMYK 转换工具

HEX CMYK 互转工具