annotate generator/dgenerator.h @ 167:ae06da58ec25

fixed hacky conversion of arguments when emmitting a signal
author eldar
date Sat, 20 Jun 2009 19:14:29 +0000
parents 136c9ee83ee5
children 7664de4a55e5
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);
e78566595089 initial import
mandel
parents:
diff changeset
152
e78566595089 initial import
mandel
parents:
diff changeset
153 void writeDestructor(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
154 void writeOwnershipMethods(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
155 void writeSignalHandlers(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
156 void writeEnumAlias(QTextStream &s, const AbstractMetaEnum *d_enum);
e78566595089 initial import
mandel
parents:
diff changeset
157 void writeSignalConnectors(QTextStream &s, const AbstractMetaClass *d_class, AbstractMetaFunctionList signal_funcs);
105
3aa118a9ae71 each QObject now has associated child QObject for handling signals. fixes #15
eldar
parents: 1
diff changeset
158 void writeQObjectFunctions(QTextStream &s, const AbstractMetaClass *d_class);
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
159 void writeConversionFunction(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
160
1
e78566595089 initial import
mandel
parents:
diff changeset
161 // void writeMarshallFunction(QTextStream &s, const AbstractMetaClass *d_class);
e78566595089 initial import
mandel
parents:
diff changeset
162
e78566595089 initial import
mandel
parents:
diff changeset
163 int m_recursive;
e78566595089 initial import
mandel
parents:
diff changeset
164 bool m_isRecursive;
e78566595089 initial import
mandel
parents:
diff changeset
165 QSet<const TypeEntry*> typeEntries; // imports
e78566595089 initial import
mandel
parents:
diff changeset
166 QSet<const TypeEntry*> typeEntriesEnums; // imports for enums
e78566595089 initial import
mandel
parents:
diff changeset
167 QSet<QString> excludedTypes2;
e78566595089 initial import
mandel
parents:
diff changeset
168
e78566595089 initial import
mandel
parents:
diff changeset
169 protected:
e78566595089 initial import
mandel
parents:
diff changeset
170 void writeImportString(QTextStream &s, const TypeEntry* typeEntry);
e78566595089 initial import
mandel
parents:
diff changeset
171
e78566595089 initial import
mandel
parents:
diff changeset
172 QSet<QString> excludedTypes;
e78566595089 initial import
mandel
parents:
diff changeset
173 QString m_package_name;
e78566595089 initial import
mandel
parents:
diff changeset
174 QString m_doc_directory;
e78566595089 initial import
mandel
parents:
diff changeset
175 DocParser *m_doc_parser;
e78566595089 initial import
mandel
parents:
diff changeset
176 bool m_docs_enabled;
e78566595089 initial import
mandel
parents:
diff changeset
177 bool m_native_jump_table;
e78566595089 initial import
mandel
parents:
diff changeset
178 QList<const AbstractMetaFunction *> m_nativepointer_functions;
e78566595089 initial import
mandel
parents:
diff changeset
179 QList<const AbstractMetaFunction *> m_resettable_object_functions;
e78566595089 initial import
mandel
parents:
diff changeset
180 QList<const AbstractMetaFunction *> m_reference_count_candidate_functions;
e78566595089 initial import
mandel
parents:
diff changeset
181 };
e78566595089 initial import
mandel
parents:
diff changeset
182
e78566595089 initial import
mandel
parents:
diff changeset
183 class ClassFromEntry : Generator
e78566595089 initial import
mandel
parents:
diff changeset
184 {
e78566595089 initial import
mandel
parents:
diff changeset
185 Q_OBJECT
e78566595089 initial import
mandel
parents:
diff changeset
186
e78566595089 initial import
mandel
parents:
diff changeset
187 private:
e78566595089 initial import
mandel
parents:
diff changeset
188 ClassFromEntry();
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
189 void buildHash();
1
e78566595089 initial import
mandel
parents:
diff changeset
190 QHash<const TypeEntry *, AbstractMetaClass *> classFromEntry;
e78566595089 initial import
mandel
parents:
diff changeset
191 static ClassFromEntry* m_instance;
e78566595089 initial import
mandel
parents:
diff changeset
192
e78566595089 initial import
mandel
parents:
diff changeset
193 public:
e78566595089 initial import
mandel
parents:
diff changeset
194 static AbstractMetaClass* get(const TypeEntry *te);
110
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
195 static void print(QTextStream &s);
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
196 static void construct(const AbstractMetaClassList &classes);
136c9ee83ee5 put conversion code in separate functions
eldar
parents: 105
diff changeset
197
1
e78566595089 initial import
mandel
parents:
diff changeset
198 };
e78566595089 initial import
mandel
parents:
diff changeset
199 #endif // DGENERATOR_H