Drogon - 真正現(xiàn)代化的 C++ 網(wǎng)絡(luò)服務(wù)框架
C++ 是最重要的編程語言之一。它既可以進(jìn)行、過程化程序設(shè)計,又可以進(jìn)行使用抽象數(shù)據(jù)類型的基于對象的程序設(shè)計,還可以進(jìn)行以繼承和多態(tài)為特點的面向?qū)ο蟮某绦蛟O(shè)計。
然而,由于標(biāo)準(zhǔn)庫和社區(qū)生態(tài)的種種問題,C++ 在 Web 服務(wù)端的發(fā)展并不如人意。同時,C++ 的服務(wù)端框架與其他語言相比,往往更為原始,對各種高級功能的支持更繁瑣。C++ 14/17 為這門語言提供了更多優(yōu)秀的特性,使得實現(xiàn)一個更為現(xiàn)代化的 Web 框架成為可能。
簡介
Drogon,是 an-tao 在 Github 上開源的基于 C++ 14/17 的 Http 應(yīng)用框架,目前版本為 v1.4.1。
Drogon是一個跨平臺框架,可以方便地使用 C++ 構(gòu)建各種類型的 Web 應(yīng)用服務(wù)端程序。其網(wǎng)絡(luò)層使用基于 epoll,使用全異步編程模式;實現(xiàn)了簡單的反射機(jī)制,支持后端渲染,支持運行期的視圖頁面動態(tài)加載;支持過濾器鏈,支持 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 服務(wù)應(yīng)用了。我們來看一個簡單的主程序:
- #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();
- }
通過鏈?zhǔn)脚渲蒙梢粋€應(yīng)用實例,設(shè)置日志路徑和級別,監(jiān)聽 0.0.0.0:80,使用 16 個線程,并在后臺運行。編譯運行,我們就能得到一個 HTTP 服務(wù)了。
Drogon 使用配置化的思想,可以通過直接加載配置文件來完成服務(wù)器的配置:
- app().loadConfigFile("./config.json").run();
有了 HTTP 服務(wù),我們就要編寫處理函數(shù)來進(jìn)行邏輯處理。我們編寫一個簡單的控制器:
- #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 來實現(xiàn)處理邏輯,并注冊到路徑 /test 上。然后,我們實現(xiàn)這個處理函數(shù):
- 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);
- }
這個處理函數(shù)新建了一個響應(yīng),設(shè)置內(nèi)容為 Hello World 的 HTML,并設(shè)置過期時間。最后,使用回調(diào)返回 HTTP 響應(yīng)。這樣,我們就得到了一個簡單的 Hello World 服務(wù)。
我們還可以很簡單地實現(xiàn)一個 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
- ...
- }
總結(jié)
Drogon 功能強(qiáng)大,把大量的底層實現(xiàn)進(jìn)行了封裝和抽象,使得開發(fā)者能夠十分方便地調(diào)用各種功能,集中于業(yè)務(wù)邏輯的實現(xiàn)。
Drogon 的設(shè)計,對齊的是其他高級語言的現(xiàn)代的 Web 框架,把配置化、動態(tài)化、自動化和解耦的思想充分應(yīng)用其中,還提供了輕量級的 ORM、模板引擎和命令行工具,可以說是一個十分全面的 Web 框架。