sockets cpp

مآخذ CPP

مكتبة رأس فقط مع فصول المقبس:

• TcpClient - فئة قالب لمقبس عميل TCP
• TcpServer - فئة القالب لخادم TCP يدعم اتصالات العميل المتعددة
• UdpSocket - فئة القالب لعملية البث المتعدد/UNISAST UDP

التبعيات

• الاعتماد الاختياري على fmt لتنسيق سلسلة الأخطاء
• C ++ 14 أو أحدث
• cmake
• GTest و Gmock لاختبارات الوحدة. تمكين اختبارات الوحدة من خلال تحديد -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

يتم تمثيل فئة 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 ();

عينة من تطبيقات المقبس باستخدام هذه الفئات:

تمكين بناء تطبيقات عينة من خلال تحديد -DBUILD_EXAMPLES=ON عند تشغيل CMake .

عميل TCP

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

خادم TCP

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

UDP البث المتعدد

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

UDP Unicast

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