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 ;
}