说起 Web 开发，大多数人会想到 Java、Python、Golang ...
Oat++轻量、跨平台、高性能、完全零依赖

1 Oat++ 介绍

离不开这几个网址：

其主要特性有：

  • 随处运行
    Oat++ 没有任何依赖性，可以很容易地移植到各种支持的平台上（Linux、MacOS、Windows）。
  • 构建健壮的api
    使用 Oat++ Simple-API，构建灵活而健壮的 API 既简单又有趣。
  • 处理 500 万个连接
    使用 Oat++ Async-API，可以在单个服务器上处理超过 500 万个并发连接。
  • 访问数据库
    Oat++ ORM 提供了一种简单而统一的方式来访问数据库
  • 保持代码一致
    Oat++ 在整个代码库中依靠对象映射来确保 API 和数据模型的一致性
  • 生成 API 文档
    使用 Swagger-UI 和 OpenAPI 3.0.0 自动记录 endpoints

最吸引我的是 HTTP/HTTPS、文件上传/下载、以及强大的 Swagger API 功能。

2 编译 Oat++

不用担心热度和活跃度，这个框架一直有人在积极地维护。

环境要求

Oat++ 的编译过程很简单
  • Git
  • 编译器支持的 C++ 版本 >= 11
  • Make
  • CMake 版本 >= 3.1

如果没有的话，按照下述步骤安装，以 Ubuntu 为例：

$ sudo apt install git
$ sudo apt install cmake
$ sudo apt install build-essential

编译安装

下载 Oat++ 源码：

$ git clone https://github.com/oatpp/oatpp.git

执行编译安装四部曲：
$ cd oatpp/
$ mkdir build && cd build
$ cmake ..
$ sudo make && sudo make install

3 示例程序

“Hello, World！”
CMakeLists.txt 配置
cmake_minimum_required(VERSION 3.1)
project(helloworld)

set(CMAKE_CXX_STANDARD 11)
set(SOURCE_FILES main.cpp handler.h)

# 查找 oatpp 依赖
find_package(oatpp REQUIRED)

add_executable(${PROJECT_NAME} ${SOURCE_FILES})

# 将目标文件与库文件进行链接
target_link_libraries(${PROJECT_NAME} oatpp::oatpp)

默认情况下，Oat++ 会对客户端请求响应 404，除此之外什么都不做。

若要添加自定义响应，必须实现 HttpRequestHandler：

// handler.h
#ifndef HANDLER_H
#define HANDLER_H

#include "oatpp/web/server/HttpRequestHandler.hpp"

#define O_UNUSED(x) (void)x;

// 自定义请求处理程序
class Handler : public oatpp::web::server::HttpRequestHandler
{
public:
    // 处理传入的请求，并返回响应
    std::shared_ptr<OutgoingResponse> handle(const std::shared_ptr<IncomingRequest>& request) override {
        O_UNUSED(request);

        return ResponseFactory::createResponse(Status::CODE_200, "Hello, World!");
    }
};

#endif // HANDLER_H

需要通过 Router 将请求路由到它：
// main.cpp
#include "oatpp/web/server/HttpConnectionHandler.hpp"
#include "oatpp/network/tcp/server/ConnectionProvider.hpp"
#include "oatpp/network/Server.hpp"
#include "handler.h"

void run()
{
    // 为 HTTP 请求创建路由器
    auto router = oatpp::web::server::HttpRouter::createShared();

    // 路由 GET - "/hello" 请求到处理程序
    router->route("GET", "/hello", std::make_shared<Handler>());

    // 创建 HTTP 连接处理程序
    auto connectionHandler = oatpp::web::server::HttpConnectionHandler::createShared(router);

    // 创建 TCP 连接提供者
    auto connectionProvider = oatpp::network::tcp::server::ConnectionProvider::createShared({"localhost", 8000, oatpp::network::Address::IP_4});

    // 创建服务器，它接受提供的 TCP 连接并将其传递给 HTTP 连接处理程序
    oatpp::network::Server server(connectionProvider, connectionHandler);

    // 打印服务器端口
    OATPP_LOGI("MyApp", "Server running on port %s", connectionProvider->getProperty("port").getData());

    // 运行服务器
    server.run();
}

int main()
{
    // 初始化 oatpp 环境
    oatpp::base::Environment::init();

    // 运行应用
    run();

    // 销毁 oatpp 环境
    oatpp::base::Environment::destroy();

    return 0;
}

4 请求验证

运行程序，在浏览器中访问 http://localhost:8000/hello ，就会显示“Hello, World!”信息了：

或者使用 curl 请求 http://127.0.0.1:8000/hello，效果一样：

$ curl http://127.0.0.1:8000/hello
Hello, World!