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 -запроса, поэтому вы можете применить сложную логику для обработки запросов.

Функции

Асинхронная обработка запроса. Не можете получить данные ответа немедленно? Это нормально, хранить запрос где -то и/или передавать его в другой контекст выполнения и вернуться к нему, когда данные будут готовы.
HTTP Pipeling. Хорошо работает с асинхронным обработкой запросов. Это может значительно увеличить пропускную способность вашего сервера.
КОНТРОЛЬ ТАКАУТ. Restinio может позаботиться о плохом соединении: отправить «Get /», а затем просто застрял.
Строители ответов. Нужно кусочено корпус - тогда Restinio имеет для вас специальный строитель ответов (очевидно, это не единственный строитель).
Экспресс-подобная маршрутизация запросов (см. Пример ниже).
Экспериментальный маршрутизатор запроса Typesafe, который позволяет избежать проблем маршрутизатора, подобного ExpressJS с помощью статических проверок от компилятора C ++.
Возможность цепорить несколько запросов (несколько похожа на промежуточное программное обеспечение ExpressJS).
Работа с параметрами строки запроса.
Несколько готовых помощников для работы с заголовками HTTP (например, поддержка заголовков HTTP, связанных с загрузкой файлов).
Поддерживает отправку файлов и его детали (с SendFile на Linux/Unix и передачи в 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 ;
}