1 背景
大多数嵌入式设备由于没有屏幕输出，只能通过Web页面来配置。这里利用CPPHttpLib来实现HttpServer。
HttpServer_2">2 HttpServer
HttpServer是利用CPPHttpLib开源库实现的Http服务器CppHttpLib是基于C++11的HTTP开源库，开源协议是MIT.
CppHttpLib下载地址
HttpServer_5">2.1 HttpServer定义
2.1.1 Http头文件
#ifndef HTTP_H
#define HTTP_H
#include "httplib.h"
namespace http = httplib;
#endif
该文件引用C++ HTTPLIB库头文件httplib.h,将命名空间httplib重命名为http，简化后续引用。
HttpServer_15">2.1.1 HttpServer头文件
#include "http.h"#include <string>struct HttpServer : private http::Server
{HttpServer(bool is_log = false);bool set_root_path(std::string const& url, std::string const& dir);HttpServer &get(const std::string &pattern, http::Server::Handler handler);HttpServer &post(const std::string &pattern, http::Server::Handler handler);HttpServer &put(const std::string &pattern, http::Server::Handler handler);bool run(const char *host, int port);
private:std::string log(const http::Request &req, const http::Response &res);std::string dump_headers(const http::Headers &headers);
private:bool is_log_;
};
类型说明：
- HttpServer 构造函数，参数is_log用来指示HttpServer是否打印日志，在调试时会很有用。
- set_root_path 设置静态网页的URL和文件路径
- get 设置get请求处理函数
- post 设置post请求处理函数
- put 设置put请求处理函数
- run 运行httpserver，参数host为主机地址，port为端口。
HttpServer_46">2.2 HttpServer实现
2.2.1 构造函数
HttpServer::HttpServer(bool is_log)
: is_log_(is_log)
{if(is_log_)set_logger([this](const http::Request &req, const http::Response &res) {printf("%s", this->log(req, res).c_str());});
}
函数说明：
- 如果需要log，则调用HttpLib库的set_logger函数设置打印log函数。
2.2.2 set_root_path
bool HttpServer::set_root_path(std::string const& url, std::string const& dir)
{return set_mount_point(url, dir);
}
函数说明：
- 调用HttpLib库的set_mount_point设置静态网页的URL和文件路径
2.2.3 get/post/put
HttpServer &HttpServer::get(const std::string &pattern, http::Server::Handler handler)
{Get(pattern, handler);return *this;
}HttpServer &HttpServer::post(const std::string &pattern, http::Server::Handler handler)
{Post(pattern, handler);return *this;
}
HttpServer &HttpServer::put(const std::string &pattern, http::Server::Handler handler)
{Put(pattern, handler);return *this;
}
函数说明：
- 调用HttpLib库对象函数设置请求处理函数。
- 函数返回HttpServer引用是为了连续设置请求函数。
2.2.4 run
bool HttpServer::run(const char *host, int port)
{return listen(host, port);
}
函数说明：
- 调用listen启动http服务，该函数是阻塞函数。如果不想要阻塞的话，可以放到线程中执行该函数。
2.2.5 log
std::string HttpServer::log(const http::Request &req, const http::Response &res)
{std::string s;char buf[BUFSIZ];s += "================================\n";snprintf(buf, sizeof(buf), "%s %s %s", req.method.c_str(),req.version.c_str(), req.path.c_str());s += buf;std::string query;for (auto it = req.params.begin(); it != req.params.end(); ++it) {const auto &x = *it;snprintf(buf, sizeof(buf), "%c%s=%s",(it == req.params.begin()) ? '?' : '&', x.first.c_str(),x.second.c_str());query += buf;}snprintf(buf, sizeof(buf), "%s\n", query.c_str());s += buf;s += dump_headers(req.headers);s += "--------------------------------\n";snprintf(buf, sizeof(buf), "%d %s\n", res.status, res.version.c_str());s += buf;s += dump_headers(res.headers);s += "\n";if (!req.body.empty()) { s += req.body; }s += "\n";return s;
}std::string HttpServer::dump_headers(const http::Headers &headers) {std::string s;char buf[BUFSIZ];for (auto it = headers.begin(); it != headers.end(); ++it) {const auto &x = *it;snprintf(buf, sizeof(buf), "%s: %s\n", x.first.c_str(), x.second.c_str());s += buf;}return s;
}
函数说明：
- log函数将Request和Response转换为文本方便后续输出。
- dump_headers函数将Headers转换为文本。
3 实例
#include "httpserver.h"int main(int argc, char* argv[])
{bool isLog = true;HttpServer server(isLog);if(argc > 1)server.set_root_path("/", argv[1]);elseserver.set_root_path("/", "dist/www");server.run("0.0.0.0", 80);return 0;
}
说明：
- 定义HttpServer
- 设置主页路径
- 启动服务
4 总结
利用CppHttpLib库实现一个HttpServer还是很简单的。
