Drogon - 真正现代化的 C++ 网络服务框架

C++ 是最重要的编程语言之一。它既可以进行、过程化程序设计，又可以进行使用抽象数据类型的基于对象的程序设计，还可以进行以继承和多态为特点的面向对象的程序设计。

然而，由于标准库和社区生态的种种问题，C++ 在 Web 服务端的发展并不如人意。同时，C++ 的服务端框架与其他语言相比，往往更为原始，对各种高级功能的支持更繁琐。C++ 14/17 为这门语言提供了更多优秀的特性，使得实现一个更为现代化的 Web 框架成为可能。

简介

Drogon，是 an-tao 在 Github 上开源的基于 C++ 14/17 的 Http 应用框架，目前版本为 v1.4.1。

Drogon是一个跨平台框架，可以方便地使用 C++ 构建各种类型的 Web 应用服务端程序。其网络层使用基于 epoll，使用全异步编程模式;实现了简单的反射机制，支持后端渲染，支持运行期的视图页面动态加载;支持过滤器链，支持 websocket，支持pipelining，······

使用

Drogon 依赖 trantor，一个非阻塞的 IO 库，以及 jsoncpp、libuuid 和 zlib 等。Drogon 使用 CMake + Make 编译安装：

cd $WORK_PATH

git clone https://github.com/an-tao/drogon

cd drogon

git submodule update --init

mkdir build

cd build

cmake ..

make && sudo make install

也可以在项目中直接使用 Drogon 源码，在项目的 cmake 文件中添加：

add_subdirectory(third_party/drogon)

arget_link_libraries(${PROJECT_NAME} PRIVATE drogon)

安装完成后，就可以开始用 Drogon 来编写 Web 服务应用了。我们来看一个简单的主程序：

#include <drogon/drogon.h>

using namespace drogon;

int main()

{

    app().setLogPath("./")

         .setLogLevel(trantor::Logger::kWarn)

         .addListener("0.0.0.0", 80)

         .setThreadNum(16)

         .enableRunAsDaemon()

         .run();

}

通过链式配置生成一个应用实例，设置日志路径和级别，监听 0.0.0.0:80，使用 16 个线程，并在后台运行。编译运行，我们就能得到一个 HTTP 服务了。

Drogon 使用配置化的思想，可以通过直接加载配置文件来完成服务器的配置：

app().loadConfigFile("./config.json").run();

有了 HTTP 服务，我们就要编写处理函数来进行逻辑处理。我们编写一个简单的控制器：

#include <drogon/HttpSimpleController.h>

using namespace drogon;

class TestCtrl : public drogon::HttpSimpleController<TestCtrl>

{

public:

    virtual void asyncHandleHttpRequest(const HttpRequestPtr& req, std::function<void (const HttpResponsePtr &)> &&callback) override;

    PATH_LIST_BEGIN

    PATH_ADD("/test",Get);

    PATH_LIST_END

};

这个控制器继承了 HttpSimpleController，提供了 asyncHandleHttpRequest 来实现处理逻辑，并注册到路径 /test 上。然后，我们实现这个处理函数：

void TestCtrl::asyncHandleHttpRequest(const HttpRequestPtr& req,

                                      std::function<void (const HttpResponsePtr &)> &&callback)

{

    //write your application logic here

    auto resp = HttpResponse::newHttpResponse();

    resp->setBody("<p>Hello, world!</p>");

    resp->setExpiredTime(0);

    callback(resp);

}

这个处理函数新建了一个响应，设置内容为 Hello World 的 HTML，并设置过期时间。最后，使用回调返回 HTTP 响应。这样，我们就得到了一个简单的 Hello World 服务。

我们还可以很简单地实现一个 RESTful API 的例子：

class User : public drogon::HttpController<User>

{

  public:

    METHOD_LIST_BEGIN

    //use METHOD_ADD to add your custom processing function here;

    METHOD_ADD(User::getInfo, "/{id}", Get);                  //path is /api/v1/User/{arg1}

    METHOD_ADD(User::getDetailInfo, "/{id}/detailinfo", Get);  //path is /api/v1/User/{arg1}/detailinfo

    METHOD_ADD(User::newUser, "/{name}", Post);                 //path is /api/v1/User/{arg1}

    METHOD_LIST_END

    ...

}