CrowCpp中间件机制深度解析与实践指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00715/article/details/148551964

CrowCpp中间件机制深度解析与实践指南

Crow A Fast and Easy to use microframework for the web. 项目地址: https://gitcode.com/gh_mirrors/cro/Crow

中间件概述

在CrowCpp框架中，中间件是一种强大的机制，允许开发者在请求处理流程的不同阶段插入自定义逻辑。中间件可以用于日志记录、权限验证、请求/响应修改等多种场景，为Web应用开发提供了极大的灵活性。

中间件类型

CrowCpp支持两种主要类型的中间件：

全局中间件：应用于所有路由请求
局部中间件（继承自ILocalMiddleware）：仅应用于特定路由

全局中间件示例：RequestLogger

struct RequestLogger
{
    struct context {};  // 上下文结构体，可存储请求相关数据

    // 请求处理前执行
    void before_handle(crow::request& req, crow::response& /*res*/, context& /*ctx*/)
    {
        CROW_LOG_INFO << "Request to:" + req.url;  // 记录请求URL
    }

    // 请求处理后执行
    void after_handle(crow::request& /*req*/, crow::response& /*res*/, context& /*ctx*/)
    {}
};

这个中间件会在每个请求处理前后执行，特别适合用于日志记录、请求监控等场景。

局部中间件示例：SecretContentGuard

struct SecretContentGuard : crow::ILocalMiddleware
{
    struct context {};

    void before_handle(crow::request& /*req*/, crow::response& res, context& /*ctx*/)
    {
        res.write("SECRET!");  // 直接返回响应
        res.code = 403;       // 设置403禁止访问状态码
        res.end();            // 结束响应
    }

    void after_handle(crow::request& /*req*/, crow::response& /*res*/, context& /*ctx*/)
    {}
};

这个中间件演示了如何提前终止请求处理流程，适用于权限验证等场景。当请求被该中间件拦截时，不会执行后续的路由处理函数。

中间件上下文

中间件可以通过上下文(context)机制在请求处理的不同阶段共享数据：

struct RequestAppend : crow::ILocalMiddleware
{
    struct context
    {
        std::string message;  // 可在处理过程中存储和传递数据
    };

    void before_handle(crow::request& /*req*/, crow::response& /*res*/, context& /*ctx*/)
    {}

    void after_handle(crow::request& /*req*/, crow::response& res, context& ctx)
    {
        res.write(" + (" + ctx.message + ")");  // 修改响应内容
    }
};

中间件注册与使用

全局中间件注册

crow::App<RequestLogger, SecretContentGuard, RequestAppend> app;

所有列在模板参数中的中间件都会成为全局中间件。

局部中间件应用

CROW_ROUTE(app, "/secret")
  .CROW_MIDDLEWARES(app, SecretContentGuard)([]() {
      return "";
  });

使用CROW_MIDDLEWARES宏为特定路由启用局部中间件。

蓝图(Blueprint)中的中间件

crow::Blueprint bp("bp", "c", "c");
bp.CROW_MIDDLEWARES(app, RequestAppend);  // 为蓝图所有路由注册中间件

CROW_BP_ROUTE(bp, "/")
([&](const crow::request& req) {
    auto& ctx = app.get_context<RequestAppend>(req);
    ctx.message = "World";
    return "Hello:";
});
app.register_blueprint(bp);

蓝图中间件会应用于该蓝图的所有路由及其子蓝图。