1 /****************************************************************************
2 **
3 ** Copyright (C) 2018 The Qt Company Ltd.
4 ** Contact: https://www.qt.io/licensing/
5 **
6 ** This file is part of the QtQml module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see https://www.qt.io/terms-conditions. For further
15 ** information use the contact form at https://www.qt.io/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 3 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL3 included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 3 requirements
23 ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24 **
25 ** GNU General Public License Usage
26 ** Alternatively, this file may be used under the terms of the GNU
27 ** General Public License version 2.0 or (at your option) the GNU General
28 ** Public license version 3 or any later version approved by the KDE Free
29 ** Qt Foundation. The licenses are as published by the Free Software
30 ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31 ** included in the packaging of this file. Please review the following
32 ** information to ensure the GNU General Public License requirements will
33 ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34 ** https://www.gnu.org/licenses/gpl-3.0.html.
35 **
36 ** $QT_END_LICENSE$
37 **
38 ****************************************************************************/
39 #ifndef QV4PROXY_P_H
40 #define QV4PROXY_P_H
41 
42 //
43 //  W A R N I N G
44 //  -------------
45 //
46 // This file is not part of the Qt API.  It exists purely as an
47 // implementation detail.  This header file may change from version to
48 // version without notice, or even be removed.
49 //
50 // We mean it.
51 //
52 
53 #include "qv4object_p.h"
54 #include "qv4functionobject_p.h"
55 
56 QT_BEGIN_NAMESPACE
57 
58 namespace QV4 {
59 
60 namespace Heap {
61 
62 #define ProxyObjectMembers(class, Member) \
63     Member(class, Pointer, Object *, target) \
64     Member(class, Pointer, Object *, handler)
65 
DECLARE_HEAP_OBJECT(ProxyObject,FunctionObject)66 DECLARE_HEAP_OBJECT(ProxyObject, FunctionObject) {
67     DECLARE_MARKOBJECTS(ProxyObject)
68 
69     void init(const QV4::Object *target, const QV4::Object *handler);
70 };
71 
72 struct ProxyFunctionObject : ProxyObject {
73     void init(const QV4::FunctionObject *target, const QV4::Object *handler);
74 };
75 
76 #define ProxyMembers(class, Member) \
77     Member(class, Pointer, Symbol *, revokableProxySymbol) \
78 
DECLARE_HEAP_OBJECT(Proxy,FunctionObject)79 DECLARE_HEAP_OBJECT(Proxy, FunctionObject) {
80     DECLARE_MARKOBJECTS(Proxy)
81 
82     void init(QV4::ExecutionContext *ctx);
83 };
84 
85 }
86 
87 /*
88  * The inheritance from FunctionObject is a hack. Regular proxy objects are no function objects.
89  * But this helps implement the proxy for function objects, where we need this and thus gives us
90  * all the virtual methods from ProxyObject without having to duplicate them.
91  *
92  * But it does require a few hacks to make sure we don't recognize regular proxy objects as function
93  * objects in the runtime.
94  */
95 struct ProxyObject : FunctionObject {
96     V4_OBJECT2(ProxyObject, Object)
97     Q_MANAGED_TYPE(ProxyObject)
98     V4_INTERNALCLASS(ProxyObject)
99     enum {
100         IsFunctionObject = false
101     };
102 
103     static ReturnedValue virtualGet(const Managed *m, PropertyKey id, const Value *receiver, bool *hasProperty);
104     static bool virtualPut(Managed *m, PropertyKey id, const Value &value, Value *receiver);
105     static bool virtualDeleteProperty(Managed *m, PropertyKey id);
106     static bool virtualHasProperty(const Managed *m, PropertyKey id);
107     static PropertyAttributes virtualGetOwnProperty(const Managed *m, PropertyKey id, Property *p);
108     static bool virtualDefineOwnProperty(Managed *m, PropertyKey id, const Property *p, PropertyAttributes attrs);
109     static bool virtualIsExtensible(const Managed *m);
110     static bool virtualPreventExtensions(Managed *);
111     static Heap::Object *virtualGetPrototypeOf(const Managed *);
112     static bool virtualSetPrototypeOf(Managed *, const Object *);
113     static OwnPropertyKeyIterator *virtualOwnPropertyKeys(const Object *m, Value *iteratorTarget);
114 };
115 
116 struct ProxyFunctionObject : ProxyObject {
117     V4_OBJECT2(ProxyFunctionObject, FunctionObject)
118     Q_MANAGED_TYPE(ProxyObject)
119     V4_INTERNALCLASS(ProxyFunctionObject)
120     enum {
121         IsFunctionObject = true
122     };
123 
124     static ReturnedValue virtualCallAsConstructor(const FunctionObject *f, const Value *argv, int argc, const Value *);
125     static ReturnedValue virtualCall(const FunctionObject *f, const Value *thisObject, const Value *argv, int argc);
126 };
127 
128 struct Proxy : FunctionObject
129 {
130     V4_OBJECT2(Proxy, FunctionObject)
131 
132     static ReturnedValue virtualCallAsConstructor(const FunctionObject *f, const Value *argv, int argc, const Value *);
133     static ReturnedValue virtualCall(const FunctionObject *, const Value *thisObject, const Value *argv, int argc);
134 
135     static ReturnedValue method_revocable(const FunctionObject *, const Value *thisObject, const Value *argv, int argc);
136 
137     static ReturnedValue method_revoke(const FunctionObject *, const Value *thisObject, const Value *argv, int argc);
138 };
139 
140 }
141 
142 QT_END_NAMESPACE
143 
144 #endif // QV4ECMAOBJECTS_P_H
145