cpp-httplib 是一个C++语言编写的Web Server库,它可以帮助您在短时间内构建一个高效的Web服务应用程序。cpp-httplib使用简单,支持多种HTTP请求类型,并包含错误处理程序。本篇文章将从以下几个方面详细阐述cpp-httplib的使用方法和应用场景:
一、基本使用
1、导入cpp-httplib:
#include <httplib.h>
2、创建一个 HTTP Server:
httplib::Server svr;
3、在 HTTP Server 上注册 GET 方法:
svr.Get("/", [](const httplib::Request &req, httplib::Response &res) {
res.set_content("Hello World!", "text/plain");
});
4、启动 HTTP Server:
svr.listen("localhost", 1234);
上面的代码将在本地启动一个Server并监听端口号为1234,然后它将注册URI “/” 的GET方法,并返回Hello World!。
二、HTTP 请求和响应
1、根据 URI 动态获取请求的参数:
svr.Post("/submit", [](const httplib::Request &req, httplib::Response &res) {
auto name = req.get_param_value("name");
auto age = req.get_param_value("age");
res.set_content("Name: " + name + ", Age: " + age, "text/plain");
});
2、通过 Query String 或 JSON 主体获取请求的数据:
svr.Post("/submit", [](const httplib::Request &req, httplib::Response &res) {
auto qs_name = req.get_query_value("name");
auto qs_age = req.get_query_value("age");
nlohmann::json json;
json["name"] = req_json.value("name", "No Name");
json["age"] = req_json.value("age", 0);
auto req_body = json.dump();
res.set_content("Name: " + qs_name + ", Age: " + qs_age + ", Request Body: " + req_body, "text/plain");
});
3、设置响应头:
res.set_header("Server", "MyServer/1.0");
4、设置响应主体:
res.set_content("Hello World!", "text/plain");
三、高级功能
1、文件服务:
httplib::Server svr;
svr.set_file_extension_and_mimetype_mapping({
{"htm", "text/html"},
{"html", "text/html"},
{"css", "text/css"},
{"gif", "image/gif"},
{"jpg", "image/jpeg"},
{"png", "image/png"},
{"js", "application/javascript"}
});
svr.set_mount_point("/", "./public_html");
svr.listen("localhost", 1234);
2、验证器:
struct ValidUser {
std::string user_name, password;
bool operator==(const ValidUser& rhs) const {
return user_name == rhs.user_name && password == rhs.password;
}
};
class Authenticator : public httplib::Authentication {
public:
Authenticator() {}
bool operator()(const httplib::Request& req) override {
auto auth_headers = req.get_header_value("Authorization");
if (!auth_headers.empty()) {
auto creds = split_basic_auth_header(auth_headers);
for (const auto& user : m_validUsers) {
if (creds.first == user.user_name && creds.second == user.password) {
return true;
}
}
}
return false;
}
void add_user(const std::string& user_name, const std::string& password) {
m_validUsers.push_back(ValidUser{user_name, password});
}
private:
std::vector<ValidUser> m_validUsers;
};
httplib::Server svr;
Authenticator auth;
auth.add_user("admin", "123456");
svr.set_authenticator("localhost", auth);
svr.get("/", [](const httplib::Request& /*req*/, httplib::Response& res) {
res.set_content("OK", "text/plain");
});
svr.listen("localhost", 1234);
四、应用场景
1、RESTful API:
cpp-httplib支持GET、POST、PUT、DELETE 以及其他HTTP请求类型,因此可轻松创建RESTful API。
2、轻量级Web服务:
cpp-httplib是一个非常轻巧的Web服务器,不需要安装其他依赖项,非常适合快速构建Web服务应用程序。
3、文件服务:
cpp-httplib可以用于提供静态文件服务,使客户端能够获取Web服务器上的文件资源。
总之,cpp-httplib 是一个更现代的、易于使用的 Web 服务器框架,它旨在帮助开发人员轻松构建高效的 Web 服务应用程序。如果你正在寻找一个灵活的、根据需要进行扩展的 Web 服务器框架,那么 cpp-httplib 可能是你需要的工具。