libsoup的简单使用

基于GLib和libsoup的简单Web服务器示例，它可以处理静态HTML文件和动态JSON请求，并展示如何获取URL参数。

步骤：

1. 初始化GLib和libsoup。
2. 创建一个处理静态HTML文件的处理器。
3. 创建一个处理动态JSON请求的处理器。
4. 获取URL参数并在JSON响应中返回。

代码：

#include <libsoup/soup.h>
#include <glib.h>// 处理静态HTML文件请求
static void handle_static_html(SoupServer *server, SoupMessage *msg, const char *path, GHashTable *query, SoupClientContext *client, gpointer user_data) {SoupMessageHeaders *response_headers = msg->response_headers;soup_message_headers_set_content_type(response_headers, "text/html", NULL);// 读取静态HTML文件GError *error = NULL;gchar *content = NULL;g_file_get_contents("/path/to/static.html", &content, NULL, &error);if (error) {soup_message_set_status(msg, SOUP_STATUS_INTERNAL_SERVER_ERROR);soup_message_body_append(msg->response_body, SOUP_MEMORY_COPY, "Internal Server Error", 21);g_error_free(error);} else {soup_message_set_status(msg, SOUP_STATUS_OK);soup_message_body_append(msg->response_body, SOUP_MEMORY_COPY, content, strlen(content));g_free(content);}soup_message_body_complete(msg->response_body);
}// 处理动态JSON请求
static void handle_dynamic_json(SoupServer *server, SoupMessage *msg, const char *path, GHashTable *query, SoupClientContext *client, gpointer user_data) {SoupMessageHeaders *response_headers = msg->response_headers;soup_message_headers_set_content_type(response_headers, "application/json", NULL);// 获取URL参数const char *name = g_hash_table_lookup(query, "name");if (!name) {name = "World";}// 创建JSON响应gchar *response = g_strdup_printf("{\"message\": \"Hello, %s!\"}", name);soup_message_set_status(msg, SOUP_STATUS_OK);soup_message_body_append(msg->response_body, SOUP_MEMORY_COPY, response, strlen(response));g_free(response);soup_message_body_complete(msg->response_body);
}int main(int argc, char *argv[]) {GMainLoop *loop = g_main_loop_new(NULL, FALSE);SoupServer *server = soup_server_new(SOUP_SERVER_SERVER_HEADER, "example-server", NULL);// 添加处理器soup_server_add_handler(server, "/static", handle_static_html, NULL, NULL);soup_server_add_handler(server, "/dynamic", handle_dynamic_json, NULL, NULL);// 监听端口soup_server_listen_all(server, 8080, 0, NULL);g_print("Server running on http://localhost:8080\n");g_main_loop_run(loop);// 清理g_object_unref(server);g_main_loop_unref(loop);return 0;
}

编译和运行：

1. 确保安装了glib和libsoup库。
2. 使用以下命令编译代码：

   gcc -o webserver webserver.c `pkg-config --cflags --libs glib-2.0 libsoup-2.4`
   

3. 运行生成的可执行文件：

   ./webserver
   

这个示例展示了如何使用libsoup创建一个简单的Web服务器，处理静态HTML文件和动态JSON请求，并获取URL参数。你可以根据需要扩展和修改这个示例。

soup_message_body_append 函数

GitHub Copilot: 在libsoup中，soup_message_body_append函数用于将数据添加到SoupMessageBody中。该函数的第二个参数是一个枚举类型，用于指定如何处理传入的数据。这个枚举类型是SoupMemoryUse，它定义了几种不同的内存管理策略。

SoupMemoryUse 枚举类型

以下是SoupMemoryUse枚举类型的几种常见值及其含义：

1. SOUP_MEMORY_STATIC:

   • 表示传入的数据是静态的，不会被修改或释放。
   • 适用于常量字符串或全局变量。
   • 例子：

     const char *static_data = "Hello, World!";
     soup_message_body_append(body, SOUP_MEMORY_STATIC, static_data, strlen(static_data));
     

2. SOUP_MEMORY_TEMPORARY:

   • 表示传入的数据是临时的，libsoup会在内部复制一份。
   • 适用于临时变量或局部变量。
   • 例子：

     char temp_data[] = "Temporary Data";
     soup_message_body_append(body, SOUP_MEMORY_TEMPORARY, temp_data, strlen(temp_data));
     

3. SOUP_MEMORY_COPY:

   • 表示传入的数据需要被复制，libsoup会创建一份新的副本。
   • 适用于需要确保数据独立于原始数据的情况。
   • 例子：

     char *dynamic_data = g_strdup("Dynamic Data");
     soup_message_body_append(body, SOUP_MEMORY_COPY, dynamic_data, strlen(dynamic_data));
     g_free(dynamic_data); // 原始数据可以安全释放
     

4. SOUP_MEMORY_TAKE:

   • 表示传入的数据的所有权将被libsoup接管，libsoup负责释放内存。
   • 适用于动态分配的内存，且不再需要手动管理内存释放。
   • 例子：

     char *dynamic_data = g_strdup("Dynamic Data");
     soup_message_body_append(body, SOUP_MEMORY_TAKE, dynamic_data, strlen(dynamic_data));
     // 不需要手动释放 dynamic_data，libsoup 会负责
     

示例代码

以下是一个使用SoupMemoryUse枚举类型的示例代码：

#include <libsoup/soup.h>
#include <glib.h>int main() {SoupMessageBody *body = soup_message_body_new();// 使用 SOUP_MEMORY_STATICconst char *static_data = "Static Data";soup_message_body_append(body, SOUP_MEMORY_STATIC, static_data, strlen(static_data));// 使用 SOUP_MEMORY_TEMPORARYchar temp_data[] = "Temporary Data";soup_message_body_append(body, SOUP_MEMORY_TEMPORARY, temp_data, strlen(temp_data));// 使用 SOUP_MEMORY_COPYchar *dynamic_data_copy = g_strdup("Dynamic Data Copy");soup_message_body_append(body, SOUP_MEMORY_COPY, dynamic_data_copy, strlen(dynamic_data_copy));g_free(dynamic_data_copy); // 原始数据可以安全释放// 使用 SOUP_MEMORY_TAKEchar *dynamic_data_take = g_strdup("Dynamic Data Take");soup_message_body_append(body, SOUP_MEMORY_TAKE, dynamic_data_take, strlen(dynamic_data_take));// 不需要手动释放 dynamic_data_take，libsoup 会负责// 清理soup_message_body_free(body);return 0;
}

通过这些枚举值，你可以灵活地管理传入数据的内存，确保在不同场景下的内存安全和效率。