要创建HTTP服务器,请按照以下格式:
- 通过调用
mg_bind()
或mg_bind_opt()创建侦听连接
调用mg_set_protocol_http_websocket()
创建listening连接。它附带一个内置的HTTP事件处理程序,它解析传入的数据并触发HTTP特定的事件。例如,当HTTP请求完全缓冲时,内置的HTTP处理程序会解析请求,并调用用户定义的事件处理程序,并将MG_EV_HTTP_REQUEST
事件和解析的HTTP请求作为事件数据。- 创建事件处理函数。请注意,事件处理程序接收所有事件 - 低级TCP事件
MG_EV_RECV
和高级HTTP事件,如MG_EV_HTTP_REQUEST
。通常情况下,事件处理函数只能处理MG_EV_HTTP_REQUEST
事件。
以下是最简单HTTP服务器的示例。为了清楚起见,省略了错误检查:
#include "mongoose.h" static const char *s_http_port = "8000"; static void ev_handler(struct mg_connection *c, int ev, void *p) { if (ev == MG_EV_HTTP_REQUEST) { struct http_message *hm = (struct http_message *) p; // We have received an HTTP request. Parsed request is contained in `hm`. // Send HTTP reply to the client which shows full original request. mg_send_head(c, 200, hm.message.len, "Content-Type: text/plain"); mg_printf(c, "%.*s", hm.message.len, hm.message.p); } } int main(void) { struct mg_mgr mgr; struct mg_connection *c; mg_mgr_init(&mgr, NULL); c = mg_bind(&mgr, s_http_port, ev_handler); mg_set_protocol_http_websocket(c); for (;;) { mg_mgr_poll(&mgr, 1000); } mg_mgr_free(&mgr); return 0; }
要创建HTTP客户端,请遵循以下模式:
- 通过调用创建出站连接
mg_connect_http()
- 创建一个处理
MG_EV_HTTP_REPLY
事件的事件处理函数
以下是最简单HTTP客户端的示例。为了清楚起见,省略错误检查:
#include "mongoose.h" static const char *url = "http://www.google.com"; static int exit_flag = 0; static void ev_handler(struct mg_connection *c, int ev, void *p) { if (ev == MG_EV_HTTP_REPLY) { c->flags |= MG_F_CLOSE_IMMEDIATELY; fwrite(hm->message.p, 1, hm->message.len, stdout); putchar('\n'); exit_flag = 1; } else if (ev == MG_EV_CLOSE) { exit_flag = 1; }; } int main(void) { struct mg_mgr mgr; mg_mgr_init(&mgr, NULL); mg_connect_http(mgr, ev_handler, url, NULL, NULL); while (exit_flag == 0) { mg_mgr_poll(&mgr, 1000); } mg_mgr_free(&mgr); return 0; }
HTTP事件
如概述所述,mg_set_protocol_http_websocket()
函数解析输入数据,将其视为HTTP或WebSocket,并触发高级HTTP或WebSocket事件。以下是HTTP特有的事件列表。
- MG_EV_HTTP_REQUEST:HTTP请求到达。解析的请求
struct http_message
通过处理程序的void *ev_data
指针传递 。 - MG_EV_HTTP_REPLY:HTTP回复已到。解析的回复
struct http_message
通过处理程序的void *ev_data
指针传递。 - MG_EV_HTTP_MULTIPART_REQUEST:多部分POST请求已到。此事件在body解析之前发送。此后,用户应该期望一系列MG_EV_HTTP_PART_BEGIN / DATA / END请求。这也是头文件和其他请求字段可访问的最后一次。
- MG_EV_HTTP_CHUNK:一个HTTP分块编码块到了。解析的HTTP回复
struct http_message
通过处理程序的void *ev_data
指针传递。http_message::body
将包含不完整的,重新组合的HTTP身体。它将随着到达的每一个新的块增长,并且可能消耗大量的内存。事件处理程序可以处理以分块形式到来的body,并通知Mongoose通过设定在mg_connection::flags中的MG_F_DELETE_CHUNK来删除body
。当接收到最后一个零块时,Mongoose会发送MG_EV_HTTP_REPLY
具有完全重新组合的身体的事件(如果处理程序没有指示删除块)或空的身体(如果处理程序发出信号删除块)。 - MG_EV_HTTP_PART_BEGIN:多部分消息的新部分启动,额外的参数将以mg_http_multipart_part发送
- MG_EV_HTTP_PART_DATA:来自多部分消息的新部分数据没有附加头可用,只有数据和数据大小
- MG_EV_HTTP_PART_END:接收到最后一个边界,可能用于找到包的结尾注意:Mongoose应使用MG_ENABLE_HTTP_STREAMING_MULTIPART进行编译,以启用多部分事件。
提供文件
API函数mg_serve_http()
可以轻松地从文件系统提供文件。一般来说,该功能是提供静态文件CGI和SSI的HTTP服务器的实现。它的行为是由整合到结构中的选项列表驱动的struct mg_serve_http_opts
。有关完整的功能列表,请参阅struct mg_serve_http_opts定义mg_serve_http()
。
例如,为了创建一个从当前目录提供静态文件的Web服务器,实现如下的事件处理函数:
static void ev_handler(struct mg_connection *c, int ev, void *ev_data) { if (ev == MG_EV_HTTP_REQUEST) { struct mg_serve_http_opts opts; memset(&opts, 0, sizeof(opts); // Reset all options to defaults opts.document_root = "."; // Serve files from the current directory mg_serve_http(c, (struct http_message *) ev_data, s_http_server_opts); } }
其他选项请参考:
https://docs.cesanta.com/mongoose/master/#/overview/event-handler.md/