Crow介绍及使用

已于 2025-04-13 16:52:59 修改
阅读量2.5k 收藏 5
点赞数 6
CC 4.0 BY-SA版权
文章标签： 后端
于 2025-04-08 18:10:07 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_67790484/article/details/147074224

1.Crow是什么

Crow 是一个轻量级、高性能的 C++ Web 框架，专为快速构建 RESTful API 和 Web 应用而设计。它采用现代 C++（C++11 及以上）编写，以简洁的语法和易用性著称，适合需要高效网络服务的 C++ 开发者。

Crow 的核心特点

  1. 简洁的 API 设计

    • 类似 Python Flask 的路由语法，直观易用。

    • 示例：定义一个简单的路由只需几行代码：1.

      #include <crow.h>
int main() {
    crow::SimpleApp app;
    CROW_ROUTE(app, "/")([](){ return "Hello, Crow!"; });
    app.port(8080).run();
}

  2. 无第三方依赖

    • 仅需 C++ 标准库，无需额外安装依赖（但需支持 C++11 的编译器，如 GCC/Clang/MSVC）。

  3. 高性能

    • 基于异步 I/O（依赖平台的原生实现，如 Linux 的 epoll），适合高并发场景。

  4. 内置功能

    • 支持 HTTP/1.1、路由、中间件、JSON 请求/响应、WebSocket 等常见功能。

  5. 易集成

    • 可轻松嵌入现有 C++ 项目，或与其他库（如数据库驱动）配合使用。

 2.Web 框架（Web Framework）是什么？

Web 框架是一种软件开发工具，用于简化 Web 应用程序（网站、API 等）的构建过程。它提供了一套预定义的结构、组件和工具，帮助开发者更高效地处理 HTTP 请求、路由、数据库交互、模板渲染等常见任务，而无需从零开始编写底层代码。

Web 框架通常包含以下核心功能：

功能作用示例（不同框架的实现）
路由（Routing）将不同的 URL 路径映射到对应的处理函数（如 "/users" → 用户列表）Crow: CROW_ROUTE(app, "/users")
HTTP 请求处理解析 HTTP 请求（GET/POST/PUT/DELETE），提取参数（查询字符串、表单、JSON）Flask: request.args.get("name")
响应生成构造 HTTP 响应（返回 HTML、JSON、文件等）Express（Node.js）: res.send("Hello")
模板引擎动态生成 HTML（如将数据嵌入网页）Django: render(request, "index.html", data)
数据库集成提供 ORM（对象关系映射）或数据库连接工具Laravel（PHP）: User::where("age", ">", 18)->get()
中间件（Middleware）在请求/响应流程中插入额外逻辑（如身份验证、日志记录）Express: app.use(authMiddleware)
会话管理管理用户登录状态（Cookies/Session）Flask: session["user"] = "Alice"

 3.Crow安装

1.克隆源码

git clone https://github.com/CrowCpp/Crow.git

 2.设置VSCode路径

"includePath": [
                "${workspaceFolder}/**",
                "/**/proj/third_party/Crow/include",
                "/usr/include/boost"
            ],

3.CMake配置

让 Crow 使用 Boost 版本的 Asio

option(CROW_USE_BOOST "Use boost::asio instead of standalone Asio" ON)

find_package(Boost REQUIRED)
include_directories(${Boost_INCLUDE_DIRS})

add_executable(upload_server
    upload_server.cpp 
)

target_compile_definitions(upload_server PRIVATE CROW_USE_BOOST)

# 包含 storage 目录
target_include_directories(upload_server
    PUBLIC 
    ${CMAKE_SOURCE_DIR}/third_party/Crow/include
    ${CMAKE_SOURCE_DIR}/include/storage
    )

# 链接 storage 库 和 muduo
target_link_libraries(upload_server
    PUBLIC
    storage
)

 4.Crow使用

crow::SimpleApp app;
CROW_ROUTE(app, "/upload").methods("POST"_method)([](const crow::request& req) {
    // 这里是处理 POST 请求的逻辑
});

  • CROW_ROUTE(app, "/upload")：定义了一个路由，路径为 /upload。

  • .methods("POST"_method)：指定这个路由只处理 HTTP POST 请求。

  • ([](const crow::request& req) { ... })：定义了一个 Lambda 表达式，当 POST 请求到达 /upload 路径时，这个 Lambda 表达式会被调用，req 参数包含了请求的相关信息。

#include "crow_all.h"
#include "file_manager.h"
#include "mysql_client.h"
#include "redis_client.h"

#include <nlohmann/json.hpp>
#include <iostream>

