annotate generator/dgenerator.h @ 355:08c1ca7975ab

obviated redundant virtual dispatch callbacks
author Max Samukha <maxter@spambox.com>
date Tue, 25 May 2010 17:23:11 +0300
parents 4920ef9206fe
children 9784459f0750
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
e78566595089 initial import
mandel
parents:
diff changeset
1 /****************************************************************************
e78566595089 initial import
mandel
parents:
diff changeset
2 **
e78566595089 initial import
mandel
parents:
diff changeset
3 ** Copyright (C) 1992-2008 Nokia. All rights reserved.
e78566595089 initial import
mandel
parents:
diff changeset
4 **
e78566595089 initial import
mandel
parents:
diff changeset
5 ** This file is part of Qt Jambi.
e78566595089 initial import
mandel
parents:
diff changeset
6 **
e78566595089 initial import
mandel
parents:
diff changeset
7 ** * Commercial Usage
e78566595089 initial import
mandel
parents:
diff changeset
8 * Licensees holding valid Qt Commercial licenses may use this file in
e78566595089 initial import
mandel
parents:
diff changeset
9 * accordance with the Qt Commercial License Agreement provided with the
e78566595089 initial import
mandel
parents:
diff changeset
10 * Software or, alternatively, in accordance with the terms contained in
e78566595089 initial import
mandel
parents:
diff changeset
11 * a written agreement between you and Nokia.
e78566595089 initial import
mandel
parents:
diff changeset
12 *
e78566595089 initial import
mandel
parents:
diff changeset
13 *
e78566595089 initial import
mandel
parents:
diff changeset
14 * GNU General Public License Usage
e78566595089 initial import
mandel
parents:
diff changeset
15 * Alternatively, this file may be used under the terms of the GNU
e78566595089 initial import
mandel
parents:
diff changeset
16 * General Public License versions 2.0 or 3.0 as published by the Free
e78566595089 initial import
mandel
parents:
diff changeset
17 * Software Foundation and appearing in the file LICENSE.GPL included in
e78566595089 initial import
mandel
parents:
diff changeset
18 * the packaging of this file. Please review the following information
e78566595089 initial import
mandel
parents:
diff changeset
19 * to ensure GNU General Public Licensing requirements will be met:
e78566595089 initial import
mandel
parents:
diff changeset
20 * http://www.fsf.org/licensing/licenses/info/GPLv2.html and
e78566595089 initial import
mandel
parents:
diff changeset
21 * http://www.gnu.org/copyleft/gpl.html. In addition, as a special
e78566595089 initial import
mandel
parents:
diff changeset
22 * exception, Nokia gives you certain additional rights. These rights
e78566595089 initial import
mandel
parents:
diff changeset
23 * are described in the Nokia Qt GPL Exception version 1.2, included in
e78566595089 initial import
mandel
parents:
diff changeset
24 * the file GPL_EXCEPTION.txt in this package.
e78566595089 initial import
mandel
parents:
diff changeset
25 *
e78566595089 initial import
mandel
parents:
diff changeset
26 * Qt for Windows(R) Licensees
e78566595089 initial import
mandel
parents:
diff changeset
27 * As a special exception, Nokia, as the sole copyright holder for Qt
e78566595089 initial import
mandel
parents:
diff changeset
28 * Designer, grants users of the Qt/Eclipse Integration plug-in the
e78566595089 initial import
mandel
parents:
diff changeset
29 * right for the Qt/Eclipse Integration to link to functionality
e78566595089 initial import
mandel
parents:
diff changeset
30 * provided by Qt Designer and its related libraries.
e78566595089 initial import
mandel
parents:
diff changeset
31 *
e78566595089 initial import
mandel
parents:
diff changeset
32 *
e78566595089 initial import
mandel
parents:
diff changeset
33 * If you are unsure which license is appropriate for your use, please
e78566595089 initial import
mandel
parents:
diff changeset
34 * contact the sales department at qt-sales@nokia.com.
e78566595089 initial import
mandel
parents:
diff changeset
35
e78566595089 initial import
mandel
parents:
diff changeset
36 **
e78566595089 initial import
mandel
parents:
diff changeset
37 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
e78566595089 initial import
mandel
parents:
diff changeset
38 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
e78566595089 initial import
mandel
parents:
diff changeset
39 **
e78566595089 initial import
mandel
parents:
diff changeset
40 ****************************************************************************/
e78566595089 initial import
mandel
parents:
diff changeset
41
e78566595089 initial import
mandel
parents:
diff changeset
42 #ifndef DGENERATOR_H
e78566595089 initial import
mandel
parents:
diff changeset
43 #define DGENERATOR_H
e78566595089 initial import
mandel
parents:
diff changeset
44
e78566595089 initial import
mandel
parents:
diff changeset
45 #include "generator.h"
e78566595089 initial import
mandel
parents:
diff changeset
46 #include "metajava.h"
167
ae06da58ec25 fixed hacky conversion of arguments when emmitting a signal
eldar
parents: 110
diff changeset
47 #include "cppimplgenerator.h"
1
e78566595089 initial import
mandel
parents:
diff changeset
48
e78566595089 initial import
mandel
parents:
diff changeset
49 #include <QTextStream>
341
4920ef9206fe moved enums into interfaces
Max Samukha <maxter@spambox.com>
parents: 298
diff changeset
50 #include <QStack>
1
e78566595089 initial import
mandel
parents:
diff changeset
51
e78566595089 initial import
mandel
parents:
diff changeset
52 class DocParser;
e78566595089 initial import
mandel
parents:
diff changeset
53
e78566595089 initial import
mandel
parents:
diff changeset
54 class DGenerator : public Generator
e78566595089 initial import
mandel
parents:
diff changeset
55 {
e78566595089 initial import
mandel
parents:
diff changeset
56 Q_OBJECT
e78566595089 initial import
mandel
parents:
diff changeset
57
e78566595089 initial import
mandel
parents:
diff changeset
58 public:
e78566595089 initial import
mandel
parents:
diff changeset
59 DGenerator();
e78566595089 initial import
mandel
parents:
diff changeset
60
e78566595089 initial import
mandel
parents:
diff changeset
61 static QString translateType(const AbstractMetaType *d_type, const AbstractMetaClass *context, Option option = NoOption);
e78566595089 initial import
mandel
parents:
diff changeset
62
e78566595089 initial import
mandel
parents:
diff changeset
63 void writeInjectedCode(QTextStream &s,
e78566595089 initial import
mandel
parents:
diff changeset
64 const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
65 CodeSnip::Position position);
e78566595089 initial import
mandel
parents:
diff changeset
66 static void writeArgument(QTextStream &s,
e78566595089 initial import
mandel
parents:
diff changeset
67 const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
68 const AbstractMetaArgument *d_argument,
e78566595089 initial import
mandel
parents:
diff changeset
69 uint options = 0);
e78566595089 initial import
mandel
parents:
diff changeset
70 static QString argumentString(const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
71 const AbstractMetaArgument *d_argument,
e78566595089 initial import
mandel
parents:
diff changeset
72 uint options = 0);
341
4920ef9206fe moved enums into interfaces
Max Samukha <maxter@spambox.com>
parents: 298
diff changeset
73 void writeEnum(QTextStream &s, const AbstractMetaEnum *d_enum, bool withAliases = false);
1
e78566595089 initial import
mandel
parents:
diff changeset
74 void writeIntegerEnum(QTextStream &s, const AbstractMetaEnum *d_enum);
e78566595089 initial import
mandel
parents:
diff changeset
75 void writeSignal(QTextStream &s, const AbstractMetaFunction *d_function);
e78566595089 initial import
mandel
parents:
diff changeset
76 void writeFunction(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
77 uint included_attributes = 0, uint excluded_attributes = 0);
e78566595089 initial import
mandel
parents:
diff changeset
78 void writeFieldAccessors(QTextStream &s, const AbstractMetaField *field);
e78566595089 initial import
mandel
parents:
diff changeset
79 void writeNativeField(QTextStream &s, const AbstractMetaField *field);
e78566595089 initial import
mandel
parents:
diff changeset
80
e78566595089 initial import
mandel
parents:
diff changeset
81 void write(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
82
e78566595089 initial import
mandel
parents:
diff changeset
83 void writeFunctionOverloads(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
84 uint included_attributes, uint excluded_attributes);
e78566595089 initial import
mandel
parents:
diff changeset
85 void writeEnumOverload(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
86 uint include_attributes, uint exclude_attributes);
e78566595089 initial import
mandel
parents:
diff changeset
87 void writeExtraFunctions(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
88 void writeToStringFunction(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
89 void writeCloneFunction(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
90 void writeFunctionAttributes(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
91 uint included_attributes = 0, uint excluded_attributes = 0,
e78566595089 initial import
mandel
parents:
diff changeset
92 uint options = 0);
e78566595089 initial import
mandel
parents:
diff changeset
93 void writeConstructorContents(QTextStream &s, const AbstractMetaFunction *d_function);
e78566595089 initial import
mandel
parents:
diff changeset
94 void writeFunctionArguments(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
95 int count = -1, uint options = 0);
e78566595089 initial import
mandel
parents:
diff changeset
96 void writeJavaCallThroughContents(QTextStream &s, const AbstractMetaFunction *d_function, uint attributes = 0);
e78566595089 initial import
mandel
parents:
diff changeset
97 void writeOwnershipForContainer(QTextStream &s, TypeSystem::Ownership ownership, AbstractMetaArgument *arg);
e78566595089 initial import
mandel
parents:
diff changeset
98 void writeOwnershipForContainer(QTextStream &s, TypeSystem::Ownership ownership, AbstractMetaType *type,
e78566595089 initial import
mandel
parents:
diff changeset
99 const QString &arg_name);
e78566595089 initial import
mandel
parents:
diff changeset
100 void writePrivateNativeFunction(QTextStream &s, const AbstractMetaFunction *d_function);
e78566595089 initial import
mandel
parents:
diff changeset
101 void writeJavaLangObjectOverrideFunctions(QTextStream &s, const AbstractMetaClass *cls);
298
adae77fdc1ea Native QList implementation is now used throughout QtD
eldar
parents: 292
diff changeset
102 void writeReferenceCount(QTextStream &s, const ReferenceCount &refCount, const QString &argumentName, AbstractMetaType *argumentType = 0);
1
e78566595089 initial import
mandel
parents:
diff changeset
103 void retrieveModifications(const AbstractMetaFunction *f, const AbstractMetaClass *d_class,
e78566595089 initial import
mandel
parents:
diff changeset
104 uint *exclude_attributes, uint *include_attributes) const;
e78566595089 initial import
mandel
parents:
diff changeset
105 QString functionSignature(const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
106 uint included_attributes,
e78566595089 initial import
mandel
parents:
diff changeset
107 uint excluded_attributes,
e78566595089 initial import
mandel
parents:
diff changeset
108 Option option = NoOption,
e78566595089 initial import
mandel
parents:
diff changeset
109 int arg_count = -1);
e78566595089 initial import
mandel
parents:
diff changeset
110 void setupForFunction(const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
111 uint *included_attributes, uint *excluded_attributes) const;
e78566595089 initial import
mandel
parents:
diff changeset
112
e78566595089 initial import
mandel
parents:
diff changeset
113 virtual QString subDirectoryForClass(const AbstractMetaClass *d_class) const
e78566595089 initial import
mandel
parents:
diff changeset
114 { return subDirectoryForPackage(d_class->package()); }
e78566595089 initial import
mandel
parents:
diff changeset
115
e78566595089 initial import
mandel
parents:
diff changeset
116 virtual QString fileNameForClass(const AbstractMetaClass *d_class) const;
e78566595089 initial import
mandel
parents:
diff changeset
117
e78566595089 initial import
mandel
parents:
diff changeset
118 bool isComparable(const AbstractMetaClass *cls) const;
e78566595089 initial import
mandel
parents:
diff changeset
119
e78566595089 initial import
mandel
parents:
diff changeset
120 #if 0
e78566595089 initial import
mandel
parents:
diff changeset
121 void write1_dot_5_enum(QTextStream &s, const AbstractMetaEnum *d_enum);
e78566595089 initial import
mandel
parents:
diff changeset
122 #endif
e78566595089 initial import
mandel
parents:
diff changeset
123
e78566595089 initial import
mandel
parents:
diff changeset
124 bool shouldGenerate(const AbstractMetaClass *d_class) const {
e78566595089 initial import
mandel
parents:
diff changeset
125 return !d_class->typeEntry()->isContainer() && !d_class->typeEntry()->isVariant()
e78566595089 initial import
mandel
parents:
diff changeset
126 && (d_class->typeEntry()->codeGeneration() & TypeEntry::GenerateTargetLang);
e78566595089 initial import
mandel
parents:
diff changeset
127 }
e78566595089 initial import
mandel
parents:
diff changeset
128
e78566595089 initial import
mandel
parents:
diff changeset
129 QString documentationDirectory() const { return m_doc_directory; }
e78566595089 initial import
mandel
parents:
diff changeset
130 void setDocumentationDirectory(const QString &docDir) { m_doc_directory = docDir; }
e78566595089 initial import
mandel
parents:
diff changeset
131
e78566595089 initial import
mandel
parents:
diff changeset
132 bool documentationEnabled() const { return m_docs_enabled; }
e78566595089 initial import
mandel
parents:
diff changeset
133 void setDocumentationEnabled(bool e) { m_docs_enabled = e; }
e78566595089 initial import
mandel
parents:
diff changeset
134 void generate();
e78566595089 initial import
mandel
parents:
diff changeset
135
e78566595089 initial import
mandel
parents:
diff changeset
136 inline bool nativeJumpTable() const { return m_native_jump_table; }
e78566595089 initial import
mandel
parents:
diff changeset
137 inline void setNativeJumpTable(bool n) { m_native_jump_table = n; }
e78566595089 initial import
mandel
parents:
diff changeset
138
e78566595089 initial import
mandel
parents:
diff changeset
139 void writeShellVirtualFunction(QTextStream &s, const AbstractMetaFunction *function,
e78566595089 initial import
mandel
parents:
diff changeset
140 const AbstractMetaClass *implementor, int id);
355
08c1ca7975ab obviated redundant virtual dispatch callbacks
Max Samukha <maxter@spambox.com>
parents: 341
diff changeset
141 void marshalFromCppToD(QTextStream &s, const ComplexTypeEntry* ctype);
1
e78566595089 initial import
mandel
parents:
diff changeset
142
e78566595089 initial import
mandel
parents:
diff changeset
143 private:
e78566595089 initial import
mandel
parents:
diff changeset
144 QString subDirectoryForPackage(const QString &package) const { return QString(package).replace(".", "/"); }
e78566595089 initial import
mandel
parents:
diff changeset
145 void writeInstantiatedType(QTextStream &s, const AbstractMetaType *abstractMetaType) const;
e78566595089 initial import
mandel
parents:
diff changeset
146
e78566595089 initial import
mandel
parents:
diff changeset
147 // qtd
e78566595089 initial import
mandel
parents:
diff changeset
148 void addTypeEntry(const AbstractMetaClass *d_class, const AbstractMetaFunction *function, QSet<const TypeEntry*> &typeEntries);
e78566595089 initial import
mandel
parents:
diff changeset
149 void fillRequiredImports(const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
150 void addInstantiations(const AbstractMetaType* d_type);
e78566595089 initial import
mandel
parents:
diff changeset
151 void writeRequiredImports(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
152 const TypeEntry* fixedTypeEntry(const TypeEntry *type);
288
f9559a957be9 new signals and slots implementation
eldar
parents: 253
diff changeset
153 AbstractMetaFunctionList generatedClassFunctions(const AbstractMetaClass *d_class);
1
e78566595089 initial import
mandel
parents:
diff changeset
154
e78566595089 initial import
mandel
parents:
diff changeset
155 void writeDestructor(QTextStream &s, const AbstractMetaClass *d_class);
253
073b9153ed8a Rev. 264 done right.
maxter
parents: 252
diff changeset
156 void writeFlagsSetter(QTextStream &s, const AbstractMetaClass *d_class);
1
e78566595089 initial import
mandel
parents:
diff changeset
157 void writeSignalHandlers(QTextStream &s, const AbstractMetaClass *d_class);
341
4920ef9206fe moved enums into interfaces
Max Samukha <maxter@spambox.com>
parents: 298
diff changeset
158 void writeEnumAliases(QTextStream &s, const AbstractMetaEnum *d_enum);
253
073b9153ed8a Rev. 264 done right.
maxter
parents: 252
diff changeset
159 void writeSignalSignatures(QTextStream &s, const AbstractMetaClass *d_class, AbstractMetaFunctionList signal_funcs);
288
f9559a957be9 new signals and slots implementation
eldar
parents: 253
diff changeset
160 void writeMetaMethodArguments(QTextStream &s, const AbstractMetaFunction *d_function, int reduce = -1);
105
3aa118a9ae71 each QObject now has associated child QObject for handling signals. fixes #15
eldar
parents: 1
diff changeset
161 void writeQObjectFunctions(QTextStream &s, const AbstractMetaClass *d_class);
288
f9559a957be9 new signals and slots implementation
eldar
parents: 253
diff changeset
162 void writeQObjectFreeFunctions(QTextStream &s, const AbstractMetaClass *d_class);
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
163 void writeConversionFunction(QTextStream &s, const AbstractMetaClass *d_class);
292
19498f420252 more QList goodness
eldar
parents: 288
diff changeset
164 void writeValueFreeFunctions(QTextStream &s, const AbstractMetaClass *d_class);
19498f420252 more QList goodness
eldar
parents: 288
diff changeset
165 void writeValueFunctions(QTextStream &s, const AbstractMetaClass *d_class);
105
3aa118a9ae71 each QObject now has associated child QObject for handling signals. fixes #15
eldar
parents: 1
diff changeset
166
1
e78566595089 initial import
mandel
parents:
diff changeset
167 // void writeMarshallFunction(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
168
e78566595089 initial import
mandel
parents:
diff changeset
169 int m_recursive;
e78566595089 initial import
mandel
parents:
diff changeset
170 bool m_isRecursive;
341
4920ef9206fe moved enums into interfaces
Max Samukha <maxter@spambox.com>
parents: 298
diff changeset
171 QStack<const AbstractMetaClass*> m_recursionStack;
1
e78566595089 initial import
mandel
parents:
diff changeset
172 QSet<const TypeEntry*> typeEntries; // imports
e78566595089 initial import
mandel
parents:
diff changeset
173 QSet<const TypeEntry*> typeEntriesEnums; // imports for enums
e78566595089 initial import
mandel
parents:
diff changeset
174 QSet<QString> excludedTypes2;
e78566595089 initial import
mandel
parents:
diff changeset
175
e78566595089 initial import
mandel
parents:
diff changeset
176 protected:
e78566595089 initial import
mandel
parents:
diff changeset
177 void writeImportString(QTextStream &s, const TypeEntry* typeEntry);
e78566595089 initial import
mandel
parents:
diff changeset
178
e78566595089 initial import
mandel
parents:
diff changeset
179 QSet<QString> excludedTypes;
e78566595089 initial import
mandel
parents:
diff changeset
180 QString m_package_name;
e78566595089 initial import
mandel
parents:
diff changeset
181 QString m_doc_directory;
e78566595089 initial import
mandel
parents:
diff changeset
182 DocParser *m_doc_parser;
e78566595089 initial import
mandel
parents:
diff changeset
183 bool m_docs_enabled;
e78566595089 initial import
mandel
parents:
diff changeset
184 bool m_native_jump_table;
e78566595089 initial import
mandel
parents:
diff changeset
185 QList<const AbstractMetaFunction *> m_nativepointer_functions;
e78566595089 initial import
mandel
parents:
diff changeset
186 QList<const AbstractMetaFunction *> m_resettable_object_functions;
e78566595089 initial import
mandel
parents:
diff changeset
187 QList<const AbstractMetaFunction *> m_reference_count_candidate_functions;
e78566595089 initial import
mandel
parents:
diff changeset
188 };
e78566595089 initial import
mandel
parents:
diff changeset
189
e78566595089 initial import
mandel
parents:
diff changeset
190 class ClassFromEntry : Generator
e78566595089 initial import
mandel
parents:
diff changeset
191 {
e78566595089 initial import
mandel
parents:
diff changeset
192 Q_OBJECT
e78566595089 initial import
mandel
parents:
diff changeset
193
e78566595089 initial import
mandel
parents:
diff changeset
194 private:
e78566595089 initial import
mandel
parents:
diff changeset
195 ClassFromEntry();
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
196 void buildHash();
1
e78566595089 initial import
mandel
parents:
diff changeset
197 QHash<const TypeEntry *, AbstractMetaClass *> classFromEntry;
e78566595089 initial import
mandel
parents:
diff changeset
198 static ClassFromEntry* m_instance;
e78566595089 initial import
mandel
parents:
diff changeset
199
e78566595089 initial import
mandel
parents:
diff changeset
200 public:
e78566595089 initial import
mandel
parents:
diff changeset
201 static AbstractMetaClass* get(const TypeEntry *te);
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
202 static void print(QTextStream &s);
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
203 static void construct(const AbstractMetaClassList &classes);
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
204
1
e78566595089 initial import
mandel
parents:
diff changeset
205 };
e78566595089 initial import
mandel
parents:
diff changeset
206 #endif // DGENERATOR_H