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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
/* -*- mode: C++; c-basic-offset: 4; indent-tabs-mode: nil; -*- */
// SPDX-License-Identifier: MIT OR LGPL-2.0-or-later
// SPDX-FileCopyrightText: 2008 litl, LLC
// SPDX-FileCopyrightText: 2012 Red Hat, Inc.
#ifndef GI_INTERFACE_H_
#define GI_INTERFACE_H_
#include <config.h>
#include <girepository.h>
#include <glib-object.h>
#include <glib.h>
#include <js/CallArgs.h>
#include <js/PropertySpec.h>
#include <js/RootingAPI.h>
#include <js/TypeDecls.h>
#include "gi/cwrapper.h"
#include "gi/wrapperutils.h"
#include "gjs/jsapi-util.h"
#include "gjs/macros.h"
#include "util/log.h"
class InterfacePrototype;
class InterfaceInstance;
/* For more information on this Base/Prototype/Interface scheme, see the notes
* in wrapperutils.h.
*
* What's unusual about this subclass is that InterfaceInstance should never
* actually be instantiated. Interfaces can't be constructed, and
* GIWrapperBase::constructor() is overridden to just throw an exception and not
* create any JS wrapper object.
*
* We use the template classes from wrapperutils.h anyway, because there is
* still a lot of common code.
*/
class InterfaceBase : public GIWrapperBase<InterfaceBase, InterfacePrototype,
InterfaceInstance> {
friend class CWrapperPointerOps<InterfaceBase>;
friend class GIWrapperBase<InterfaceBase, InterfacePrototype,
InterfaceInstance>;
protected:
explicit InterfaceBase(InterfacePrototype* proto = nullptr)
: GIWrapperBase(proto) {}
static constexpr GjsDebugTopic DEBUG_TOPIC = GJS_DEBUG_GINTERFACE;
static constexpr const char* DEBUG_TAG = "interface";
static const struct JSClassOps class_ops;
static const struct JSClass klass;
static JSFunctionSpec static_methods[];
// JSNative methods
// Overrides GIWrapperBase::constructor().
GJS_JSAPI_RETURN_CONVENTION
static bool constructor(JSContext* cx, unsigned argc, JS::Value* vp) {
JS::CallArgs args = JS::CallArgsFromVp(argc, vp);
gjs_throw_abstract_constructor_error(cx, args);
return false;
}
GJS_JSAPI_RETURN_CONVENTION
static bool has_instance(JSContext* cx, unsigned argc, JS::Value* vp);
};
class InterfacePrototype
: public GIWrapperPrototype<InterfaceBase, InterfacePrototype,
InterfaceInstance, GIInterfaceInfo> {
friend class GIWrapperPrototype<InterfaceBase, InterfacePrototype,
InterfaceInstance, GIInterfaceInfo>;
friend class GIWrapperBase<InterfaceBase, InterfacePrototype,
InterfaceInstance>;
friend class InterfaceBase; // for has_instance_impl
// the GTypeInterface vtable wrapped by this JS object
GTypeInterface* m_vtable;
static constexpr InfoType::Tag info_type_tag = InfoType::Interface;
explicit InterfacePrototype(GIInterfaceInfo* info, GType gtype);
~InterfacePrototype(void);
// JSClass operations
GJS_JSAPI_RETURN_CONVENTION
bool resolve_impl(JSContext* cx, JS::HandleObject obj, JS::HandleId id,
bool* resolved);
GJS_JSAPI_RETURN_CONVENTION
bool new_enumerate_impl(JSContext* cx, JS::HandleObject obj,
JS::MutableHandleIdVector properties,
bool only_enumerable);
// JS methods
GJS_JSAPI_RETURN_CONVENTION
bool has_instance_impl(JSContext* cx, const JS::CallArgs& args);
};
class InterfaceInstance
: public GIWrapperInstance<InterfaceBase, InterfacePrototype,
InterfaceInstance> {
friend class GIWrapperInstance<InterfaceBase, InterfacePrototype,
InterfaceInstance>;
friend class GIWrapperBase<InterfaceBase, InterfacePrototype,
InterfaceInstance>;
[[noreturn]] InterfaceInstance(InterfacePrototype* prototype,
JS::HandleObject obj)
: GIWrapperInstance(prototype, obj) {
g_assert_not_reached();
}
[[noreturn]] ~InterfaceInstance(void) { g_assert_not_reached(); }
};
GJS_JSAPI_RETURN_CONVENTION
bool gjs_lookup_interface_constructor(JSContext *context,
GType gtype,
JS::MutableHandleValue value_p);
#endif // GI_INTERFACE_H_
|