using json = nlohmann::json;

int main() {
    crow::SimpleApp app;

    CROW_ROUTE(app, "/upload").methods("POST"_method)([](const crow::request& req) {
        crow::response res;

        try {
            auto body = json::parse(req.body);

            std::string filename = body["filename"];
            std::string content = body["content"];

            // 保存文件
            std::string path = dfs::FileManager::saveFile(filename, content);
            size_t size = dfs::FileManager::getFileSize(path);

            // 存储元数据到 MySQL
            dfs::MySQLClient::FileMeta fileMeta{filename, path, size};
            dfs::MySQLClient mysql;
            mysql.insertMetaData(fileMeta);

            // 缓存元数据到 Redis
            dfs::RedisClient redis;
            redis.cacheMeta(filename, path);

            res.code = 200;
            res.set_header("Content-Type", "application/json");
            res.body = R"({"status":"success","msg":"File uploaded successfully"})";
        } catch (const std::exception& e) {
            res.code = 500;
            res.set_header("Content-Type", "application/json");
            res.body = R"({"status":"error","msg":")" + std::string(e.what()) + R"("})";
        }

        return res;
    });

    std::cout << "Upload server is running on http://0.0.0.0:18080/upload" << std::endl;
    app.port(18080).multithreaded().run();
}

  1. app.port(18080)：

    • app 是一个 crow::SimpleApp 对象，代表你的 Crow 应用。

    • port(18080) 方法告诉应用监听 18080 端口上的 HTTP 请求。你可以根据需要更改这个端口号，只要它不与系统上其他服务使用的端口冲突。

  2. .multithreaded()：

    • 这个方法使应用以多线程模式运行。在多线程模式下，Crow 将创建多个工作线程来处理并发请求。这可以提高应用处理大量并发请求的能力。

    • 如果你的应用不需要处理大量并发请求，或者你希望简化代码，你也可以省略 .multithreaded() 方法，使应用以单线程模式运行。

  3. .run()：

    • 这个方法启动 HTTP 服务器，使其开始监听指定端口上的请求，并处理这些请求。

    • 当调用 .run() 方法时，Crow 将开始接受和处理 HTTP 请求，直到你停止服务器。

curl -X POST http://localhost:18080/upload \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "example.txt",
    "content": "'"$(base64 -w 0 /home/book/Desktop/chat/local/example.txt)"'"
  }'
#include "file_manager.h"
#include "mysql_client.h"
#include "redis_client.h"

#include "crow.h"
#include "crow/multipart.h"
#include <iostream>
#include <nlohmann/json.hpp>

int main() {
  crow::SimpleApp app;

  // 文件上传端点
  CROW_ROUTE(app, "/upload")
      .methods("POST"_method)([](const crow::request &req) {
        if (req.body.empty()) {
          return crow::response(400, "No file body received>>>");
        }

        auto filename_header = req.get_header_value("Filename");
        if (filename_header.empty()) {
          return crow::response(400, "No file header received");
        }

        try {
          std::string filename = filename_header;
          std::string file_data = req.body;

          std::string path = dfs::FileManager::saveFile(filename, file_data);
          size_t size = dfs::FileManager::getFileSize(file_data);

          dfs::MySQLClient::FileMeta file = {filename, path, size};
          dfs::MySQLClient mysql;
          mysql.insertMetaData(file);

          dfs::RedisClient redis;
          redis.cacheMeta(filename, path);

          // 构建成功响应
          crow::json::wvalue response;
          response["status"] = "success";
          response["filename"] = filename;
          response["path"] = path;
          response["size"] = size;
          return crow::response(200, response);
        } catch (const std::exception &e) {
          return crow::response(500, std::string("Upload server failed>>>") +
                                         e.what());
        } catch (...) {
          return crow::response(500, "Upload server failed: unknown>>>");
        }
      });

  // 启动服务器
  app.port(8080).multithreaded().run();
  return 0;
}
curl -X POST -H "Filename: example.txt" --data-binary "@/home/book/Desktop/chat/data/local/example.txt" http://localhost:8080/upload

curl -o /home/book/Desktop/chat/data/download/example.txt http://localhost:8081/download/b9e5aeb6-716e-4bf0-a714-c99ad8fcc9e1

5.httplib

HTTPLibs 是一个 C++ 的 HTTP 库，用于构建 HTTP 客户端和服务器应用程序。它提供了简单易用的 API 来处理 HTTP 请求和响应，它是一个多线程“阻塞”HTTP 库

1.在 Ubuntu 上安装 HTTPLibs

