summaryrefslogtreecommitdiffstats
path: root/src/uscxml/debug/Debugger.h
blob: d69e6f600afef147f51db57d5d843a0b565ecdce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
/**
 *  @file
 *  @author     2012-2014 Stefan Radomski (stefan.radomski@cs.tu-darmstadt.de)
 *  @copyright  Simplified BSD
 *
 *  @cond
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the FreeBSD license as published by the FreeBSD
 *  project.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 *
 *  You should have received a copy of the FreeBSD license along with this
 *  program. If not, see <http://www.opensource.org/licenses/bsd-license>.
 *  @endcond
 */

#ifndef DEBUGGERMONITOR_H_Z050WPFH
#define DEBUGGERMONITOR_H_Z050WPFH

#include "uscxml/messages/Data.h"       // for Data
#include "uscxml/messages/Event.h"      // for Event
#include "uscxml/interpreter/InterpreterImpl.h"
#include "uscxml/debug/Breakpoint.h"

namespace uscxml {

class DebugSession;

class USCXML_API Debugger : public InterpreterMonitor {
public:
	Debugger() {
	}
	virtual ~Debugger() {}

	virtual void attachSession(InterpreterImpl* impl, std::shared_ptr<DebugSession> session) {
		std::lock_guard<std::recursive_mutex> lock(_sessionMutex);
		_sessionForInterpreter[impl] = session;
	}

	virtual void detachSession(InterpreterImpl* impl) {
		std::lock_guard<std::recursive_mutex> lock(_sessionMutex);
		_sessionForInterpreter.erase(impl);
	}

	virtual std::shared_ptr<DebugSession> getSession(InterpreterImpl* impl) {
		std::lock_guard<std::recursive_mutex> lock(_sessionMutex);
		if (_sessionForInterpreter.find(impl) != _sessionForInterpreter.end())
			return _sessionForInterpreter[impl];
		return std::shared_ptr<DebugSession>();
	}

	virtual void pushData(std::shared_ptr<DebugSession> session, Data pushData) = 0;

	// InterpreterMonitor
	virtual void beforeProcessingEvent(Interpreter& interpreter, const Event& event);
	virtual void beforeMicroStep(Interpreter& interpreter);
	virtual void beforeExitingState(Interpreter& interpreter, const XERCESC_NS::DOMElement* state);
	virtual void afterExitingState(Interpreter& interpreter, const XERCESC_NS::DOMElement* state);
	virtual void beforeExecutingContent(Interpreter& interpreter, const XERCESC_NS::DOMElement* execContent);
	virtual void afterExecutingContent(Interpreter& interpreter, const XERCESC_NS::DOMElement* execContent);
	virtual void beforeUninvoking(Interpreter& interpreter, const XERCESC_NS::DOMElement* invokeElem, const std::string& invokeid);
	virtual void afterUninvoking(Interpreter& interpreter, const XERCESC_NS::DOMElement* invokeElem, const std::string& invokeid);
	virtual void beforeTakingTransition(Interpreter& interpreter, const XERCESC_NS::DOMElement* transition);
	virtual void afterTakingTransition(Interpreter& interpreter, const XERCESC_NS::DOMElement* transition);
	virtual void beforeEnteringState(Interpreter& interpreter, const XERCESC_NS::DOMElement* state);
	virtual void afterEnteringState(Interpreter& interpreter, const XERCESC_NS::DOMElement* state);
	virtual void beforeInvoking(Interpreter& interpreter, const XERCESC_NS::DOMElement* invokeElem, const std::string& invokeid);
	virtual void afterInvoking(Interpreter& interpreter, const XERCESC_NS::DOMElement* invokeElem, const std::string& invokeid);
	virtual void afterMicroStep(Interpreter& interpreter);
	virtual void onStableConfiguration(Interpreter& interpreter);
	virtual void beforeCompletion(Interpreter& interpreter);
	virtual void afterCompletion(Interpreter& interpreter);

protected:

	void handleTransition(Interpreter& interpreter,
	                      const XERCESC_NS::DOMElement* transition,
	                      Breakpoint::When when);
	void handleState(Interpreter& interpreter,
	                 const XERCESC_NS::DOMElement* state,
	                 Breakpoint::When when,
	                 Breakpoint::Action action);
	void handleInvoke(Interpreter& interpreter,
	                  const XERCESC_NS::DOMElement* invokeElem,
	                  const std::string& invokeId,
	                  Breakpoint::When when,
	                  Breakpoint::Action action);
	void handleExecutable(Interpreter& interpreter,
	                      const XERCESC_NS::DOMElement* execContentElem,
	                      Breakpoint::When when);
	void handleStable(Interpreter& interpreter, Breakpoint::When when);
	void handleMicrostep(Interpreter& interpreter, Breakpoint::When when);
	void handleEvent(Interpreter& interpreter, const Event& event, Breakpoint::When when);

	std::list<Breakpoint> getQualifiedTransBreakpoints(InterpreterImpl* impl,
	        const XERCESC_NS::DOMElement* transition,
	        Breakpoint breakpointTemplate);
	std::list<Breakpoint> getQualifiedStateBreakpoints(InterpreterImpl* impl,
	        const XERCESC_NS::DOMElement* state,
	        Breakpoint breakpointTemplate);
	std::list<Breakpoint> getQualifiedInvokeBreakpoints(InterpreterImpl* impl,
	        const XERCESC_NS::DOMElement* invokeElem,
	        const std::string invokeId,
	        Breakpoint breakpointTemplate);

	std::recursive_mutex _sessionMutex;
	/// @todo: We ought to change form InterpreterImpl to Interpreter everywhere
	std::map<InterpreterImpl*, std::shared_ptr<DebugSession> > _sessionForInterpreter;
};

}


#endif /* end of include guard: DEBUGGERMONITOR_H_Z050WPFH */