ดาวน์โหลด restinio - ดาวน์โหลดซอร์สโค้ด restinio

restinio

ซี/ซี++

v.0.7.3

ดาวน์โหลด

Restinio คืออะไร?

Restinio เป็นไลบรารี C ++ 17 ที่ให้เซิร์ฟเวอร์ HTTP/WebSocket แบบฝังตัว มันขึ้นอยู่กับ ASIO รุ่นสแตนด์อโลนและเป้าหมายเป็นหลักสำหรับการประมวลผลแบบอะซิงโครนัสของ HTTP-Requests Boost :: ASIO ได้รับการสนับสนุน

Restinio เองเป็นไลบรารีส่วนหัวเท่านั้น แต่ขึ้นอยู่กับ NodeJS/LLHTTP ที่ไม่ใช่ส่วนหัวเท่านั้น

ปัจจุบัน Restinio อยู่ในสถานะค่อนข้างมั่นคงและเราคิดว่าตั้งแต่ V.0.4.0 มันพร้อมสำหรับการใช้งานการผลิต

ตัวอย่างพื้นฐานของ Restinio

พิจารณางานของการเขียนแอปพลิเคชัน C ++ ที่ต้องสนับสนุน REST API บางส่วน 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 pipelining ทำงานได้ดีกับการจัดการคำขอ Async มันอาจเพิ่มปริมาณงานเซิร์ฟเวอร์ของคุณอย่างมาก
การควบคุมการหมดเวลา Restinio สามารถดูแลการเชื่อมต่อที่ไม่ดีที่เป็นเช่น: ส่ง "get /" แล้วก็ติดอยู่
ผู้สร้างการตอบสนอง ต้องการร่างกายที่เข้ารหัส chunked - จากนั้น Restinio มีตัวสร้างการตอบสนองพิเศษสำหรับคุณ (เห็นได้ชัดว่ามันไม่ใช่ผู้สร้างเพียงคนเดียว)
การกำหนดเส้นทางการร้องขอแบบ ExpressJS (ดูตัวอย่างด้านล่าง)
เราเตอร์คำขอประเภทการทดลองที่ช่วยหลีกเลี่ยงปัญหาของเราเตอร์ที่มีลักษณะคล้าย ExpressJS ด้วยความช่วยเหลือในการตรวจสอบแบบคงที่จากคอมไพเลอร์ C ++
ความเป็นไปได้ที่จะใช้ตัวจัดการผู้ร้องขอหลายคน (ค่อนข้างคล้ายกับมิดเดิลแวร์ของ ExpressJS)
การทำงานกับพารามิเตอร์สตริงแบบสอบถาม
ผู้ช่วยที่พร้อมใช้งานหลายคนสำหรับการทำงานกับส่วนหัว HTTP (ตัวอย่างเช่นการสนับสนุนส่วนหัว HTTP ที่เกี่ยวข้องกับการอัปโหลดไฟล์)
รองรับการส่งไฟล์และชิ้นส่วน (พร้อม sendfile บน linux/unix และ transmitfile บน Windows)
รองรับการบีบอัด (deflate, GZIP)
รองรับ TLS (HTTPS)
การสนับสนุน WebSocket ขั้นพื้นฐาน Simply 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 ;
}