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
118
119
120
121
122
123
124
125
126
|
// Copyright (C) by Josh Blum. See LICENSE.txt for licensing information.
#ifndef INCLUDED_GRAS_CALLABLE_HPP
#define INCLUDED_GRAS_CALLABLE_HPP
#include <gras/gras.hpp>
#include <PMC/PMC.hpp>
#include <boost/shared_ptr.hpp>
#include <vector>
#include <string>
namespace gras
{
/*!
* The callable interface allows subclasses to export public methods,
* but without actually exporting traditional library symbols.
*
* Callable handles the template magic so you don't have to:
* - registering subclass methods is simple and easy on the user.
* - users call registered methods with natural code aesthetics.
*
* Register a method (in the constructor of MyClass):
* this->register_call("set_foo", &MyClass::set_foo);
*
* Call a method on a instance of MyClass:
* my_class->x("set_foo", new_foo_val);
*
* Why x for the call method?
* - The "x" is short, one character of screen width.
* - The "x" looks like "*", which is commonly used.
* - The overloaded () operator sucks with pointers.
* - The overloaded () operator has template issues.
*/
class GRAS_API Callable
{
public:
//! Default constructor
Callable(void);
//! Destructor (virtual for subclasses)
virtual ~Callable(void);
//! Get a list of keys for registered calls
std::vector<std::string> get_registered_keys(void) const;
protected:
/*!
* Unregister a previously registered call.
* Throws if the key is not found in the registry.
*/
void unregister_call(const std::string &key);
/*******************************************************************
* Register API - don't look here, template magic, not helpful
******************************************************************/
protected:
template <typename ClassType, typename ReturnType>
void register_call(const std::string &key, ReturnType(ClassType::*fcn)(void));
template <typename ClassType>
void register_call(const std::string &key, void(ClassType::*fcn)(void));
template <typename ClassType, typename ReturnType, typename Arg0>
void register_call(const std::string &key, ReturnType(ClassType::*fcn)(const Arg0 &));
template <typename ClassType, typename Arg0>
void register_call(const std::string &key, void(ClassType::*fcn)(const Arg0 &));
template <typename ClassType, typename ReturnType, typename Arg0, typename Arg1>
void register_call(const std::string &key, ReturnType(ClassType::*fcn)(const Arg0 &, const Arg1 &));
template <typename ClassType, typename Arg0, typename Arg1>
void register_call(const std::string &key, void(ClassType::*fcn)(const Arg0 &, const Arg1 &));
template <typename ClassType, typename ReturnType, typename Arg0, typename Arg1, typename Arg2>
void register_call(const std::string &key, ReturnType(ClassType::*fcn)(const Arg0 &, const Arg1 &, const Arg2 &));
template <typename ClassType, typename Arg0, typename Arg1, typename Arg2>
void register_call(const std::string &key, void(ClassType::*fcn)(const Arg0 &, const Arg1 &, const Arg2 &));
/*******************************************************************
* Call API - don't look here, template magic, not helpful
******************************************************************/
public:
template <typename ReturnType>
ReturnType x(const std::string &key);
inline
void x(const std::string &key);
template <typename ReturnType, typename Arg0>
ReturnType x(const std::string &key, const Arg0 &);
template <typename Arg0>
void x(const std::string &key, const Arg0 &);
template <typename ReturnType, typename Arg0, typename Arg1>
ReturnType x(const std::string &key, const Arg0 &, const Arg1 &);
template <typename Arg0, typename Arg1>
void x(const std::string &key, const Arg0 &, const Arg1 &);
template <typename ReturnType, typename Arg0, typename Arg1, typename Arg2>
ReturnType x(const std::string &key, const Arg0 &, const Arg1 &, const Arg2 &);
template <typename Arg0, typename Arg1, typename Arg2>
void x(const std::string &key, const Arg0 &, const Arg1 &, const Arg2 &);
/*******************************************************************
* Private registration hooks
******************************************************************/
protected:
void _register_call(const std::string &, void *);
public:
virtual PMCC _handle_call(const std::string &, const PMCC &);
private:
boost::shared_ptr<void> _call_registry;
};
} //namespace gras
#include <gras/detail/callable.hpp>
#endif /*INCLUDED_GRAS_CALLABLE_HPP*/
|
