crazybalance / sion

一个轻量级的c++ http client

Sion

特性

• Sion是一个轻量级简单易用的c++ http客户端
• 仅单头文件700行，自带std::string的扩展
• 支持文本及二进制的响应体
• 支持分块(chunked)的传输编码
• 支持http,https请求。https需要安装openssl(推荐使用vcpkg),如果不需要可以使用 #define SION_DISABLE_SSL 关闭

用法

最普通的GET请求

auto resp = Fetch("https://api.zanllp.cn/plugin");
cout << resp.BodyStr << endl;
cout << resp.HeaderValue("content-type") <<endl;

链式调用及POST请求

auto resp = Request()
			.SetUrl("https://api.zanllp.cn/socket/push?descriptor=fHXMHCQfcgNHDq2P")
			.SetHttpMethod(Method::Post)
			.SetBody(R"({"data": 233333,"msg":"hello world!"})")
			.SetHeader("Content-Type", "application/json; charset=utf-8")
			.Send();

使用Sion下载文件

Sion对于Content-Type头是text和application的报文的响应体会使用字符串保存，存在BodyStr中。

例如这些头

• Content-Type: text/html; charset=utf-8
• content-type: application/javascript
• Content-Type: application/json; charset=utf-8

而对于其它的默认保存在BodyCharVec中,具体保存在哪可以看Response::SaveByCharVec

例如这些头

• content-type: image/vnd.microsoft.icon
• content-type: image/gif
• content-type: image/svg+xml

auto resp = Fetch("https://static.zanllp.cn/94da3a6b32e0ddcad844aca6a8876da2ecba8cb3c7094c3ad10996b28311e4b50ab455ee3d6d55fb50dc4e3c62224f4a20a4ddb1.gif");
ofstream file(R"(滑稽.gif)", ios::binary);
file.write(resp.BodyCharVec.data(), resp.BodyCharVec.size() * sizeof(char));

// 当然也支持分块编码传输的
auto resp = Fetch("http://www.httpwatch.com/httpgallery/chunked/chunkedimage.aspx");
ofstream file(R"(分块.jpeg)", ios::binary);
file.write(resp.BodyCharVec.data(), resp.BodyCharVec.size() * sizeof(char));

异步请求

SION是cpp客户端所使用的，在之前用过c#的HttpClient,py的request,js的Fetch，所以会受到这几种的影响，在写之前决定使用阻塞io+异步库的方式。具体怎么搞看例子

其它

Doc

Fetch

// 静态请求方法
Response Fetch(MyString url, Method method = Get, vector<pair<MyString, MyString>> header = {}, MyString body = "");

MyString

该类继承std::string，用法基本一致，拓展了几个函数

//使用字符串分割
//flag 分割标志,返回的字符串向量会剔除,flag不要用char，会重载不明确
//num 分割次数，默认0即分割到结束，例num=1,返回开头到flag,flag到结束size=2的字符串向量
//skipEmpty 跳过空字符串，即不压入length==0的字符串
std::vector<MyString> Split(MyString flag, int num = 0, bool skipEmpty = true);

//清除前后的字符
//target 需要清除的字符默认空格
MyString Trim(MyString target = " ");

//包含字母
bool HasLetter();

// 转成小写，返回一个新的字符串
MyString ToLowerCase();

// 转成大写，返回一个新的字符串
MyString ToUpperCase();

//转换到gbk 中文显示乱码调用这个,一般不需要管
MyString ToGbk();

//返回搜索到的所有位置
//flag 定位标志
//num 搜索数量，默认直到结束
std::vector<int> FindAll(MyString flag, int num = -1);

//字符串替换，会修改原有的字符串，而不是返回新的
MyString& Replace(MyString oldStr, MyString newStr);

Response

该类用来处理请求响应

bool IsChunked ; // 是否分块编码
bool SaveByCharVec; // 是否使用字符数组保存，对于文本直接用字符串保存，其它用char数组
int ContentLength = 0; // 正文长度
MyString Source; // 源响应报文
MyString Cookie; 
MyString ProtocolVersion;
MyString Code;
MyString Status;
MyString BodyStr; // 响应体，对于文本直接保存这
vector<char> BodyCharVec; // 响应体，对于二进制流保存在这
Header ResponseHeader; // 响应头
MyString HeaderValue(MyString k)；// 获取响应体的值（最后一个）

Request

该类用来处理发送请求

//支持链式设置属性
Request& SetHttpMethod(MyString other) ;
Request& SetUrl(MyString url);
Request& SetCookie(MyString cookie);
Request& SetBody(MyString body);
Request& SetHeader(vector<pair<MyString, MyString>> header);
Request& SetHeader(MyString k, MyString v);

//发送请求
Response Send(MyString url);
Response Send(Method method, MyString url);

Header

响应头

// 添加一个键值对到头中
void Add(MyString k, MyString v);

// 获取头的键所对应的所有值
vector<MyString> GetValue(MyString key);

// 获取头的键所对应的值，以最后一个为准
MyString GetLastValue(MyString key);