Restbed 项目教程

1. 项目目录结构及介绍

Restbed 项目的目录结构如下：

restbed/
├── cmake/
│   ├── CMakeLists.txt
│   └── ...
├── dependency/
│   └── ...
├── documentation/
│   └── ...
├── legal/
│   └── ...
├── source/
│   └── ...
├── test/
│   └── ...
├── tool/
│   └── ...
├── .gitattributes
├── .gitignore
├── .gitmodules
├── CMakeLists.txt
├── LICENSE
├── README.md
└── appveyor.yml

目录介绍

• cmake/: 包含 CMake 构建脚本和相关文件。
• dependency/: 包含项目依赖的第三方库。
• documentation/: 包含项目的文档文件。
• legal/: 包含法律相关的文件。
• source/: 包含项目的源代码。
• test/: 包含项目的测试代码。
• tool/: 包含项目使用的工具。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置文件。
• CMakeLists.txt: CMake 主配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• appveyor.yml: AppVeyor CI 配置文件。

2. 项目启动文件介绍

Restbed 项目的启动文件通常是 source/ 目录下的主程序文件。以下是一个简单的启动文件示例：

#include <memory>
#include <cstdlib>
#include <restbed>

using namespace std;
using namespace restbed;

void post_method_handler(const shared_ptr<Session> session) {
    const auto request = session->get_request();
    int content_length = request->get_header("Content-Length", 0);
    session->fetch(content_length, [](const shared_ptr<Session> session, const Bytes& body) {
        fprintf(stdout, "%.*s\n", (int)body.size(), body.data());
        session->close(OK, "Hello, World!", { { "Content-Length", "13" } });
    });
}

int main(const int, const char**) {
    auto resource = make_shared<Resource>();
    resource->set_path("/resource");
    resource->set_method_handler("POST", post_method_handler);

    auto settings = make_shared<Settings>();
    settings->set_port(1984);
    settings->set_default_header("Connection", "close");

    Service service;
    service.publish(resource);
    service.start(settings);

    return EXIT_SUCCESS;
}

启动文件介绍

• post_method_handler: 处理 POST 请求的回调函数。
• main: 主函数，初始化资源、设置和启动服务。

3. 项目的配置文件介绍

Restbed 项目的配置文件通常是 settings 对象，用于配置服务的端口、默认头信息等。以下是一个简单的配置文件示例：

auto settings = make_shared<Settings>();
settings->set_port(1984);
settings->set_default_header("Connection", "close");

配置文件介绍

• set_port(1984): 设置服务的监听端口为 1984。
• set_default_header("Connection", "close"): 设置默认的 HTTP 头信息，关闭连接。

通过以上配置，Restbed 服务将监听 1984 端口，并在每次请求后关闭连接。