目录
安装httplib库
认识httplib库
httplib请求类
httplib响应类
httplib中的Server类
httplib的client类
httplib库搭建简单的服务器
httplib库搭建简单的客户端
安装httplib库
1.进入github,搜索httplib库
2.下载库
3.下载完毕将库的压缩包传输到linux系统下
4.解压库
unzip cpp-httplib-master.zip
认识httplib库
- httplib 库,一个 C++11 单文件头的跨平台 HTTP/HTTPS 库。
- httplib 库实际上是用于搭建一个简单的 http 服务器或者客户端的库,这种第三方网络库,可以让我们免去搭建服 务器或客户端的时间,把更多的精力投入到具体的业务处理中,提高开发效率。
httplib请求类
- httplib请求类是它包含了http请求中的请求行的请求方法,url,协议版本以及请求报头中的各个响应报头值
namespace httplib{
//文件信息结构体
struct MultipartFormData {
std::string name; //字段名称
std::string content; //文件内容
std::string filename; //文件名称
std::string content_type;//文件类型
};
using MultipartFormDataItems = std::vector<MultipartFormData>;
struct Request {
std::string method; //请求方法
std::string path; //资源路径
Headers headers; //请求报头
std::string body; //请求正文
// for server
std::string version; //协议版本
Params params; //查询字符串
MultipartFormDataMap files;//保存的是客户端上传的文件信息
Ranges ranges; //
//判断请求报头中有没有 某个字段
bool has_header(const char *key) const;
//获取请求报头中对应的字段值
std::string get_header_value(const char *key, size_t id = 0) const;
//将key-val的字段值设定在http请求中
void set_header(const char *key, const char *val);
//判定是否有对应的文件
bool has_file(const char *key) const;
//获取对应的文件信息
MultipartFormData get_file_value(const char *key) const;
};
httplib响应类
httplib类是将响应行,响应报头,响应正文设定到Response类的对象中,然后将Response对象组织成http响应的形式发送给对方。
struct Response {
std::string version; //协议版本号,默认时http1.1
int status = -1; //响应状态码,
std::string reason;
Headers headers; //响应报头
std::string body; //响应正文
std::string location; // 重定向位置
//以key-val将相应的字段设定到响应报头中
void set_header(const char *key, const char *val);
void set_content(const std::string &s, const char *content_type);
};
httplib中的Server类
class Server {
//Handler一个函数指针名称,它的参数是Request,和Response
using Handler = std::function<void(const Request &, Response &)>;
//Handlers是一个映射表,它映射对应的请求资源和处理函数映射在一起
using Handlers = std::vector<std::pair<std::regex, Handler>>;
//将Get方法的请求资源与处理函数加载到Handlers表中
Server &Get(const std::string &pattern, Handler handler);
Server &Post(const std::string &pattern, Handler handler);
Server &Put(const std::string &pattern, Handler handler);
Server &Patch(const std::string &pattern, Handler handler);
Server &Delete(const std::string &pattern, Handler handler);
Server &Options(const std::string &pattern, Handler handler);
//线程池
std::function<TaskQueue *(void)> new_task_queue;
//搭建并启动http
bool listen(const char *host, int port, int socket_flags = 0);
};
Handler表结构:
如上面的Handlers表中:
- 如果http请求的请求方法是GET方法,且请求资源是/hello,那么服务器则会调用Hello函数,构建相对应的http响应。
- 如果http请求的请求方法是POST方法,且请求资源是/Post,那么服务器则会调用Post函数. 构建相对应的http响应。
- 如果http请求中的请求方法和请求资源中 只要有一个不存在Handlers表中或者不符合在Handlers表中,则http服务器会返回一个404的http响应。
- Get("/hello",Hello):将请求方为GET,请求资源/hello,与函数Hello 注册 在Handlers表中
- Post("/post",Post):将请求方法POST,请求资源/post,与函数Post 注册 在Handlers表中
线程池的工作
- 当服务器收到一个http请求的时候,就会将该http请求放入到线程池中,线程池中的线程就会调用相对应的函数解析http请求形成Request类。
- 在Handler映射表中,如果有相对应请求方法和请求资源有相对应的映射函数,则会调用相对应的映射函数,并构建好http响应.
- 当处理函数调用完后,则将构建好的http响应发送给客户端。
httplib的client类
class Client {
//构造一个客户端对象,传入服务器Ip地址和端口
Client(const std::string &host, int port);
//向服务器发送GET请求
Result Get(const char *path, const Headers &headers);
//向服务器发送Post请求
//path是路径,body是request请求路径
//content_length是正文大小
//content_type是正文的类型
Result Post(const char *path, const char *body, size_t content_length,
const char *content_type);
//以Post方法上传文件
Result Post(const char *path, const MultipartFormDataItems &items);
}
httplib库搭建简单的服务器
搭建服务器的步骤:
- 利用httplib库定义server对象
- 在Handler表结构中注册 请求资源的处理函数
- 用listen启动服务器
#include<iostream>
#include"httplib.h"
using namespace std;
W>void Hello(const httplib::Request& req,httplib::Response& res){
res.set_content("Hello world","text/plain");
res.status=200;
}
void File(httplib::Request req,httplib::Response res){
//获取字段为file的文件
const auto& file=req.get_file_value("file");
std::cout<<file.filename<<endl;
std::cout<<file.content<<endl;
}
int main(){
httplib::Server server;//定义sercer对象
//注册处理函数
server.Get("/hi",Hello);
server.Post("/file",File);
server.listen("0.0.0.0",8081);//启动服务器
return 0;
}
文章来源地址https://www.toymoban.com/news/detail-412814.html
注意:
- 注册处理函数中的Request参数需要定义为const
- 注册处理函数中Request和Response参数都需要是引用,否则浏览器会接受不到正文内容.
httplib库搭建简单的客户端
#include"httplib.h"
#define IP "119.23.41.13"
#define PORT 8081
using namespace std;
int main(){
//建立客户端对象
httplib::Client client(IP,PORT);
//单个文件信息组织
httplib::MultipartFormData file;
file.name="file";
file.content="hello world";
file.filename="Hello.txt";
file.content_type="text/plain";
//MultipartFormDataItems对象可以存储多个文件信息
httplib::MultipartFormDataItems item;
item.push_back(file);
//请求服务器上/file资源,发送item文件集合给服务器
auto result=client.Post("/file",item);
return 0;
}
文章来源:https://www.toymoban.com/news/detail-412814.html
到了这里,关于httplib库的安装以及使用的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!