libcogcore-sys 0.1.0

FFI bindings to libcogcore (Cog WPE browser engine)
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>
 *
 * SPDX-License-Identifier: MIT
 */

#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);
}