5.1. http_server
— HTTP server¶
Source code: src/inet/http_server.h, src/inet/http_server.c
Test code: tst/inet/http_server/main.c
Test coverage: src/inet/http_server.c
Typedefs
-
typedef
int(* http_server_route_callback_t)(struct http_server_connection_t *connection_p, struct http_server_request_t *request_p)
Enums
-
enum
http_server_request_action_t
¶ Request action types.
Values:
-
http_server_request_action_get_t
= 0¶
-
http_server_request_action_post_t
= 1¶
-
-
enum
http_server_content_type_t
¶ Content type.
Values:
-
http_server_content_type_text_plain_t
= 0¶
-
http_server_content_type_text_html_t
= 1¶
-
Functions
-
int
http_server_init
(struct http_server_t *self_p, struct http_server_listener_t *listener_p, struct http_server_connection_t *connections_p, const char *root_path_p, const struct http_server_route_t *routes_p, http_server_route_callback_t on_no_route)¶ Initialize given http server with given root path and maximum number of clients.
- Return
- zero(0) or negative error code.
- Parameters
self_p
-Http server to initialize.
listener_p
-Listener.
connections_p
-A NULL terminated list of connections.
root_path_p
-Working directory for the connection threads.
routes_p
-An array of routes.
on_no_route
-Callback called for all requests without a matching route in route_p.
-
int
http_server_start
(struct http_server_t *self_p)¶ Start given HTTP server.
Spawn the threads and start listening for connections.
- Return
- zero(0) or negative error code.
- Parameters
self_p
-Http server.
-
int
http_server_stop
(struct http_server_t *self_p)¶ Stop given HTTP server.
Closes the listener and all open connections, and then kills the threads.
- Return
- zero(0) or negative error code.
- Parameters
self_p
-Http server.
-
int
http_server_response_write
(struct http_server_connection_t *connection_p, struct http_server_request_t *request_p, struct http_server_response_t *response_p)¶ Write given HTTP response to given connected client. This function should only be called from the route callbacks to respond to given request.
- Return
- zero(0) or negative error code.
- Parameters
connection_p
-Current connection.
request_p
-Current request.
response_p
-Current response. If
buf_p
in the response to NULL this function will only write the HTTP header, including the size, to the socket. After this function returns write the payload by callingsocket_write()
.
-
struct
http_server_request_t
¶ - #include <http_server.h>
HTTP request.
Public Members
-
char
path
[64]¶
-
int
present
¶
-
char
value
[64]¶
-
struct http_server_request_t::@33::@34 http_server_request_t::sec_websocket_key
-
struct http_server_request_t::@33::@35 http_server_request_t::content_type
-
long
value
¶
-
struct http_server_request_t::@33::@36 http_server_request_t::content_length
-
struct http_server_request_t::@33::@37 http_server_request_t::authorization
-
struct http_server_request_t::@33 http_server_request_t::headers
-
char
-
struct
http_server_response_t
¶ - #include <http_server.h>
HTTP response.
-
struct
http_server_listener_t
¶
-
struct
http_server_connection_t
¶ Public Members
-
const char *
name_p
¶
-
void *
buf_p
¶
-
size_t
size
¶
-
struct http_server_connection_t::@41::@42 http_server_connection_t::stack
-
struct http_server_connection_t::@41 http_server_connection_t::thrd
-
struct http_server_t *
self_p
¶
-
const char *
-
struct
http_server_route_t
¶ - #include <http_server.h>
Call given callback for given path.
-
struct
http_server_t
¶ Public Members
-
const char *
root_path_p
¶
-
const struct http_server_route_t *
routes_p
¶
-
http_server_route_callback_t
on_no_route
¶
-
struct http_server_listener_t *
listener_p
¶
-
struct http_server_connection_t *
connections_p
¶
-
const char *