تنزيل restinio - تنزيل رمز المصدر restinio

restinio

ج/ج++

v.0.7.3

تنزيل

ما هو Restinio؟

RESTINIO هي مكتبة C ++ 17 تمنحك خادم HTTP/WebSocket مضمن. يعتمد على النسخة المستقلة من ASIO ويستهدف في المقام الأول للمعالجة غير المتزامنة لمقالات HTTP. Boost :: Asio مدعوم أيضا.

Restinio نفسها هي مكتبة رأس فقط ، ولكنها تعتمد على NodeJS/LLHTTP التي ليست رأسًا فقط.

RESTINIO حاليًا في حالة مستقرة إلى حد ما ، ونحن نعتقد أنه منذ الإصدار v.0.4.0 فهي جاهزة للاستخدام الإنتاج.

مثال أساسي للغاية على Restinio

النظر في مهمة كتابة تطبيق C ++ الذي يجب أن يدعم بعض API REST ، تمثل 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 معين ، بحيث يمكنك تطبيق منطق معقد للتعامل مع طلبات التعامل معها.

سمات

طلب ASYNC معالجة. لا يمكن الحصول على بيانات الاستجابة على الفور؟ هذا جيد ، قم بتخزين طلب طلب في مكان ما و/أو تمريره إلى سياق تنفيذ آخر والعودة إليه عندما تكون البيانات جاهزة.
HTTP الأنابيب. يعمل بشكل جيد مع معالجة طلب ASYNC. قد يزيد من إنتاجية الخادم بشكل كبير.
التحكم في المهلة. يمكن أن تعتني Restinio بالاتصال السيئ الذي يشبه: إرسال "get /" ثم عالق.
بناة الاستجابة. يحتاج إلى جسم مشفر مكثف - ثم Restinio لديه منشئ استجابة خاص لك (من الواضح أنه ليس المنشئ الوحيد).
توجيه الطلب الشبيه بـ ExpressJS (انظر مثال أدناه).
جهاز توجيه طلب Typesafe التجريبي الذي يسمح بتجنب مشاكل جهاز التوجيه الشبيه بـ ExpressJS بمساعدة الشيكات الثابتة من برنامج التحويل البرمجي C ++.
إمكانية لسلسلة العديد من معالجات الطلب (تشبه إلى حد ما البرامج الوسيطة لـ ExpressJS).
العمل مع معلمات سلسلة الاستعلام.
العديد من المساعدين الجاهدين للاستخدام للعمل مع رؤوس HTTP (على سبيل المثال ، دعم رؤوس HTTP المتعلقة بتحميل الملف).
يدعم إرسال الملفات وأجزائها (مع SendFile على Linux/Unix و Transmitfile على Windows).
يدعم الضغط (المنهج ، GZIP).
يدعم TLS (HTTPS).
دعم WebSocket الأساسي. ببساطة RESTINIO :: WebSocket :: Basic :: Upgrade () مقبض الطلب وبدء جلسة WebSocket على اتصال مقابل.
يمكن تشغيل على ASIO الخارجي :: io_context. يتم فصل Restinio عن سياق التنفيذ.
بعض خيارات اللحن. يمكن للمرء تعيين خيارات قبول ومقبس. عند تشغيل Restinio على مجموعة من اتصالات الخيوط يمكن قبولها بالتوازي.

مثال محسن مع جهاز التوجيه السريع

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