annotate generator/dgenerator.h @ 110:136c9ee83ee5

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