Welcome to RESTinio v.0.5 documentation!

• What Is It?
  • RESTinio features
  • The status of RESTinio
  • License
• Obtain And Build
  • Prerequisites
  • Obtaining
    • Cloning of hg repository
    • Getting archive
    • MxxRu::externals recipe
    • Vcpkg
    • Conan
  • Build
    • CMake
    • Mxx_ru
    • Dependencies default settings
  • Notes on building with Boost::ASIO
    • CMake
    • Mxx_ru
• Getting started
  • Minimalistic hello world
  • Enhance request handler
  • Enhance request handler even more
• Basic idea
  • Traits
  • Class http_server_t<Traits>
    • Running server
  • Class server_settings_t<Traits>
• Traits
  • List of types that must be defined be Traits
  • timer_manager_t
  • logger_t
  • request_handler_t
  • strand_t
  • stream_socket_t
  • http_method_mapper_t
  • connection_state_listener_t
  • ip_blocker_t
• Using restinio::run
  • Simple forms of restinio::run
  • Version of restinio::run for an existing http_server_t object
  • A helper class on_pool_runner_t
• Using external io_context
  • Running single RESTinio server on external asio::io_context object
  • Running several instances of RESTinio server on the same asio::io_context object
• Request handler
  • Request structure
• Response builder
  • RESTinio controlled output response builder
  • User controlled output response builder
  • Chunked transfer encoding output builder
  • Notificators
    • Notificator invocation logic
  • Status line
    • RFC 2616 statuses (413, 414 from RFC 7231)
    • RFC 2518 statuses
    • RFC 6585 statuses
    • RFC 7538 statuses
• Working with http headers
  • HTTP header fields
  • Request header
  • Response header
  • More details
• Query string parameters
  • Additional features of parse_query
    • Presence of unescaped asterisk in a query string
    • Support for “web beacon”
• Get values from RESTinio key-value containers
  • value_or()
  • opt_value()
• File support (sendfile)
  • File meta
  • Implementation notes
    • Posix
    • Windows
    • Other platforms
    • TLS sockets
• Buffers
  • Const buffer
  • Types with datasizeable interface
  • A shared pointer to a type with datasizeable interface
• Express router
  • Route parameters
    • Casting parameters
    • Note on string view
  • Non matched request handler
  • Regex engines
  • Performance
    • Benchmarks
• Compression (defalate, gzip)
  • zlib_t
    • params_t
    • zlib_t API
    • Usage examples
  • Easy interface
    • Single function for compression/decompression
    • Body appenders
    • Handle decompressed body
  • Samples
• Connection state listener
  • How to specify connection state listener?
    • The restinio::connection_state::notice_t class
  • When and where state listener is called?
  • Limitation of the current RESTinio logic and max_pipelined_requests
  • Thread safety of state listener
  • Performance impact
• IP-blocker
  • How to specify IP-blocker?
    • The restinio::ip_blocker::incoming_info_t class
  • When and where IP-blocker is called?
  • Thread safety of IP-blocker
  • Integration of IP-blocker and connection-state-listener
• Server settings
  • Traits independent settings
    • acceptor_options_setter
    • address
    • buffer_size
    • cleanup_func
    • concurrent_accepts_count
    • handle_request_timeout
    • max_pipelined_requests
    • port
    • protocol
    • read_next_http_message_timelimit
    • separate_accept_and_create_connect
    • socket_options_setter
    • write_http_response_timelimit
  • Traits dependent settings
    • logger
    • request_handler
    • timer_manager
• Cleanup function
  • Purpose
  • When cleanup_func is called
  • Important notes
• RESTinio context entities running on asio::io_context
  • Acceptor
  • Connection
• Websocket
  • Upgrade connection
  • Сorrectness of WebSocket frames
  • Close WebSocket
  • Minimalistic sample
• TLS support
• ASIO Support
  • ASIO Versions
  • Linking tips
  • Implementation details
• Version History
  • 0.5.1
  • 0.5.0
  • 0.4.9
  • 0.4.8.4 (including 0.4.8.1-0.4.8.7)
  • 0.4.8
  • 0.4.7
  • 0.4.6
  • 0.4.5.1
  • 0.4.4
  • 0.4.3
  • 0.4.2
  • 0.4.1
  • 0.4.0
  • 0.3.0
  • 0.2.2
  • 0.2.1
  • 0.2.0
  • 0.1.0

Indices and tables

• Index
• Module Index
• Search Page