cppmodelmanager.h 11.2 KB
Newer Older
hjk's avatar
hjk committed
1
/****************************************************************************
con's avatar
con committed
2
**
3
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
hjk's avatar
hjk committed
4
** Contact: http://www.qt-project.org/legal
con's avatar
con committed
5
**
hjk's avatar
hjk committed
6
** This file is part of Qt Creator.
con's avatar
con committed
7
**
hjk's avatar
hjk committed
8 9 10 11 12 13 14
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
15
**
16
** GNU Lesser General Public License Usage
hjk's avatar
hjk committed
17 18 19 20 21 22 23 24 25
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Digia gives you certain additional
** rights.  These rights are described in the Digia Qt LGPL Exception
con's avatar
con committed
26 27
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
hjk's avatar
hjk committed
28
****************************************************************************/
hjk's avatar
hjk committed
29

con's avatar
con committed
30 31 32
#ifndef CPPMODELMANAGER_H
#define CPPMODELMANAGER_H

33
#include "cpptools_global.h"
34
#include "cpptoolsconstants.h"
35
#include "ModelManagerInterface.h"
36

37
#include <projectexplorer/project.h>
38 39
#include <texteditor/basetexteditor.h>

con's avatar
con committed
40
#include <cplusplus/CppDocument.h>
41 42 43
#include <cplusplus/PreprocessorClient.h>
#include <cplusplus/PreprocessorEnvironment.h>
#include <cplusplus/pp-engine.h>
44 45 46 47 48 49 50

#include <QHash>
#include <QFutureInterface>
#include <QFutureSynchronizer>
#include <QMutex>
#include <QTimer>
#include <QTextEdit> // for QTextEdit::ExtraSelection
con's avatar
con committed
51 52 53 54 55 56 57

namespace Core {
class IEditor;
}

namespace TextEditor {
class ITextEditor;
58
class BaseTextEditorWidget;
con's avatar
con committed
59 60 61 62 63 64
}

namespace ProjectExplorer {
class ProjectExplorerPlugin;
}

65 66 67 68
namespace CPlusPlus {
    class ParseManager;
}

