1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
/*
* cog-request-handler.c
* Copyright (C) 2017-2018 Adrian Perez <aperez@igalia.com>
*
* Distributed under terms of the MIT license.
*/
#include "cog-request-handler.h"
/**
* CogRequestHandler:
*
* Convenience interface which allows implementing custom URI scheme handlers.
*
* Any object that implements this interface can be passed to
* [method@Cog.Shell.set_request_handler]. An advantage of using this
* interface instead of [method@WebKit.WebContext.register_uri_scheme]
* directly is that it allows for extending handlers (by subclassing) and
* for more easily combining different handlers in an aggregate one (like
* [class@Cog.PrefixRoutesHandler] is that it allows for extending handlers
* (by subclassing), supports combining different handlers in an aggregate
* one (like [class@Cog.PrefixRoutesHandler]) more easily, and handler
* implementations can keep their state in the object instances.
*
* ### Implementations
*
* - [class@Cog.DirectoryFilesHandler]
* - [class@Cog.PrefixRoutesHandler]
*/
G_DEFINE_INTERFACE (CogRequestHandler, cog_request_handler, G_TYPE_OBJECT);
static void
cog_request_handler_default_init (CogRequestHandlerInterface *iface)
{
}
/**
* cog_request_handler_run: (virtual run)
* @request: A request to handle.
*
* Handle a single custom URI scheme request.
*/
void
cog_request_handler_run (CogRequestHandler *handler, WebKitURISchemeRequest *request)
{
g_return_if_fail (COG_IS_REQUEST_HANDLER (handler));
g_return_if_fail (WEBKIT_IS_URI_SCHEME_REQUEST (request));
CogRequestHandlerInterface *iface = COG_REQUEST_HANDLER_GET_IFACE (handler);
g_return_if_fail (iface->run != NULL);
(*iface->run) (handler, request);
}
|
