sockets cpp

Sockets-CPP

Eine nur Header-Bibliothek mit Socket-Klassen:

• TcpClient - Vorlagenklasse für einen TCP -Client -Socket
• TcpServer - Vorlagenklasse für einen TCP -Server, der mehrere Client -Verbindungen unterstützt
• UdpSocket - Vorlagenklasse für einen UDP -Multicast/Unicast

Abhängigkeiten

• Optionale Abhängigkeit von fmt für die Formatierung von Fehlerzeichenfolge
• C ++ 14 oder höher
• Cmake
• GTEST und GMOCK für Unit -Tests. Aktivieren Sie Unit -Tests, indem Sie -DBUILD_TESTS=ON beim Ausführen CMake angeben

Sockeloptionen

 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

Die UDPSocket -Klasse ist in der "Rückruf" -Klasse vorgeschrieben, die Daten über UDP empfängt.

Der Template -Argument -Typ muss die folgende Schnittstelle unterstützen:

   void onReceiveData ( const char *data, size_t size) ;

Die UDPSocket -Klasse verfügt über die folgende Schnittstelle zum Verwalten der UDP -Socket:

 // 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

Die TCPClient -Klasse ist in der "Callback" -Klasse vorgeschrieben, die Daten über TCP empfängt.

Der Template -Argument -Typ muss die folgende Schnittstelle unterstützen:

    void onReceiveData ( const char *data, size_t size);

    void onDisconnect ( const sockets::SocketRet &ret);

Die TCPClient -Klasse verfügt über die folgende Schnittstelle zum Verwalten der TCP -Client -Verbindung:

 // 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 ();

TcpServer

Die TCPServer -Klasse ist in der "Rückruf -Klasse" -Klasse, die den TCP -Server verwaltet.

Das Vorlagenargument muss die folgende Schnittstelle unterstützen:

    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);

Die TCpServer -Klasse hat die folgenden Schnittstellen:

 // 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 ();

Beispiel Socket -Apps mit diesen Klassen:

Aktivieren Sie das Erstellen von Beispiel -Apps, indem Sie -DBUILD_EXAMPLES=ON beim Ausführen CMake angeben.

TCP -Client

$ ./clientApp -a < ipAddr > -p < port > 

TCP -Server

$ ./serverApp -p < port > -L < listenAddr > 

UDP Multicast

$ ./mcastApp -m < multicastAddr > -p < port > 

UDP Unicast

$ ./unicastApp -a < ipAddr > -l < localPort > -p < remotePort > -L < listenAddr >