con's avatar
con committed
69
namespace CppTools {
70

71 72 73
class CppCompletionSupportFactory;
class CppHighlightingSupportFactory;

con's avatar
con committed
74 75 76
namespace Internal {

class CppEditorSupport;
77
class CppPreprocessor;
Roberto Raggi's avatar
Roberto Raggi committed
78
class CppFindReferences;
con's avatar
con committed
79

80
class CPPTOOLS_EXPORT CppModelManager : public CPlusPlus::CppModelManagerInterface
con's avatar
con committed
81 82 83
{
    Q_OBJECT

84 85 86
public:
    typedef CPlusPlus::Document Document;

con's avatar
con committed
87
public:
88
    CppModelManager(QObject *parent = 0);
con's avatar
con committed
89 90
    virtual ~CppModelManager();

91 92
    static CppModelManager *instance();

dt's avatar
dt committed
93
    virtual QFuture<void> updateSourceFiles(const QStringList &sourceFiles);
94
    virtual WorkingCopy workingCopy() const;
95 96 97 98

    virtual QList<ProjectInfo> projectInfos() const;
    virtual ProjectInfo projectInfo(ProjectExplorer::Project *project) const;
    virtual void updateProjectInfo(const ProjectInfo &pinfo);
99
    virtual QList<CPlusPlus::ProjectPart::Ptr> projectPart(const QString &fileName) const;
100

101
    virtual CPlusPlus::Snapshot snapshot() const;
102 103
    virtual Document::Ptr document(const QString &fileName) const;
    bool replaceDocument(Document::Ptr newDoc);
con's avatar
con committed
104 105
    virtual void GC();

106
    virtual bool isCppEditor(Core::IEditor *editor) const;
con's avatar
con committed
107

Roberto Raggi's avatar
Roberto Raggi committed
108 109 110
    CppEditorSupport *editorSupport(TextEditor::ITextEditor *editor) const
    { return m_editorSupport.value(editor); }

con's avatar
con committed
111 112
    void emitDocumentUpdated(CPlusPlus::Document::Ptr doc);

Roberto Raggi's avatar
Roberto Raggi committed
113 114 115
    void stopEditorSelectionsUpdate()
    { m_updateEditorSelectionsTimer->stop(); }

116 117 118
    virtual void addEditorSupport(AbstractEditorSupport *editorSupport);
    virtual void removeEditorSupport(AbstractEditorSupport *editorSupport);

119
    virtual QList<int> references(CPlusPlus::Symbol *symbol, const CPlusPlus::LookupContext &context);
120

121 122
    virtual void renameUsages(CPlusPlus::Symbol *symbol, const CPlusPlus::LookupContext &context,
                              const QString &replacement = QString());
123
    virtual void findUsages(CPlusPlus::Symbol *symbol, const CPlusPlus::LookupContext &context);
Roberto Raggi's avatar
Roberto Raggi committed
124

Christian Kamm's avatar
Christian Kamm committed
125
    virtual void findMacroUsages(const CPlusPlus::Macro &macro);
126
    virtual void renameMacroUsages(const CPlusPlus::Macro &macro, const QString &replacement);
Christian Kamm's avatar
Christian Kamm committed
127

128
    virtual void setExtraDiagnostics(const QString &fileName, int key,
129 130
                                     const QList<Document::DiagnosticMessage> &diagnostics);
    virtual QList<Document::DiagnosticMessage> extraDiagnostics(
131 132
            const QString &fileName, int key = AllExtraDiagnostics) const;

133 134
    void finishedRefreshingSourceFiles(const QStringList &files);

135
    virtual CppCompletionSupport *completionSupport(Core::IEditor *editor) const;
136
    virtual void setCppCompletionAssistProvider(CppCompletionAssistProvider *completionAssistProvider);
137

138
    virtual CppHighlightingSupport *highlightingSupport(Core::IEditor *editor) const;
139
    virtual void setHighlightingSupportFactory(CppHighlightingSupportFactory *highlightingFactory);
140

141 142
    virtual void setIndexingSupport(CppIndexingSupport *indexingSupport);
    virtual CppIndexingSupport *indexingSupport();
143

144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167
    QStringList projectFiles()
    {
        ensureUpdated();
        return m_projectFiles;
    }

    QStringList includePaths()
    {
        ensureUpdated();
        return m_includePaths;
    }

    QStringList frameworkPaths()
    {
        ensureUpdated();
        return m_frameworkPaths;
    }

    QByteArray definedMacros()
    {
        ensureUpdated();
        return m_definedMacros;
    }

168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188
Q_SIGNALS:
    void projectPathChanged(const QString &projectPath);

    void aboutToRemoveFiles(const QStringList &files);

public Q_SLOTS:
    void editorOpened(Core::IEditor *editor);
    void editorAboutToClose(Core::IEditor *editor);
    virtual void updateModifiedSourceFiles();

private Q_SLOTS:
    // this should be executed in the GUI thread.
    void onDocumentUpdated(CPlusPlus::Document::Ptr doc);
    void onExtraDiagnosticsUpdated(const QString &fileName);
    void onAboutToRemoveProject(ProjectExplorer::Project *project);
    void onAboutToUnloadSession();
    void onProjectAdded(ProjectExplorer::Project *project);
    void postEditorUpdate();
    void updateEditorSelections();

private:
189
    void updateEditor(Document::Ptr doc);
190

191
    void replaceSnapshot(const CPlusPlus::Snapshot &newSnapshot);
192 193
    WorkingCopy buildWorkingCopyList();

194
    void ensureUpdated();
195 196 197 198
    QStringList internalProjectFiles() const;
    QStringList internalIncludePaths() const;
    QStringList internalFrameworkPaths() const;
    QByteArray internalDefinedMacros() const;
199

200 201
    void dumpModelManagerConfiguration();

202 203 204 205
private:
    static QMutex m_modelManagerMutex;
    static CppModelManager *m_modelManagerInstance;

con's avatar
con committed
206
private:
207
    CPlusPlus::Snapshot m_snapshot;
con's avatar
con committed
208

209 210
    // cache
    bool m_dirty;
con's avatar
con committed
211
    QStringList m_projectFiles;
212 213 214
    QStringList m_includePaths;
    QStringList m_frameworkPaths;
    QByteArray m_definedMacros;
con's avatar
con committed
215 216 217 218

    // editor integration
    QMap<TextEditor::ITextEditor *, CppEditorSupport *> m_editorSupport;

219 220
    QSet<AbstractEditorSupport *> m_addtionalEditorSupport;

con's avatar
con committed
221 222 223
    // project integration
    QMap<ProjectExplorer::Project *, ProjectInfo> m_projects;

224 225
    mutable QMutex m_mutex;
    mutable QMutex m_protectSnapshot;
226

Roberto Raggi's avatar
Roberto Raggi committed
227
    struct Editor {
228
        Editor()
229 230 231
            : revision(-1)
            , updateSelections(true)
        {}
232
        int revision;
233
        bool updateSelections;
234
        QPointer<TextEditor::ITextEditor> textEditor;
Roberto Raggi's avatar
Roberto Raggi committed
235
        QList<QTextEdit::ExtraSelection> selections;
236
        QList<TextEditor::BaseTextEditorWidget::BlockRange> ifdefedOutBlocks;
Roberto Raggi's avatar
Roberto Raggi committed
237 238 239 240 241
    };

    QList<Editor> m_todo;

    QTimer *m_updateEditorSelectionsTimer;
Roberto Raggi's avatar
Roberto Raggi committed
242

Roberto Raggi's avatar
Roberto Raggi committed
243
    CppFindReferences *m_findReferences;
244
    bool m_indexerEnabled;
245

246 247
    mutable QMutex m_protectExtraDiagnostics;
    QHash<QString, QHash<int, QList<Document::DiagnosticMessage> > > m_extraDiagnostics;
248

249
    QMap<QString, QList<CPlusPlus::ProjectPart::Ptr> > m_srcToProjectPart;
250

251 252
    CppCompletionAssistProvider *m_completionAssistProvider;
    CppCompletionAssistProvider *m_completionFallback;
253 254
    CppHighlightingSupportFactory *m_highlightingFactory;
    CppHighlightingSupportFactory *m_highlightingFallback;
255
    CppIndexingSupport *m_indexingSupporter;
256
    CppIndexingSupport *m_internalIndexingSupport;
con's avatar
con committed
257
};
258

259
class CPPTOOLS_EXPORT CppPreprocessor: public CPlusPlus::Client
260
{
261 262
    Q_DISABLE_COPY(CppPreprocessor)

263
public:
264
    CppPreprocessor(QPointer<CppModelManager> modelManager, bool dumpFileNameWhileParsing = false);
265 266 267
    virtual ~CppPreprocessor();

    void setRevision(unsigned revision);
268
    void setWorkingCopy(const CPlusPlus::CppModelManagerInterface::WorkingCopy &workingCopy);
269 270
    void setIncludePaths(const QStringList &includePaths);
    void setFrameworkPaths(const QStringList &frameworkPaths);
271
    void addFrameworkPath(const QString &frameworkPath);
272 273 274 275
    void setProjectFiles(const QStringList &files);
    void setTodo(const QStringList &files);

    void run(const QString &fileName);
276
    void removeFromCache(const QString &fileName);
277 278

    void resetEnvironment();
279
    static QString cleanPath(const QString &path);
280 281 282 283

    const QSet<QString> &todo() const
    { return m_todo; }

284 285 286
    CppModelManager *modelManager() const
    { return m_modelManager.data(); }

287 288 289 290 291
protected:
    CPlusPlus::Document::Ptr switchDocument(CPlusPlus::Document::Ptr doc);

    bool includeFile(const QString &absoluteFilePath, QString *result, unsigned *revision);
    QString tryIncludeFile(QString &fileName, IncludeType type, unsigned *revision);
Roberto Raggi's avatar
Roberto Raggi committed
292
    QString tryIncludeFile_helper(QString &fileName, IncludeType type, unsigned *revision);
293 294 295

    void mergeEnvironment(CPlusPlus::Document::Ptr doc);

296
    virtual void macroAdded(const CPlusPlus::Macro &macro);
297 298
    virtual void passedMacroDefinitionCheck(unsigned offset, unsigned line,
                                            const CPlusPlus::Macro &macro);
299
    virtual void failedMacroDefinitionCheck(unsigned offset, const CPlusPlus::ByteArrayRef &name);
300 301
    virtual void notifyMacroReference(unsigned offset, unsigned line,
                                      const CPlusPlus::Macro &macro);
302
    virtual void startExpandingMacro(unsigned offset,
303
                                     unsigned line,
304 305 306
                                     const CPlusPlus::Macro &macro,
                                     const QVector<CPlusPlus::MacroArgumentReference> &actuals);
    virtual void stopExpandingMacro(unsigned offset, const CPlusPlus::Macro &macro);
307
    virtual void markAsIncludeGuard(const QByteArray &macroName);
308 309
    virtual void startSkippingBlocks(unsigned offset);
    virtual void stopSkippingBlocks(unsigned offset);
310
    virtual void sourceNeeded(unsigned line, QString &fileName, IncludeType type);
311 312

private:
313
    CPlusPlus::Snapshot m_snapshot;
314
    QPointer<CppModelManager> m_modelManager;
315
    bool m_dumpFileNameWhileParsing;
316 317
    CPlusPlus::Environment m_env;
    CPlusPlus::Preprocessor m_preprocess;
318
    QStringList m_includePaths;
319
    CPlusPlus::CppModelManagerInterface::WorkingCopy m_workingCopy;
320 321
    QStringList m_frameworkPaths;
    QSet<QString> m_included;
322
    CPlusPlus::Document::Ptr m_currentDoc;
323 324 325
    QSet<QString> m_todo;
    QSet<QString> m_processed;
    unsigned m_revision;
Roberto Raggi's avatar
Roberto Raggi committed
326
    QHash<QString, QString> m_fileNameCache;
327
};
con's avatar
con committed
328 329 330 331 332

} // namespace Internal
} // namespace CppTools

#endif // CPPMODELMANAGER_H