说起 Web 开发,大多数人会想到 Java、Python、Golang ...
因为它们的支流 Web 框架有很多,Java 有十分出名的 Spring 全家桶,Python 有大而全的 Django、小而精的 Flask、高性能的 Tornado,Golang 也有疾速灵便的 Gin、Echo 等框架。
相比之下,C/C++ 营垒则逊色不少。之前,我曾写过一篇《C++ Web(HTTP)开发 10 大利器》,其中介绍了一些 C/C++ Web 框架。有一个名为 Oat++
的很不错,轻量、跨平台、高性能、齐全零依赖
,十分值得学习!
1 Oat++ 介绍
要深刻理解 Oat++,离不开这几个网址:
- Oat++ 主页:https://oatpp.io
- Oat++ 文档:https://oatpp.io/docs/start
- GitHub 地址:https://github.com/oatpp/oatpp
其次要个性有:
-
随处运行
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++ 的 GitHub 页面,你会发现 Star 多达 4K+,贡献者有 30 多个,且最近几天还有代码提交,所以 不必放心热度和活跃度,这个框架始终有人在踊跃地保护。
环境要求
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 示例程序
为了演示 Oat++,咱们从最简略的 “Hello, World!”
开始!
创立一个 CMake 我的项目,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!
开源前哨
日常分享热门、乏味和实用的开源我的项目。参加保护 10 万 + Star 的开源技术资源库,包含:Python、Java、C/C++、Go、JS、CSS、Node.js、PHP、.NET 等。