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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
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
168
169
170
171
|
Salticidae: a Minimal C++ asynchronous network library.
=======================================================
.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
:target: https://opensource.org/licenses/MIT
Features
--------
- Simplicity. The library is self-contained, small in code base, and only
relies on libevent and libcrypo (OpenSSL, for SHA256 purpose).
- Clarity. With moderate use of C++ template and new features, the vast
majority of the code is self-documented.
- Layered design. You can use network abstraction from the lowest socket
connection level to the highest P2P network level.
- Performance. The implementation strives to incur very little in processing
network I/O, and avoid unnecessary memory copies thanks to the move semantics.
- Utilities. The libray also provies with some useful gadgets, such as command
line parser, libevent abstraction, etc.
Dependencies
------------
- CMake >= 3.9
- C++14
- libevent
- libcrypto
Example
-------
.. code-block:: cpp
#include <cstdio>
#include <string>
#include "salticidae/msg.h"
#include "salticidae/event.h"
#include "salticidae/network.h"
#include "salticidae/stream.h"
using salticidae::NetAddr;
using salticidae::DataStream;
using salticidae::MsgNetwork;
using salticidae::htole;
using salticidae::letoh;
using opcode_t = uint8_t;
/** Hello Message. */
struct MsgHello {
static const opcode_t opcode = 0x0;
DataStream serialized;
std::string name;
std::string text;
/** Defines how to serialize the msg. */
MsgHello(const std::string &name,
const std::string &text) {
serialized << htole((uint32_t)name.length());
serialized << name << text;
}
/** Defines how to parse the msg. */
MsgHello(DataStream &&s) {
uint32_t len;
s >> len;
len = letoh(len);
name = std::string((const char *)s.get_data_inplace(len), len);
len = s.size();
text = std::string((const char *)s.get_data_inplace(len), len);
}
};
/** Acknowledgement Message. */
struct MsgAck {
static const opcode_t opcode = 0x1;
DataStream serialized;
MsgAck() {}
MsgAck(DataStream &&s) {}
};
using MsgNetworkByteOp = MsgNetwork<opcode_t>;
struct MyNet: public MsgNetworkByteOp {
const std::string name;
const NetAddr peer;
MyNet(const salticidae::EventContext &ec,
const std::string name,
const NetAddr &peer):
MsgNetwork<opcode_t>(ec, 10, 1.0, 4096),
name(name),
peer(peer) {}
struct Conn: public MsgNetworkByteOp::Conn {
MyNet *get_net() { return static_cast<MyNet *>(get_pool()); }
salticidae::RcObj<Conn> self() {
return salticidae::static_pointer_cast<Conn>(
MsgNetworkByteOp::Conn::self());
}
void on_setup() override {
auto net = get_net();
if (get_mode() == ACTIVE)
{
printf("[%s] Connected, sending hello.\n",
net->name.c_str());
/* send the first message through this connection */
net->send_msg(MsgHello(net->name, "Hello there!"), self());
}
else
printf("[%s] Passively connected, waiting for greetings.\n",
net->name.c_str());
}
void on_teardown() override {
auto net = get_net();
printf("[%s] Disconnected, retrying.\n", net->name.c_str());
/* try to reconnect to the same address */
net->connect(get_addr());
}
};
using conn_t = salticidae::RcObj<Conn>;
salticidae::ConnPool::Conn *create_conn() override {
return new Conn();
}
};
void on_receive_hello(MsgHello &&msg, MyNet::conn_t conn) {
auto net = conn->get_net();
printf("[%s] %s says %s\n",
net->name.c_str(),
msg.name.c_str(), msg.text.c_str());
/* send acknowledgement */
net->send_msg(MsgAck(), conn);
}
void on_receive_ack(MsgAck &&msg, MyNet::conn_t conn) {
auto net = conn->get_net();
printf("[%s] the peer knows\n", net->name.c_str());
}
salticidae::EventContext ec;
NetAddr alice_addr("127.0.0.1:1234");
NetAddr bob_addr("127.0.0.1:1235");
int main() {
/* test two nodes */
MyNet alice(ec, "Alice", bob_addr);
MyNet bob(ec, "Bob", alice_addr);
/* register the message handler */
alice.reg_handler(on_receive_hello);
alice.reg_handler(on_receive_ack);
bob.reg_handler(on_receive_hello);
bob.reg_handler(on_receive_ack);
alice.listen(alice_addr);
bob.listen(bob_addr);
/* first attempt */
alice.connect(bob_addr);
bob.connect(alice_addr);
ec.dispatch();
return 0;
}
|