【C++/Drogon框架】一、Drogon的安装和开始

什么是Drogon

Drogon是一个基于C++17/20的Http应用框架，使用Drogon可以方便的使用C++构建各种类型的Web应用服务端程序。它的名字来自于《权力的游戏》中的一条叫做卓耿的龙。

github: drogonframework/drogon

文档: drogonframework/drogon Wiki

这是一个跨平台的框架，支持Linux、Windows、macOS等多种系统，与Java中的Spring框架类似，它有着解耦、AOP、支持http和websocket等特征，同时，它也保持着C++的特点，比如支持高并发、高性能的网络IO，还有其他的特点都在官方文档中有所描述，可以点进上面的链接查看。

还有值得一提的是它提供了一个轻量的命令行工具drogon_ctl，能够帮忙简化各种类的创建和视图代码的生成过程。

安装Drogon

1、安装准备

• CMake构建工具
• git工具
• Visual Studio
• vcpkg

2、开始安装

• 输入vcpkg指令安装：vcpkhg install drogon 或者 vcpkg install drogon:x64-windows(64位的)
• 安装drogon_ctl：vcpkg install drogon[ctl] 或者 vcpkg install drogon[ctl]:x64-windows(64位的)
• 添加drogon_ctl到系统环境变量，需要添加以下路径
  • $你的vcpkg安装目录$\installed\x64-windows\tools\drogon
  • $你的vcpkg安装目录$\installed\x64-windows\bin
  • $你的vcpkg安装目录$\installed\x64-windows\lib
  • $你的vcpkg安装目录$\installed\x64-windows\include
• 重新启动命令行，输入drogon_ctl验证是否添加成功

第一个Drogon项目

1、创建工程

使用drogon_ctl可以快捷的创建一个Drogon项目，在命令行进入项目保存的目录，输入：

drogon_ctl create project drogon_project

运行完可以看到生成了很多文件，这些文件中CMakeLists.txt是工程的cmake配置文件，build文件夹是工程的构建文件夹，至于其他的文件夹有什么用，我们之后再进行介绍。

2、Hello Drogon!

接下来让我们看一下main.cc文件：

#include <drogon/HttpAppFramework.h>
int main() {
    //Set HTTP listener address and port
    drogon::app().addListener("0.0.0.0",80);
    //Load config file
    //drogon::app().loadConfigFile("../config.json");
    //Run HTTP framework,the method will block in the internal event loop
    drogon::app().run();
    return 0;
}

可以看到能修改HTTP监听的地址和端口，我们将其修改为"127.0.0.1", 8080，端口只要是没有被占用的都可以

然后我们使用CMake构建项目，在命令行执行

• cd build
• cmake ..

执行完这两行命令后，这时候我们能够发现build文件夹下出现了Visual Studio的.sln解决方案文件

然后我们进入controllers目录，输入：

• drogon_ctl create controller TestController

可以看见controller目录下多出来一个头文件和一个对应的源文件，再进入build里cmake一下，这时候打开.sln进入Visual Studio界面，可以看到读取到了源文件，头文件这时候可能会被包含在外部依赖项中，找到右键将其包括在项目中即可。顺便可以新建一个筛选器controller，将TestController文件移到里面。

接着让我们来修改一下TestController.h

#pragma once

#include <drogon/HttpSimpleController.h>

using namespace drogon;

class TestController : public drogon::HttpSimpleController<TestController>
{
  public:
    void asyncHandleHttpRequest(const HttpRequestPtr& req, std::function<void (const HttpResponsePtr &)> &&callback) override;
    PATH_LIST_BEGIN
    // list path definitions here;
    // PATH_ADD("/path", "filter1", "filter2", HttpMethod1, HttpMethod2...);
    // 添加路径映射
    PATH_ADD("/", Get);
    PATH_ADD("/test", Get);
    PATH_LIST_END
};

TestController.cc

#include "TestController.h"

void TestController::asyncHandleHttpRequest(const HttpRequestPtr& req, std::function<void (const HttpResponsePtr &)> &&callback)
{
    // write your application logic here
    // 创建Http响应
    auto resp = HttpResponse::newHttpResponse();
    // 设置状态码为200
    resp->setStatusCode(k200OK);
    // 设置contentType
    resp->setContentTypeCode(CT_TEXT_HTML);
    // 设置响应体
    resp->setBody("Hello Drogon!");
    // 调用回调函数
    callback(resp);
}

接下来就可以启动我们第一个Drogon项目了，如果Debug模式下报错的话，可以进入项目-属性-C/C+±代码生成-运行库，将其修改为MT或MD，推测可能是Drogon的第三方库不是Debug模式编译的。

然后在浏览器输入localhost:8080 或者 localhost:8080/test 就能看见输出结果了！