restinioダウンロードrestinioソースコードのダウンロード

restinio

C/C++

v.0.7.3

ダウンロード

Restinioとは何ですか？

Restinioは、埋め込まれたHTTP/WebSocketサーバーを提供するC ++ 17ライブラリです。これは、ASIOのスタンドアロンバージョンに基づいており、主にHTTP-Requestsの非同期処理用にターゲットにされています。 Boost :: Asioもサポートされています。

Restinio自体はヘッダーのみのライブラリですが、ヘッダーのみではないnodejs/llhttpに依存します。

現在、 Restinioはかなり安定した状態にあり、v.0.4.0以来、生産の使用が準備ができていると思います。

Restinioの非常に基本的な例

いくつかのREST APIをサポートする必要があるC ++アプリケーションを作成するタスクを検討してください。Rectinioは、そのタスクに対するソリューションを表しています。

最も単純なケースでそれがどのように感じるかを見てみましょう：

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

サーバーはメインスレッドで実行され、HelloWldメッセージを使用してすべてのリクエストに応答します。もちろん、特定のHTTP要求の構造にアクセスできるので、リクエストを処理するために複雑なロジックを適用できます。

特徴

非同期リクエスト処理。すぐに応答データを取得できませんか？それは大丈夫です、ストアリクエストはどこかで処理し、/またはそれを別の実行コンテキストに渡し、データの準備ができたらそれに戻ります。
HTTPパイプライン。非同期リクエスト処理でうまく機能します。サーバーのスループットが劇的に増加する可能性があります。
タイムアウト制御。 Restinioは、「Get /」を送信してから、ちょうど立ち往生しているような悪い接続の世話をすることができます。
応答ビルダー。チャンクエンコードボディが必要です - その後、Restinioにはあなたのための特別な応答ビルダーがあります（明らかにそれは唯一のビルダーではありません）。
ExpressJSのようなリクエストルーティング（以下の例を参照）。
C ++コンパイラからの静的チェックを使用して、ExpressJSのようなルーターの問題を回避できる実験的なタイプフェーリクエストルーター。
いくつかのリクエストハンドラーをチェーンする可能性（ExpressJSのミドルウェアに多少似ています）。
クエリ文字列パラメーターを使用します。
HTTPヘッダーを使用するためのいくつかのすぐに使用できるヘルパー（たとえば、ファイルアップロードに関連するHTTPヘッダーのサポート）。
ファイルとその部品の送信をサポートしています（Linux/UnixにSendFileおよびWindowsで送信ファイルを使用して）。
圧縮（DEFLATE、GZIP）をサポートします。
TLS（HTTPS）をサポートします。
基本的なWebSocketサポート。単にrectinio :: websocket :: basic :: upgrade（）リクエストを処理し、対応する接続でwebsocketセッションを開始します。
外部asio :: io_contextで実行できます。 Restinioは実行コンテキストから分離されています。
いくつかのチューニングオプション。アクセプターとソケットのオプションを設定できます。スレッド接続のプールでRestinioを実行するときは、並行して受け入れることができます。

Expressルーターを使用した拡張例

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