sockets cpp

Sockets-Cpp

ソケットクラスを備えたヘッダーのみのライブラリ：

• TcpClient -TCPクライアントソケットのテンプレートクラス
• TcpServer複数のクライアント接続をサポートするTCPサーバーのテンプレートクラス
• UdpSocket UDPマルチキャスト/ユニキャスト用のテンプレートクラス

依存関係

• エラー文字列フォーマットのfmtへのオプションの依存関係
• C ++ 14以降
• cmake
• 単体テストのGTESTとGMOCK。 CMakeを実行するときに-DBUILD_TESTS=ONを指定して、単体テストを有効にします

ソケットオプション

 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

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

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

tcpserver

TCPServerクラスは、TCPサーバーを管理する「コールバック」クラスにテンプレートされています。

テンプレート引数は、次のインターフェイスをサポートする必要があります。

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

これらのクラスを使用したサンプルソケットアプリ：

CMakeを実行するときに-DBUILD_EXAMPLES=ON指定して、サンプルアプリの構築を有効にします。

TCPクライアント

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

TCPサーバー

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

UDPマルチキャスト

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

UDPユニキャスト

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