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
|
/*
* JsonRpc-Cpp - JSON-RPC implementation.
* Copyright (C) 2008-2011 Sebastien Vincent <sebastien.vincent@cppextrem.com>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* 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. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
/**
* \file jsonrpc_tcpserver.h
* \brief JSON-RPC TCP server.
* \author Sebastien Vincent
*/
#ifndef JSONRPC_TCPSERVER_H
#define JSONRPC_TCPSERVER_H
#include <list>
#include "jsonrpc_common.h"
#include "jsonrpc_server.h"
namespace Json
{
namespace Rpc
{
/**
* \class TcpServer
* \brief JSON-RPC TCP server implementation.
*/
class TcpServer : public Server
{
public:
/**
* \brief Constructor.
* \param address network address or FQDN to bind
* \param port local port to bind
*/
TcpServer(const std::string& address, uint16_t port);
/**
* \brief Destructor.
*/
virtual ~TcpServer();
/**
* \brief Receive data from the network and process it.
* \param fd socket descriptor to receive data
* \return true if message has been correctly received, processed and
* response sent, false otherwise (mainly send/recv error)
* \note This method will blocked until data comes.
*/
virtual bool Recv(int fd);
/**
* \brief Send data.
* \param fd file descriptor of the client TCP socket
* \param data data to send
* \return number of bytes sent or -1 if error
*/
virtual ssize_t Send(int fd, const std::string& data);
/**
* \brief Wait message.
*
* This function do a select() on the socket and Process() immediately
* the JSON-RPC message.
* \param ms millisecond to wait (0 means infinite)
*/
virtual void WaitMessage(uint32_t ms);
/**
* \brief Put the TCP socket in LISTEN state.
*/
bool Listen() const;
/**
* \brief Accept a new client socket.
* \return -1 if error, 0 otherwise
*/
bool Accept();
/**
* \brief Close listen socket and all client sockets.
*/
void Close();
/**
* \brief Get the list of clients.
* \return list of clients
*/
const std::list<int> GetClients() const;
private:
/**
* \brief Copy constructor (private because of "resource" class).
* \param obj object to copy
*/
TcpServer(const TcpServer& obj);
/**
* \brief Operator copy assignment (private because of "resource"
* class).
* \param obj object to copy
* \return copied object reference
*/
TcpServer& operator=(const TcpServer& obj);
/**
* \brief List of client sockets.
*/
std::list<int> m_clients;
/**
* \brief List of disconnected sockets to be purged.
*/
std::list<int> m_purge;
};
} /* namespace Rpc */
} /* namespace Json */
#endif /* JSONRPC_TCPSERVER_H */
|
