annotate generator/dgenerator.h @ 292:19498f420252 signals

more QList goodness
author eldar
date Tue, 10 Nov 2009 19:29:42 +0000
parents f9559a957be9
children adae77fdc1ea
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>
e78566595089 initial import
mandel
parents:
diff changeset
50
e78566595089 initial import
mandel
parents:
diff changeset
51 class DocParser;
e78566595089 initial import
mandel
parents:
diff changeset
52
e78566595089 initial import
mandel
parents:
diff changeset
53 class DGenerator : public Generator
e78566595089 initial import
mandel
parents:
diff changeset
54 {
e78566595089 initial import
mandel
parents:
diff changeset
55 Q_OBJECT
e78566595089 initial import
mandel
parents:
diff changeset
56
e78566595089 initial import
mandel
parents:
diff changeset
57 public:
e78566595089 initial import
mandel
parents:
diff changeset
58 DGenerator();
e78566595089 initial import
mandel
parents:
diff changeset
59
e78566595089 initial import
mandel
parents:
diff changeset
60 static QString translateType(const AbstractMetaType *d_type, const AbstractMetaClass *context, Option option = NoOption);
e78566595089 initial import
mandel
parents:
diff changeset
61
e78566595089 initial import
mandel
parents:
diff changeset
62 void writeInjectedCode(QTextStream &s,
e78566595089 initial import
mandel
parents:
diff changeset
63 const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
64 CodeSnip::Position position);
e78566595089 initial import
mandel
parents:
diff changeset
65 static void writeArgument(QTextStream &s,
e78566595089 initial import
mandel
parents:
diff changeset
66 const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
67 const AbstractMetaArgument *d_argument,
e78566595089 initial import
mandel
parents:
diff changeset
68 uint options = 0);
e78566595089 initial import
mandel
parents:
diff changeset
69 static QString argumentString(const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
70 const AbstractMetaArgument *d_argument,
e78566595089 initial import
mandel
parents:
diff changeset
71 uint options = 0);
e78566595089 initial import
mandel
parents:
diff changeset
72 void writeEnum(QTextStream &s, const AbstractMetaEnum *d_enum);
e78566595089 initial import
mandel
parents:
diff changeset
73 void writeIntegerEnum(QTextStream &s, const AbstractMetaEnum *d_enum);
e78566595089 initial import
mandel
parents:
diff changeset
74 void writeSignal(QTextStream &s, const AbstractMetaFunction *d_function);
e78566595089 initial import
mandel
parents:
diff changeset
75 void writeFunction(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
76 uint included_attributes = 0, uint excluded_attributes = 0);
e78566595089 initial import
mandel
parents:
diff changeset
77 void writeFieldAccessors(QTextStream &s, const AbstractMetaField *field);
e78566595089 initial import
mandel
parents:
diff changeset
78 void writeNativeField(QTextStream &s, const AbstractMetaField *field);
e78566595089 initial import
mandel
parents:
diff changeset
79
e78566595089 initial import
mandel
parents:
diff changeset
80 void write(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
81
e78566595089 initial import
mandel
parents:
diff changeset
82 void writeFunctionOverloads(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
83 uint included_attributes, uint excluded_attributes);
e78566595089 initial import
mandel
parents:
diff changeset
84 void writeEnumOverload(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
85 uint include_attributes, uint exclude_attributes);
e78566595089 initial import
mandel
parents:
diff changeset
86 void writeExtraFunctions(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
87 void writeToStringFunction(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
88 void writeCloneFunction(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
89 void writeFunctionAttributes(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
90 uint included_attributes = 0, uint excluded_attributes = 0,
e78566595089 initial import
mandel
parents:
diff changeset
91 uint options = 0);
e78566595089 initial import
mandel
parents:
diff changeset
92 void writeConstructorContents(QTextStream &s, const AbstractMetaFunction *d_function);
e78566595089 initial import
mandel
parents:
diff changeset
93 void writeFunctionArguments(QTextStream &s, const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
94 int count = -1, uint options = 0);
e78566595089 initial import
mandel
parents:
diff changeset
95 void writeJavaCallThroughContents(QTextStream &s, const AbstractMetaFunction *d_function, uint attributes = 0);
e78566595089 initial import
mandel
parents:
diff changeset
96 void writeOwnershipForContainer(QTextStream &s, TypeSystem::Ownership ownership, AbstractMetaArgument *arg);
e78566595089 initial import
mandel
parents:
diff changeset
97 void writeOwnershipForContainer(QTextStream &s, TypeSystem::Ownership ownership, AbstractMetaType *type,
e78566595089 initial import
mandel
parents:
diff changeset
98 const QString &arg_name);
e78566595089 initial import
mandel
parents:
diff changeset
99 void writePrivateNativeFunction(QTextStream &s, const AbstractMetaFunction *d_function);
e78566595089 initial import
mandel
parents:
diff changeset
100 void writeJavaLangObjectOverrideFunctions(QTextStream &s, const AbstractMetaClass *cls);
e78566595089 initial import
mandel
parents:
diff changeset
101 void writeReferenceCount(QTextStream &s, const ReferenceCount &refCount, const QString &argumentName);
e78566595089 initial import
mandel
parents:
diff changeset
102 void retrieveModifications(const AbstractMetaFunction *f, const AbstractMetaClass *d_class,
e78566595089 initial import
mandel
parents:
diff changeset
103 uint *exclude_attributes, uint *include_attributes) const;
e78566595089 initial import
mandel
parents:
diff changeset
104 QString functionSignature(const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
105 uint included_attributes,
e78566595089 initial import
mandel
parents:
diff changeset
106 uint excluded_attributes,
e78566595089 initial import
mandel
parents:
diff changeset
107 Option option = NoOption,
e78566595089 initial import
mandel
parents:
diff changeset
108 int arg_count = -1);
e78566595089 initial import
mandel
parents:
diff changeset
109 void setupForFunction(const AbstractMetaFunction *d_function,
e78566595089 initial import
mandel
parents:
diff changeset
110 uint *included_attributes, uint *excluded_attributes) const;
e78566595089 initial import
mandel
parents:
diff changeset
111
e78566595089 initial import
mandel
parents:
diff changeset
112 virtual QString subDirectoryForClass(const AbstractMetaClass *d_class) const
e78566595089 initial import
mandel
parents:
diff changeset
113 { return subDirectoryForPackage(d_class->package()); }
e78566595089 initial import
mandel
parents:
diff changeset
114
e78566595089 initial import
mandel
parents:
diff changeset
115 virtual QString fileNameForClass(const AbstractMetaClass *d_class) const;
e78566595089 initial import
mandel
parents:
diff changeset
116
e78566595089 initial import
mandel
parents:
diff changeset
117 bool isComparable(const AbstractMetaClass *cls) const;
e78566595089 initial import
mandel
parents:
diff changeset
118
e78566595089 initial import
mandel
parents:
diff changeset
119 #if 0
e78566595089 initial import
mandel
parents:
diff changeset
120 void write1_dot_5_enum(QTextStream &s, const AbstractMetaEnum *d_enum);
e78566595089 initial import
mandel
parents:
diff changeset
121 #endif
e78566595089 initial import
mandel
parents:
diff changeset
122
e78566595089 initial import
mandel
parents:
diff changeset
123 bool shouldGenerate(const AbstractMetaClass *d_class) const {
e78566595089 initial import
mandel
parents:
diff changeset
124 return !d_class->typeEntry()->isContainer() && !d_class->typeEntry()->isVariant()
e78566595089 initial import
mandel
parents:
diff changeset
125 && (d_class->typeEntry()->codeGeneration() & TypeEntry::GenerateTargetLang);
e78566595089 initial import
mandel
parents:
diff changeset
126 }
e78566595089 initial import
mandel
parents:
diff changeset
127
e78566595089 initial import
mandel
parents:
diff changeset
128 QString documentationDirectory() const { return m_doc_directory; }
e78566595089 initial import
mandel
parents:
diff changeset
129 void setDocumentationDirectory(const QString &docDir) { m_doc_directory = docDir; }
e78566595089 initial import
mandel
parents:
diff changeset
130
e78566595089 initial import
mandel
parents:
diff changeset
131 bool documentationEnabled() const { return m_docs_enabled; }
e78566595089 initial import
mandel
parents:
diff changeset
132 void setDocumentationEnabled(bool e) { m_docs_enabled = e; }
e78566595089 initial import
mandel
parents:
diff changeset
133 void generate();
e78566595089 initial import
mandel
parents:
diff changeset
134
e78566595089 initial import
mandel
parents:
diff changeset
135 inline bool nativeJumpTable() const { return m_native_jump_table; }
e78566595089 initial import
mandel
parents:
diff changeset
136 inline void setNativeJumpTable(bool n) { m_native_jump_table = n; }
e78566595089 initial import
mandel
parents:
diff changeset
137
e78566595089 initial import
mandel
parents:
diff changeset
138 void writeShellVirtualFunction(QTextStream &s, const AbstractMetaFunction *function,
e78566595089 initial import
mandel
parents:
diff changeset
139 const AbstractMetaClass *implementor, int id);
e78566595089 initial import
mandel
parents:
diff changeset
140 void marshallFromCppToD(QTextStream &s, const ComplexTypeEntry* ctype);
e78566595089 initial import
mandel
parents:
diff changeset
141
e78566595089 initial import
mandel
parents:
diff changeset
142 private:
e78566595089 initial import
mandel
parents:
diff changeset
143 QString subDirectoryForPackage(const QString &package) const { return QString(package).replace(".", "/"); }
e78566595089 initial import
mandel
parents:
diff changeset
144 void writeInstantiatedType(QTextStream &s, const AbstractMetaType *abstractMetaType) const;
e78566595089 initial import
mandel
parents:
diff changeset
145
e78566595089 initial import
mandel
parents:
diff changeset
146 // qtd
e78566595089 initial import
mandel
parents:
diff changeset
147 void addTypeEntry(const AbstractMetaClass *d_class, const AbstractMetaFunction *function, QSet<const TypeEntry*> &typeEntries);
e78566595089 initial import
mandel
parents:
diff changeset
148 void fillRequiredImports(const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
149 void addInstantiations(const AbstractMetaType* d_type);
e78566595089 initial import
mandel
parents:
diff changeset
150 void writeRequiredImports(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
151 const TypeEntry* fixedTypeEntry(const TypeEntry *type);
288
f9559a957be9 new signals and slots implementation
eldar
parents: 253
diff changeset
152 AbstractMetaFunctionList generatedClassFunctions(const AbstractMetaClass *d_class);
1
e78566595089 initial import
mandel
parents:
diff changeset
153
e78566595089 initial import
mandel
parents:
diff changeset
154 void writeDestructor(QTextStream &s, const AbstractMetaClass *d_class);
253
073b9153ed8a Rev. 264 done right.
maxter
parents: 252
diff changeset
155 void writeFlagsSetter(QTextStream &s, const AbstractMetaClass *d_class);
1
e78566595089 initial import
mandel
parents:
diff changeset
156 void writeSignalHandlers(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
157 void writeEnumAlias(QTextStream &s, const AbstractMetaEnum *d_enum);
253
073b9153ed8a Rev. 264 done right.
maxter
parents: 252
diff changeset
158 void writeSignalSignatures(QTextStream &s, const AbstractMetaClass *d_class, AbstractMetaFunctionList signal_funcs);
288
f9559a957be9 new signals and slots implementation
eldar
parents: 253
diff changeset
159 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
160 void writeQObjectFunctions(QTextStream &s, const AbstractMetaClass *d_class);
288
f9559a957be9 new signals and slots implementation
eldar
parents: 253
diff changeset
161 void writeQObjectFreeFunctions(QTextStream &s, const AbstractMetaClass *d_class);
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
162 void writeConversionFunction(QTextStream &s, const AbstractMetaClass *d_class);
292
19498f420252 more QList goodness
eldar
parents: 288
diff changeset
163 void writeValueFreeFunctions(QTextStream &s, const AbstractMetaClass *d_class);
19498f420252 more QList goodness
eldar
parents: 288
diff changeset
164 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
165
1
e78566595089 initial import
mandel
parents:
diff changeset
166 // void writeMarshallFunction(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
167
e78566595089 initial import
mandel
parents:
diff changeset
168 int m_recursive;
e78566595089 initial import
mandel
parents:
diff changeset
169 bool m_isRecursive;
e78566595089 initial import
mandel
parents:
diff changeset
170 QSet<const TypeEntry*> typeEntries; // imports
e78566595089 initial import
mandel
parents:
diff changeset
171 QSet<const TypeEntry*> typeEntriesEnums; // imports for enums
e78566595089 initial import
mandel
parents:
diff changeset
172 QSet<QString> excludedTypes2;
e78566595089 initial import
mandel
parents:
diff changeset
173
e78566595089 initial import
mandel
parents:
diff changeset
174 protected:
e78566595089 initial import
mandel
parents:
diff changeset
175 void writeImportString(QTextStream &s, const TypeEntry* typeEntry);
e78566595089 initial import
mandel
parents:
diff changeset
176
e78566595089 initial import
mandel
parents:
diff changeset
177 QSet<QString> excludedTypes;
e78566595089 initial import
mandel
parents:
diff changeset
178 QString m_package_name;
e78566595089 initial import
mandel
parents:
diff changeset
179 QString m_doc_directory;
e78566595089 initial import
mandel
parents:
diff changeset
180 DocParser *m_doc_parser;
e78566595089 initial import
mandel
parents:
diff changeset
181 bool m_docs_enabled;
e78566595089 initial import
mandel
parents:
diff changeset
182 bool m_native_jump_table;
e78566595089 initial import
mandel
parents:
diff changeset
183 QList<const AbstractMetaFunction *> m_nativepointer_functions;
e78566595089 initial import
mandel
parents:
diff changeset
184 QList<const AbstractMetaFunction *> m_resettable_object_functions;
e78566595089 initial import
mandel
parents:
diff changeset
185 QList<const AbstractMetaFunction *> m_reference_count_candidate_functions;
e78566595089 initial import
mandel
parents:
diff changeset
186 };
e78566595089 initial import
mandel
parents:
diff changeset
187
e78566595089 initial import
mandel
parents:
diff changeset
188 class ClassFromEntry : Generator
e78566595089 initial import
mandel
parents:
diff changeset
189 {
e78566595089 initial import
mandel
parents:
diff changeset
190 Q_OBJECT
e78566595089 initial import
mandel
parents:
diff changeset
191
e78566595089 initial import
mandel
parents:
diff changeset
192 private:
e78566595089 initial import
mandel
parents:
diff changeset
193 ClassFromEntry();
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
194 void buildHash();
1
e78566595089 initial import
mandel
parents:
diff changeset
195 QHash<const TypeEntry *, AbstractMetaClass *> classFromEntry;
e78566595089 initial import
mandel
parents:
diff changeset
196 static ClassFromEntry* m_instance;
e78566595089 initial import
mandel
parents:
diff changeset
197
e78566595089 initial import
mandel
parents:
diff changeset
198 public:
e78566595089 initial import
mandel
parents:
diff changeset
199 static AbstractMetaClass* get(const TypeEntry *te);
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
200 static void print(QTextStream &s);
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
201 static void construct(const AbstractMetaClassList &classes);
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
202
1
e78566595089 initial import
mandel
parents:
diff changeset
203 };
e78566595089 initial import
mandel
parents:
diff changeset
204 #endif // DGENERATOR_H