1 /**************************************************************************
3 ** This file is part of Qt Creator
5 ** Copyright (c) 2011 Nokia Corporation and/or its subsidiary(-ies).
7 ** Contact: Nokia Corporation (info@qt.nokia.com)
10 ** GNU Lesser General Public License Usage
12 ** This file may be used under the terms of the GNU Lesser General Public
13 ** License version 2.1 as published by the Free Software Foundation and
14 ** appearing in the file LICENSE.LGPL included in the packaging of this file.
15 ** Please review the following information to ensure the GNU Lesser General
16 ** Public License version 2.1 requirements will be met:
17 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
19 ** In addition, as a special exception, Nokia gives you certain additional
20 ** rights. These rights are described in the Nokia Qt LGPL Exception
21 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
25 ** Alternatively, this file may be used in accordance with the terms and
26 ** conditions contained in a signed written agreement between you and Nokia.
28 ** If you have questions regarding the use of this file, please contact
29 ** Nokia at qt-info@nokia.com.
31 **************************************************************************/
33 #ifndef DEBUGGER_SCRIPTENGINE_H
34 #define DEBUGGER_SCRIPTENGINE_H
36 #include "debuggerengine.h"
38 #include <QtCore/QSharedPointer>
39 #include <QtCore/QScopedPointer>
40 #include <QtCore/QHash>
53 /* A debugger engine for a QScriptEngine implemented using a QScriptEngineAgent.
54 * listening on script events. The engine has a special execution model:
55 * The script is executed in the foreground, while the debugger runs in
56 * processEvents() triggered by QScriptEngine::setProcessEventsInterval().
57 * Stopping is emulated by manually calling processEvents() from the debugger engine. */
59 class ScriptEngine : public Debugger::DebuggerEngine
64 explicit ScriptEngine(const DebuggerStartParameters &startParameters);
65 virtual ~ScriptEngine();
68 // DebuggerEngine implementation
70 void executeStepOut();
75 bool setToolTipExpression(const QPoint &mousePos,
76 TextEditor::ITextEditor *editor, const DebuggerToolTipContext &);
80 void shutdownInferior();
81 void shutdownEngine();
83 void continueInferior();
84 void interruptInferior();
86 void executeRunToLine(const ContextData &data);
87 void executeRunToFunction(const QString &functionName);
88 void executeJumpToLine(const ContextData &data);
90 void activateFrame(int index);
91 void selectThread(int index);
93 bool acceptsBreakpoint(BreakpointId id) const;
94 void attemptBreakpointSynchronization();
96 void assignValueInDebugger(const WatchData *w,
97 const QString &expr, const QVariant &value);
98 void executeDebuggerCommand(const QString &command);
100 void loadSymbols(const QString &moduleName);
101 void loadAllSymbols();
102 void requestModuleSymbols(const QString &moduleName);
103 void reloadModules();
104 void reloadRegisters() {}
105 void reloadSourceFiles() {}
106 void reloadFullStack() {}
108 bool supportsThreads() const { return true; }
109 bool checkForBreakCondition(bool byFunction);
110 void updateWatchData(const WatchData &data, const WatchUpdateFlags &flags);
112 void updateSubItem(const WatchData &data);
115 friend class ScriptAgent;
117 void importExtensions();
119 QSharedPointer<QScriptEngine> m_scriptEngine;
120 QString m_scriptContents;
121 QString m_scriptFileName;
122 QScopedPointer<ScriptAgent> m_scriptAgent;
123 QHash<quint64,QScriptValue> m_watchIdToScriptValue;
124 quint64 m_watchIdCounter;
127 bool m_stopOnNextLine;
130 } // namespace Internal
131 } // namespace Debugger
133 #endif // DEBUGGER_SCRIPTENGINE_H