Descarga de restinio - Descarga del código fuente restinio

restinio

C/C++

v.0.7.3

Descargar

¿Qué es Restinio?

Restinio es una biblioteca C ++ 17 que le brinda un servidor HTTP/WebSocket integrado. Se basa en la versión independiente de ASIO y se dirige principalmente al procesamiento asincrónico de requisitos HTTP. BOOST :: ASIO también es compatible.

Restinio en sí es una biblioteca solo de encabezado, pero depende de NodeJS/LLHTTP que no sea solo de encabezado.

Actualmente, Restinio está en un estado bastante estable y creemos que desde V.0.4.0 está listo para el uso de producción.

Un ejemplo muy básico de Restinio

Considere la tarea de escribir una aplicación C ++ que debe admitir alguna API REST, Restinio representa nuestra solución para esa tarea.

Veamos cómo se siente en el caso más simple:

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

El servidor se ejecuta en el hilo principal y responde a todas las solicitudes con el mensaje Hello-World. Por supuesto, tiene acceso a la estructura de una solicitud HTTP dada, por lo que puede aplicar una lógica compleja para las solicitudes de manejo.

Características

Manejo de solicitudes de asíncrono. ¿No puede obtener los datos de respuesta de inmediato? Eso está bien, almacene la solicitud de manejo en algún lugar y/o pase a otro contexto de ejecución y vuelva a él cuando los datos estén listos.
Pipelación HTTP. Funciona bien con el manejo de solicitudes de Async. Podría aumentar drásticamente el rendimiento de su servidor.
Control de tiempo de espera. Restinio puede ocuparse de una mala conexión que son como: enviar "Get /" y luego simplemente atascado.
Constructores de respuesta. Necesita un cuerpo codificado por dijado: entonces Restinio tiene un constructor de respuesta especial para usted (obviamente no es el único constructor).
Enrutamiento de solicitudes similares a ExpressJS (vea un ejemplo a continuación).
Un enrutador de solicitud TYPSAFE experimental que permite evitar problemas de enrutador similar a ExpressJS con la ayuda de las verificaciones estáticas del compilador C ++.
La posibilidad de encadenar varios manejadores de solicitudes (algo similar al middleware de ExpressJS).
Trabajando con parámetros de cadena de consulta.
Varios ayudantes listos para usar para trabajar con los encabezados HTTP (por ejemplo, el soporte de encabezados HTTP relacionados con la carga de archivos).
Admite el envío de archivos y sus piezas (con SendFile en Linux/Unix y TransmitFile en Windows).
Admite compresión (Deflate, GZIP).
Admite TLS (HTTPS).
Soporte básico de WebSocket. Simplemente Restinio :: WebSocket :: Basic :: Upgrade () La sesión de Solicitud e Inicie WebSocket en una conexión correspondiente.
Puede ejecutarse en asio externo :: io_context. Restinio está separado del contexto de ejecución.
Algunas opciones de melodía. Uno puede establecer opciones de aceptación y socket. Al ejecutar Restinio en un grupo de conexiones de subprocesos, se puede aceptar en paralelo.

Ejemplo mejorado con enrutador expreso

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