sockets cpp
1.0.0
一个唯一的库库,带有插座类:
TcpClient TCP客户端套接字的模板类TcpServer支持多个客户端连接的TCP服务器的模板类UdpSocket UDP Multicast/Unicast的模板类fmt的可选依赖性-DBUILD_TESTS=ON运行CMake时启用单元测试 struct SocketOpt {
/* *
* @brief Value passed to setsockopt(SO_SNDBUF)
*
*/
int m_txBufSize = TX_BUFFER_SIZE;
/* *
* @brief Value passed to setsockopt(SO_RCVBUF)
*
*/
int m_rxBufSize = RX_BUFFER_SIZE;
/* *
* @brief Socket listen address
*
*/
std::string m_listenAddr = " 0.0.0.0 " ;
};UDPSocket类在“回调”类中模板,该类通过UDP接收数据。
模板参数类型必须支持以下接口:
void onReceiveData ( const char *data, size_t size) ;UDPSocket类具有以下用于管理UDP套接字的接口:
// Constructor
UdpSocket (CallbackImpl &callback, SocketOpt *options = nullptr );
// Start a multicast socket
SocketRet startMcast ( const char *mcastAddr, uint16_t port);
// Start a unicast client/server socket
SocketRet startUnicast ( const char *remoteAddr, uint16_t localPort, uint16_t port)
// Start a unicast server-only socket
SocketRet startUnicast( uint16_t localPort);
// Send data via UDP
SocketRet sendMsg ( const char *msg, size_t size);
// Shutdown the UDP socket
void finish ();TCPCLIENT类在“回调”类中模板,该类通过TCP接收数据。
模板参数类型必须支持以下接口:
void onReceiveData ( const char *data, size_t size);
void onDisconnect ( const sockets::SocketRet &ret);TCPCLIENT类具有以下用于管理TCP客户端连接的接口:
// Constructor
TcpClient (CallbackImpl &callback, SocketOpt *options = nullptr );
// Connect to a TCP server
SocketRet connectTo ( const char *remoteIp, uint16_t remotePort);
// Send data to the TCP server
SocketRet sendMsg ( const char *msg, size_t size);
// Shutdown the TCP client socket
void finish ();在管理TCP服务器的“回调”类上,将TCPSERVER类模板模板。
模板参数必须支持以下接口:
void onClientConnect ( const sockets::ClientHandle &client);
void onReceiveClientData ( const sockets::ClientHandle &client, const char *data, size_t size);
void onClientDisconnect ( const sockets::ClientHandle &client, const sockets::SocketRet &ret);TCPSERVER类具有以下接口:
// Create a TCP server socket
TcpServer (CallbackImpl &callback, SocketOpt *options = nullptr );
// Start the server listening on the specified port
SocketRet start ( uint16_t port);
// Send a message to all connected clients
SocketRet sendBcast ( const char *msg, size_t size);
// Send a message to a specific client connection
SocketRet sendClientMessage (ClientHandle &clientId, const char *msg, size_t size);
// Shutdown the TCP server socket
void finish ();通过指定-DBUILD_EXAMPLES=ON在运行CMake时启用构建示例应用程序。
$ ./clientApp -a < ipAddr > -p < port > $ ./serverApp -p < port > -L < listenAddr > $ ./mcastApp -m < multicastAddr > -p < port > $ ./unicastApp -a < ipAddr > -l < localPort > -p < remotePort > -L < listenAddr >