git clone https://github.com/yhirose/cpp-httplib
cd cpp-httplib
mkdir build
cd build
cmake ..
make
sudo make install

2.CMAKE

find_package(httplib REQUIRED)
target_link_libraries(your_target PRIVATE httplib::httplib)

3.HTTP 服务器示例

#include <httplib.h>

int main() {
    httplib::Server svr;

    svr.Get("/hi", [](const httplib::Request &, httplib::Response &res) {
        res.set_content("Hello World!", "text/plain");
    });

    svr.listen("0.0.0.0", 8080);
}

HTTP 客户端示例

#include <httplib.h>
#include <iostream>

int main() {
    httplib::Client cli("http://example.com");
    
    if (auto res = cli.Get("/")) {
        std::cout << res->status << std::endl;
        std::cout << res->body << std::endl;
    }
}

4.与Crow对比 

  1. 选择 HTTPLibs 如果:

    • 你需要一个简单轻量的 HTTP 库

    • 你不想引入 Boost 依赖

    • 你需要同时使用 HTTP 客户端和服务器功能

    • 你的项目对性能要求不是极端苛刻

  2. 选择 Crow 如果:

    • 你需要构建更复杂的 Web 应用

    • 你需要中间件支持

    • 你需要更强大的路由功能

    • 你的项目已经使用了 Boost

