restinio下载 - restinio源代码下载

restinio

C/C++

v.0.7.3

下载

什么是restinio？

Restinio是一个C ++ 17库，可为您提供嵌入式HTTP/WebSocket服务器。它基于ASIO的独立版本，主要针对HTTP-要求的异步处理。 BOOST :: ASIO也得到了支持。

Restinio本身是一个仅标题库，但它取决于不仅标题的Nodejs/llhttp。

目前， Restinio处于相当稳定的状态，我们认为自V.0.4.0以来，它已准备好生产使用。

Restinio的一个非常基本的例子

考虑编写必须支持某些REST API的C ++应用程序的任务，Restinio代表我们解决该任务的解决方案。

让我们看看最简单的情况下的感觉：

# include < restinio/core.hpp >
int main ()
{
    restinio::run (
        restinio::on_this_thread ()
        . port ( 8080 )
        . address ( " localhost " )
        . request_handler ([]( auto req) {
            return req-> create_response (). set_body ( " Hello, World! " ). done ();
        }));
    return 0 ;
}

服务器在主线程上运行，并通过Hello-World消息响应所有请求。当然，您可以访问给定的HTTP请求的结构，因此您可以应用复杂的逻辑来处理请求。

特征

异步请求处理。无法立即获取响应数据？没关系，在某个地方存储请求句柄和/或将其传递到其他执行上下文中，并在数据准备就绪时返回它。
HTTP管道。在异步请求处理方面很好地工作。它可能会大大增加服务器吞吐量。
超时控制。 Restinio可以照顾好的连接不良的连接：发送“ get /get /”然后粘住。
响应构建者。需要块编码的身体 - 然后Restinio为您提供一个特殊的响应构建器（显然，它不是唯一的构建器）。
类似于ExpressJS的请求路由（请参见下面的示例）。
一个实验类型的Affe Reque Router，允许在C ++编译器的静态检查的帮助下避免ExpressJS状路由器的问题。
有可能链接几个请求处理程序（与Expressjs的中间件有些相似）。
使用查询字符串参数。
几个可使用HTTP标头的现成的帮助者（例如，与文件上传有关的HTTP标头的支持）。
支持发送文件及其零件（在Linux/Unix上使用SendFile，Windows上的发送文件）。
支持压缩（Deflate，GZIP）。
支持TLS（HTTPS）。
基本的Websocket支持。只需restinio :: websocket :: basic :: upgrade（）请求句柄，并在相应的连接上启动Websocket会话。
可以在外部ASIO :: io_context上运行。 Restinio与执行上下文分开。
一些曲调选项。一个人可以设置受体和插座选项。当在线程池上运行restinio时，可以并行接受。

Express Router的增强示例

# include < restinio/core.hpp >

using namespace restinio ;

template < typename T>
std::ostream & operator <<(std::ostream & to, const optional_t <T> & v) {
    if (v) to << *v;
    return to;
}

int main () {
    // Create express router for our service.
    auto router = std::make_unique<router:: express_router_t <>>();
    router-> http_get (
            R"( /data/meter/:meter_id(d+) )" ,
            []( auto req, auto params) {
                const auto qp = parse_query (req-> header (). query ());
                return req-> create_response ()
                        . set_body (
                                fmt::format ( " meter_id={} (year={}/mon={}/day={}) " ,
                                        cast_to< int >(params[ " meter_id " ]),
                                        opt_value< int >(qp, " year " ),
                                        opt_value< int >(qp, " mon " ),
                                        opt_value< int >(qp, " day " )))
                        . done ();
            });

    router-> non_matched_request_handler (
            []( auto req){
                return req-> create_response ( restinio::status_not_found ()). connection_close (). done ();
            });

    // Launching a server with custom traits.
    struct my_server_traits : public default_single_thread_traits_t {
        using request_handler_t = restinio::router:: express_router_t <>;
    };

    restinio::run (
            restinio::on_this_thread<my_server_traits>()
                    . address ( " localhost " )
                    . request_handler ( std::move (router)));

    return 0 ;
}