Drogon 框架使用教程

Drogon 框架使用教程

drogonDrogon: A C++14/17/20 based HTTP web application framework running on Linux/macOS/Unix/Windows项目地址:https://gitcode.com/gh_mirrors/dr/drogon

1. 项目的目录结构及介绍

Drogon 是一个基于 C++14/17/20 的 HTTP 应用框架，支持跨平台运行。以下是 Drogon 项目的主要目录结构及其介绍：

drogon/
├── cmake/
│   └── cmake_modules/
├── docker/
├── drogon_ctl/
├── examples/
├── lib/
├── nosql_lib/
│   └── redis/
├── orm_lib/
├── third_party/
│   └── mman-win32/
├── trantor/
├── Doxyfile
├── clang-format
├── gitignore
├── gitmodules
├── CMakeLists.txt
├── CONTRIBUTING.md
├── CPPLINT.cfg
├── ChangeLog.md
├── LICENSE
├── README.md
├── README.zh-CN.md
└── README.zh-TW.md

• cmake/: 包含 CMake 模块文件。
• docker/: 包含 Docker 相关文件。
• drogon_ctl/: 包含 Drogon 控制工具的源代码。
• examples/: 包含示例应用程序。
• lib/: 包含 Drogon 库的源代码。
• nosql_lib/: 包含非关系型数据库库，如 Redis。
• orm_lib/: 包含对象关系映射库。
• third_party/: 包含第三方库，如 mman-win32。
• trantor/: 包含 Trantor 库的源代码，Trantor 是 Drogon 的依赖库。
• Doxyfile: 用于生成文档的 Doxygen 配置文件。
• clang-format: 用于代码格式化的配置文件。
• gitignore: Git 忽略文件配置。
• gitmodules: Git 子模块配置。
• CMakeLists.txt: CMake 主配置文件。
• CONTRIBUTING.md: 贡献指南。
• CPPLINT.cfg: 代码风格检查配置。
• ChangeLog.md: 变更日志。
• LICENSE: 许可证文件。
• README.md: 项目主 README 文件。
• README.zh-CN.md: 中文简体 README 文件。
• README.zh-TW.md: 中文繁体 README 文件。

2. 项目的启动文件介绍

Drogon 项目的启动文件通常是 main.cpp，位于 examples/simple_example/ 目录下。以下是一个简单的 main.cpp 示例：

#include <drogon/drogon.h>

int main() {
    // 设置监听端口
    drogon::app().addListener("0.0.0.0", 8080);
    
    // 添加路由
    drogon::app().registerHandler("/", [](const drogon::HttpRequestPtr& req,
                                          std::function<void (const drogon::HttpResponsePtr &)> &&callback) {
        auto resp = drogon::HttpResponse::newHttpResponse();
        resp->setBody("Hello, World!");
        callback(resp);
    });
    
    // 启动应用
    drogon::app().run();
    return 0;
}

在这个示例中，我们设置了监听端口为 8080，并注册了一个处理 / 路径的处理器，返回 "Hello, World!" 响应。最后，调用 drogon::app().run() 启动应用。

3. 项目的配置文件介绍

Drogon 项目的配置文件通常是 config.json 或 config.yaml，位于项目根目录下。以下是一个简单的 config.json 示例：

{
    "listeners": [
        {
            "address": "0.0.0.0",
            "port": 8080
        }
    ],
    "plugins": {
        "HttpAppFramework": {
            "runAsDaemon": false,
            "loadConfigFile": "config.json"
        }
    }
}

在这个示例中，我们配置了监听地址为 0.0.0.0，端口为 8080，并设置了 HttpAppFramework 插件的一些基本配置。

drogonDrogon: A C++14/17/20 based HTTP web application framework running on Linux/macOS/Unix/Windows项目地址:https://gitcode.com/gh_mirrors/dr/drogon