关于C++ Qt项目实现最简单Http Server的踩坑记录

前言

在开发Qt项目中，需要实现一个Http服务器功能，接收并处理客户端的http请求，Qt的发行版中并没有提供相应的类来处理，所以要实现该功能只能找其他开源项目了，本文主要记录我在收集相关资料过程中踩过的坑，希望能给需要的人提供一点帮助。

qthttpserver

前面说到，Qt官方在发行版中并没有提供相应的类来实现HTTP 服务端，但是Qt-lab中提供了一个qthttpserver， Github地址在这里 ，不知道基于什么原因Qt官方没有将其纳入正式的Qt发行版中，如果要使用qthttpserver的话，就得自己下载源码进行编译了，不过编译可没那么容易，会遇到各种错误，而且还没有提供说明文档，这就不太友好了。由于时间紧迫，折腾一番之后决定采用别的方法，感兴趣的可以去研究一番。

cpp-httplib

这是Github上一个开源的C++实现http server的项目，使用方法非常简单，就只有一个头文件，引入到自己的项目中就可以使用了，不过这是一个多线程“阻塞”HTTP 库，如果您正在寻找“非阻塞”库，那就要换别的了。具体使用可以参考Github里面的文档介绍，很详细。 Github地址在这里

但是，在实际体验的过程中发现一个问题，先看它提供的简单demo，server端，接收客户端的post请求：

#define CPPHTTPLIB_OPENSSL_SUPPORT
#include "path/to/httplib.h"

// HTTP
httplib::Server svr;

// HTTPS
httplib::SSLServer svr;

svr.Post("/hello", [](const httplib::Request &, httplib::Response &res) {
   //处理接收的消息
   //to do...
   //并返回数据给客户端
  res.set_content("this is post server reply.", "text/plain");
});

svr.listen("0.0.0.0", 8080);

在svr.Post参数中的lambda函数中会收到客户端post发送的数据，并在这里返回数据给客户端，这里是在子线程中的，我在Qt项目中，想在此处发信号出来通知主线程去处理别的事情，发完信号后，主线程不能用异步的方式（Qt::QueuedConnection）连接 该信号，只能用直连（Qt::DirectConnection），这样就带来一个问题，无法与主线程通信了，如果需要更新UI等操作，就没法进行。

经过综合考量，最终还是放弃了这个开源库的使用。

QtWebApp

QtWepApp 是 C++ 中的 HTTP 服务器库，适用于 Linux、Windows、Mac OS 和Qt 框架支持的许多其他操作系统。

这个库使用也非常简单，而且可以支持Qt框架，所以比较适合在Qt项目中使用。

官网介绍在这里

Github地址在这里

无需编译成动态库，可以直接将其源码导入到自己的项目中，源码中有提供 .pri文件，在工程文件中导入就可以了。

简单使用：

// The request handler receives and responds HTTP requests
void MyRequestHandler::service(HttpRequest& request, HttpResponse& response)
{
    // Get a request parameters
    QByteArray username = request.getParameter("username");

    // Set a response header
    response.setHeader("Content-Type", "text/html; charset=UTF-8");

    // Generate the HTML document
    response.write("");
    response.write("Hello ");
    response.write(username);
    response.write("");
}

// The main program starts the HTTP server
int main(int argc, char *argv[])
{
    QCoreApplication app(argc,argv);

    new HttpListener(
        new QSettings("configfile.ini",QSettings::IniFormat,&app),
        new MyRequestHandler(&app),
        &app);

    return app.exec();
}

具体使用方法可以参照提供的两个demo。

它提供了通过配置文件来设置相关参数，上面的代码是读取本地配置文件，也可以在代码中进行配置

m_pSettings=new QSettings(QSettings::UserScope,this);
 m_pSettings->setValue("port",port);
 m_pSettings->setValue("minThreads","1"); 
 m_pSettings->setValue("maxThreads","2");
 m_pSettings->setValue("cleanupInterval","60000");
 m_pSettings->setValue("readTimeout","60000");
 m_pSettings->setValue("maxRequestSize","16000");
 m_pSettings->setValue("maxMultiPartSize","10000000");
 m_pSettings->sync();

 m_pRequestHander = new RequestHandler(this);
new HttpListener(m_pSettings,m_pRequestHander,this);

需要注意的是，用QSettings需要先设置，否则QSettings不能生效

QCoreApplication::setOrganizationName("xxx");
QCoreApplication::setApplicationName("xxx");

最终在项目中选择了第三种方案。

【领QT开发教程学习资料，点击下方链接莬费领取 ，先码住不迷路~】

点击这里：「链接」