特性/对比项Crowhttplib (cpp-httplib)
设计风格类似 Flask（功能更全）极简主义（纯头文件）
依赖Boost（虽支持非 Boost 模式，但部分功能需 Boost）无依赖（一个头文件）
异步/多线程支持（基于 Boost 或自带线程池）支持多线程（但更轻量）
性能高于 httplib（适合复杂服务）足够轻巧（适合 MVP 或中转服务器）
支持 HTTP 特性路由、中间件、JSON（内置）基础 HTTP 客户端 + 服务器
学习成本稍高，但功能全面非常低，适合上手
代码量/维护复杂度多模块管理，适合中大型项目单头文件，维护简单
ZI&Yue
关注
crow：Crow是一个非常快速且易于使用的C ++微型Web框架（受Python Flask启发）
02-03
快速，易于使用的网络微框架。 描述 Crow是用于运行Web服务的C ++微框架。 它使用类似于Python的Flask的路由，使其易于使用。 它也非常快，击败了多个现有的C ++框架以及非C ++框架。 产品特点 易于布线（类似于长颈瓶）。 类型安全的处理程序。 速度飞快（请参阅和）。 内置JSON支持。 基于的模板库（ crow::mustache ）。 仅标头库（可用单个标头文件）。 中间件对扩展的支持。 HTTP / 1.1和Websocket支持。 多部分请求和响应支持。 使用现代C ++（11/14） 仍在开发中 文献资料 可用。 例子 你好世界 # includ
Crow框架入门和后端文件操作
m0_51324570的博客
12-27 1188
在crow中文件下载与返回静态资源基本上是一样的，只是在返回文件下载流时要设置Content-Type与Content-Disposition，若不设置在输出图片或文本文件时会被浏览器强制解析，而无法弹出下载框。若要实现文件的多线程分段下载，首先要从http请求头中获取Range信息，然后解析出该http请求所对应的文件起始位置和结束位置。在crow中返回的Range是一个字符串，需要自行进行字符串分割，然后将字符串转换为int。在上传文件时，获取附件名称时存在bug，无法准确的获取中文名称。
C++通过Crow和Mustache实现简单的CMake配置的Web程序
LorraineWen的博客
06-19 507
使用C++的Crow库和Mustache库，在VSCode上面借助CMake开发一个简单的Web程序
cpp-Crow一个非常快速和易于使用的C微型web框架
08-15
Crow ：一个非常快速和易于使用的C 微型web框架（灵感来自于Python Flask）
C++与Vue.js实战：高效整合开发
最新发布
keny-大成的博客
06-29 974
摘要：本文介绍了C++与Vue.js结合的多种技术方案和应用案例。主要内容包括：1) 通过REST API和WebSocket实现前后端通信的示例；2) VC++与Vue3的集成方案，包括WebView控件嵌入和Electron集成；3) C++在机器人控制、车载系统等领域的应用实例；4) Arduino硬件开发案例，涵盖传感器数据采集、电机控制等。这些案例展示了如何利用C++的高性能特性与前端框架结合，构建从嵌入式系统到Web应用的全栈解决方案，并提供详细的代码片段和实现方法。
CrowCpp/Crow项目实战：构建现代C++ Web服务的完整示例解析
gitblog_01042的博客
06-10 407
CrowCpp/Crow项目实战：构建现代C++ Web服务的完整示例解析 前言 Crow是一个轻量级、高性能的C++微框架，用于构建Web应用程序和RESTful API。本文将通过一个完整的示例代码，深入剖析如何使用Crow框架构建功能丰富的Web服务，涵盖路由、中间件、日志处理、参数解析等核心功能。 示例代码概览 这个示例展示了Crow框架的多个关键特性，包括： 自定义日志处理器 中间件实...
实现链式调用和流式接口编程模式的指南：使用C++ Crow框架
深耕嵌入式领用多年， 致力于分享嵌入式领域技术!
04-02 1327
实现链式调用和流式接口编程模式的指南：使用C++ Crow框架
【在CentOS中使用Crow-基于C++的Web服务】
CaptainLJP的博客
04-16 2672
在CentOS中使用Crow-基于C++的Web服务前言目录1.搭建C++开发环境2.安装安装crow所需依赖3.测试参考 前言 crow是一个基于C++的web微服务框架，在使用上和python中的flask框架类似，利用它我们可以设计RESTful Api。使用crow需要在CentOS中搭建C++开发环境，安装所需依赖。 目录 搭建C++开发环境 安装crow所需依赖 测试 1.搭建C++开发环境 安装以下工具 yum -y install gcc yum -y install gcc-c++ y
【亲测免费】 Crow 开源项目使用教程
gitblog_01175的博客
08-09 988
Crow 开源项目使用教程 1. 项目的目录结构及介绍 Crow 是一个 C++ 微型 Web 框架，其目录结构简洁明了。以下是 Crow 项目的主要目录和文件介绍： crow/ ├── crow │ ├── amalgamate.py │ ├── crow.h │ ├── crow_all.h │ ├── examples │ │ ├── example.cpp │ ...
Crow 编译和环境搭建
CAir2的专栏
03-07 1324
crow环境搭建和加载静态资源
介绍C++ 微型web框架Crow
深耕嵌入式领用多年， 致力于分享嵌入式领域技术!
04-02 2511
介绍C++ 微型web框架Crow
网格框架Crow.zip
07-19
Crow 是一个用于网页上的网格框架，而不仅仅是网格。 标签：Crow  CSS框架
使用 Crow Lion 神经网络进行多核概率聚类，用于缺失数据的插补和分类-研究论文
06-10
在模式分类中，主要问题之一是数据缺失或数据不完整，这是由不同原因造成的。 缺失数据量因应用程序而异。... 通过将多核概率聚类算法 (MKPCA) 与 Feed Crow Lion 神经网络 (CLNN) 相结合，提出了缺失数据插补和分类。
crows-pairs:该存储库包含论文“ CrowS-Pairs”中介绍的数据和代码。
05-04
乌鸦对 这是的Github回购， 一个挑战性数据集，用于测量掩盖语言模型（MLM）中存在的美国陈规定型偏见的程度。 相关论文将作为2020年自然语言处理经验方法会议（EMNLP 2020）的一部分发表。 数据集 ...
C++基于Crow的Web服务开发
江湖郎中
03-09 834
本文记录了使用C++语言创建基于Crow框架的VS工程的过程
Crow：C++高性能微服务框架的深度探索
s13596191285的博客
03-24 107
随着微服务架构的日益普及，传统的编程语言和框架逐渐无法满足高性能、低延迟和可扩展性的需求。C++，作为一种高效且具有强大性能的语言，逐渐成为微服务架构的核心技术之一。本文介绍了Crow，一个基于C++的高性能微服务框架，分析了其设计理念、关键技术和实现方法。通过对比分析，本文展示了Crow如何在保证高性能的同时，实现极简的API和高度可定制的服务部署架构。此外，本文还展示了Crow在处理大规模请求和并发操作中的优势，以及如何使用Crow进行微服务架构的高效构建。
Crow项目启动与配置教程
gitblog_00972的博客
05-25 433
Crow项目启动与配置教程 1. 项目目录结构及介绍 Crow项目的目录结构如下： src/：源代码目录，包含了Crow客户端的核心实现。 include/：头文件目录，包含了Crow客户端的对外接口。 tests/：测试目录，包含了项目的单元测试和集成测试。 examples/：示例代码目录，展示了如何在实际项目中使用Crow。 doc/：文档目录，存放项目的文档和API参考。 CMakeLi...
Crow C++ 微框架快速入门及实践指南
gitblog_00557的博客
10-11 1448
Crow C++ 微框架快速入门及实践指南 项目介绍 Crow 是一个基于 C++ 的轻量级 web 框架，旨在提供快速且易于使用的HTTP和WebSocket服务创建解决方案。它借鉴了Python中Flask的路由设计哲学，使得开发者能够以直观的方式配置路由。Crow以其高性能闻名，不仅超越了许多现有的C++框架，还在一些基准测试中表现优于非C++框架。特性包括类型安全的处理程序、内置JSON支...
Crow 开源项目教程
gitblog_00354的博客
09-08 373
Crow 开源项目教程 项目介绍 "Crow" 是一个基于 GitHub 的开源项目，不过请注意，提供的链接实际指向了一个名为 monome/crow.git 的特定仓库。由于我们无法直接访问互联网资源来获取实时信息，以下内容假设“Crow”是一个虚构的示例项目，用于模拟技术文档的编写。此项目假定为一个轻量级的API框架，旨在简化Web服务的开发过程，支持快速构建高性能的应用程...
crow安装
03-25
<think>好的，用户想了解如何安装Crow框架。首先，我需要回忆一下关于Crow框架的相关信息。Crow是一个C++的微框架，类似Python的Flask，使用起来需要包含头文件。根据之前的引用内容，用户提供的参考中有提到需要下载Crow的头文件，并且可能涉及到依赖管理，比如Asio。 首先，安装Crow的主要步骤应该是下载它的头文件，因为Crow是header-only的，这意味着用户只需将头文件包含到项目中即可使用，不需要编译库。引用[1]提到需要下载Crow的头文件，引用[3]给出了GitHub的地址，所以需要指导用户到GitHub仓库下载。 然后，检查依赖项。Crow依赖于Asio，所以用户需要安装Asio。不过，Asio有standalone版本，可能不需要Boost，这样可以简化安装步骤。引用[1]和[2]提到了Asio的安装，可能需要用户通过包管理器或者下载源码。 接下来，可能涉及到构建工具的使用，比如CMake。如果用户使用CMake，需要配置include目录，确保编译器能找到Crow和Asio的头文件。引用[4]中的示例可能有用，需要给出一个简单的CMakeLists.txt例子，帮助用户设置项目。 另外，用户可能遇到的问题是无法加载静态资源或者模板，如引用[5]中提到的html渲染问题，这可能和资源路径有关，但安装部分主要是正确包含头文件和依赖。不过，在安装说明中，可以提到后续使用时需要注意资源路径的设置。 需要注意用户可能不熟悉如何将头文件正确包含到项目中，所以步骤要详细，比如解压到特定目录，或者直接克隆仓库到项目子模块。同时，检查Asio的版本是否兼容，是否需要特定版本。 可能还需要说明测试安装是否成功的方法，比如编写一个简单的Crow示例程序，编译并运行，查看是否正常工作。如果有错误，可能是依赖项未正确安装或包含路径不正确。 总结安装步骤应为： 1. 下载Crow头文件（GitHub） 2. 安装Asio依赖 3. 配置项目构建系统（如CMake） 4. 测试安装 在回答时要确保步骤清晰，代码块和命令正确，避免用户混淆。同时，根据用户提供的引用，正确标注引用来源，如引用[1]、[3]等。</think>### Crow框架安装方法分步说明 Crow是C++的轻量级Web框架，安装步骤如下： #### 一、下载Crow头文件 1. 访问GitHub仓库下载源码[^3] ```bash git clone https://github.com/CrowCpp/Crow.git ``` 2. 将`include`目录中的头文件复制到项目路径，或直接添加为子模块 #### 二、安装依赖项（Asio） 1. 使用包管理器安装（推荐）： ```bash # Ubuntu/Debian sudo apt install libasio-dev # MacOS brew install asio ``` 2. 或手动安装[^1]： ```bash wget https://sourceforge.net/projects/asio/files/latest/download tar -zxvf asio-*.tar.gz cp -r asio-*/include /usr/local/include ``` #### 三、配置CMake项目 创建CMakeLists.txt文件示例[^4]： ```cmake cmake_minimum_required(VERSION 3.15) project(crow_demo) set(CMAKE_CXX_STANDARD 17) # 指定头文件路径 include_directories( ${PROJECT_SOURCE_DIR}/Crow/include ${ASIO_INCLUDE_DIR} ) add_executable(demo main.cpp) ``` #### 四、验证安装 创建测试程序`main.cpp`： ```cpp #include <crow.h> int main() { crow::SimpleApp app; CROW_ROUTE(app, "/")([](){ return "Hello Crow!"; }); app.port(18080).multithreaded().run(); } ``` 编译并运行： ```bash mkdir build && cd build cmake .. && make ./demo ``` 访问`http://localhost:18080`应显示Hello消息
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值