Download de restinio - Download de código fonte restinio

restinio

C/C++

v.0.7.3

Baixar

O que é Restinio?

Restinio é uma biblioteca C ++ 17 que oferece um servidor HTTP/WebSocket incorporado. É baseado na versão independente da ASIO e direcionada principalmente para o processamento assíncrono de solicitações http. Boost :: ASIO também é suportado.

O próprio Restinio é uma biblioteca somente para cabeçalho, mas depende do NodeJS/LLHTTP que não é apenas o cabeçalho.

Atualmente, o Restinio está em estado bastante estável e achamos que, desde V.0.4.0, ele está pronto para o uso da produção.

Um exemplo muito básico de Restinio

Considere a tarefa de escrever um aplicativo C ++ que deve suportar alguma API REST, o Restinio representa nossa solução para essa tarefa.

Vamos ver como é no caso mais simples:

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

O servidor é executado no thread principal e responda a todas as solicitações com a mensagem Hello-World. É claro que você tem acesso à estrutura de uma determinada solicitação HTTP, para que você possa aplicar uma lógica complexa para lidar com solicitações.

Características

Manuseio de solicitação assíncrona. Não pode obter os dados de resposta imediatamente? Tudo bem, a solicitação da loja lide em algum lugar e/ou passa para outro contexto de execução e volte a ele quando os dados estiverem prontos.
HTTP Pipelining. Funciona bem com o manuseio de solicitação assíncrona. Pode aumentar drasticamente o seu rendimento do servidor.
Controle de tempo limite. Restinio pode cuidar de uma conexão ruim que é como: Enviar "Get /" e depois apenas preso.
Construtores de resposta. Precisa de um corpo codificado em grama - então Restinio tem um construtor de respostas especial para você (obviamente não é o único construtor).
Roteamento de solicitação do tipo ExpressJS (veja um exemplo abaixo).
Um roteador de solicitação experimental da Afeta de Tipete que permite evitar problemas do roteador do tipo ExpressJS com a ajuda de verificações estáticas do compilador C ++.
A possibilidade de acorrentar vários manipuladores de solicitação (um pouco semelhantes ao middleware do ExpressJS).
Trabalhando com parâmetros de string de consulta.
Vários ajudantes prontos para uso para trabalhar com cabeçalhos HTTP (por exemplo, o suporte para cabeçalhos HTTP relacionados ao upload de arquivos).
Suporta o envio de arquivos e suas peças (com o SendFile no Linux/Unix e Transmitfile no Windows).
Suporta compactação (deflate, gzip).
Suporta TLS (HTTPS).
Suporte básico do WebSocket. Simplesmente Restinio :: WebSocket :: Basic :: Upgrade () A Solicitação Handle e inicie a sessão do WebSocket em uma conexão correspondente.
Pode ser executado no ASIO externo :: io_context. Restinio é separado do contexto de execução.
Algumas opções de música. Pode -se definir opções de aceitador e soquete. Ao executar o Restinio em um pool de conexões de threads, pode ser aceito em paralelo.

Exemplo aprimorado com roteador expresso

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