Function
SoupServerCallback
Declaration
void
(* SoupServerCallback) (
SoupServer* server,
SoupServerMessage* msg,
const char* path,
GHashTable* query,
gpointer user_data
)
Description [src]
A callback used to handle requests to a SoupServer.
path and query contain the likewise-named components of the
Request-URI, subject to certain assumptions. By default,
SoupServer decodes all percent-encoding in the URI path, such that
"/foo%2Fbar" is treated the same as "/foo/bar". If your
server is serving resources in some non-POSIX-filesystem namespace,
you may want to distinguish those as two distinct paths. In that
case, you can set the SoupServer:raw-paths property when creating
the SoupServer, and it will leave those characters undecoded.
query contains the query component of the Request-URI parsed according to
the rules for HTML form handling. Although this is the only commonly-used
query string format in HTTP, there is nothing that actually requires that
HTTP URIs use that format; if your server needs to use some other format, you
can just ignore query, and call soup_message_get_uri() and parse the URI’s
query field yourself.
See soup_server_add_handler() and soup_server_add_early_handler()
for details of what handlers can/should do.
Parameters
server-
Type:
SoupServerThe
SoupServer.The data is owned by the caller of the function. msg-
Type:
SoupServerMessageThe message being processed.
The data is owned by the caller of the function. path-
Type:
const char*The path component of
msg‘s Request-URI.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. query-
Type:
GHashTableThe parsed query component of
msg‘s Request-URI.The argument can be NULL.The data is owned by the caller of the function. user_data-
Type:
gpointerThe data passed to
soup_server_add_handler()orsoup_server_add_early_handler().The argument can be NULL.The data is owned by the caller of the function.