blob: db51d04c8dfd4275c0df5429fe38012ff6389796 (
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
|
#pragma once
#include <functional>
#include <string>
#include "Event.h"
namespace crepe {
/**
* \brief A type alias for an event handler function.
*
* The EventHandler is a std::function that takes an EventType reference and returns a boolean value
* indicating whether the event is handled.
*
* \tparam EventType The type of event this handler will handle.
*/
template <typename EventType>
using EventHandler = std::function<bool(const EventType & e)>;
/**
* \class IEventHandlerWrapper
* \brief An abstract base class for event handler wrappers.
*
* This class provides the interface for handling events. Derived classes must implement the
* `call()` method to process events and the `get_type()` method to return the handler's type.
*/
class IEventHandlerWrapper {
public:
/**
* \brief Virtual destructor for IEventHandlerWrapper.
*/
virtual ~IEventHandlerWrapper() = default;
/**
* \brief Executes the handler with the given event.
*
* This method calls the `call()` method of the derived class, passing the event to the handler.
*
* \param e The event to be processed.
* \return A boolean value indicating whether the event is handled.
*/
bool exec(const Event & e);
/**
* \brief Get the type of the event handler.
*
* This method returns the type of the event handler as a string.
*
* \return A string representing the handler's type.
*/
virtual std::string get_type() const = 0;
private:
/**
* \brief The method responsible for handling the event.
*
* This method is implemented by derived classes to process the event.
*
* \param e The event to be processed.
* \return A boolean value indicating whether the event is handled.
*/
virtual bool call(const Event & e) = 0;
};
/**
* \class EventHandlerWrapper
* \brief A wrapper for event handler functions.
*
* This class wraps an event handler function of a specific event type. It implements the
* `call()` and `get_type()` methods to allow the handler to be executed and its type to be
* queried.
*
* \tparam EventType The type of event this handler will handle.
*/
template <typename EventType>
class EventHandlerWrapper : public IEventHandlerWrapper {
public:
/**
* \brief Constructs an EventHandlerWrapper with a given handler.
*
* The constructor takes an event handler function and stores it in the wrapper.
*
* \param handler The event handler function.
*/
explicit EventHandlerWrapper(const EventHandler<EventType> & handler);
private:
/**
* \brief Calls the stored event handler with the event.
*
* This method casts the event to the appropriate type and calls the handler.
*
* \param e The event to be handled.
* \return A boolean value indicating whether the event is handled.
*/
bool call(const Event & e) override;
/**
* \brief Returns the type of the handler.
*
* This method returns a string representing the type of the event handler.
*
* \return The handler type as a string.
*/
std::string get_type() const override;
//! The event handler function.
EventHandler<EventType> m_handler;
//! The type name of the handler function.
const std::string m_handler_type;
};
} // namespace crepe
#include "EventHandler.hpp"
|