UDP Node 组件

admin

项目主页 http://www.oschina.net/p/hp-socket 下载地址 https://github.com/ldcsaa/HP-Socket
37
⚫ 客户端应用程序调用 Send() 方法向服务端应用程序发出数据后，客户端应用程序
将收到 OnSend 事件。
⚫ 服务端应用程序向客户端应用程序发送数据时，客户端应用程序将收到 OnReceive
事件。
⚫ 断开连接时，客户端应用程序将收到 OnClose 事件。
⚫ 客户端应用程序调用 Stop() 方法关闭 Client 组件，如果调用成功则返回 TRUE 并
收到 OnClose 事件。
2.5 UDP Node 组件
2.5.1 接口描述
图 2.5.1-1 UDP Node 组件接口IUdpNode
+Start()
+Stop()
+Wait()
+Send()
+SendPACKets()
+SendCast()
+SendCastPackets()
+SetExtra()
+GetExtra()
+HasStarted()
+GetState()
+GetLastError()
+GetLastErrorDesc()
+GetLocalAddress()
+GetCastAddress()
+GetCastMode()
+GetPendingDataLength()
+SetMaxDatagramSize()
+GetMaxDatagramSize()
+SetMultiCastTtl()
+GetMultiCastTtl()
+SetMultiCastLoop()
+IsMultiCastLoop()
+SetReuseAddressPolicy()
+GetReuseAddressPolicy()
+SetWorkerThreadCount()
+GetWorkerThreadCount()
+SetPostReceiveCount()
+GetPostReceiveCount()
+SetFreeBufferPoolSize()
+GetFreeBufferPoolSize()
+SetFreeBufferPoolHold()
+GetFreeBufferPoolHold()
<<destroy>>+IUdpNode()

HP-Socket v5.7.x 版本开始，提供 UDP Node（UDP 节点）组件：IUdpNode。UDP Node
与 HP-Socket 的其它通信组件不同，它没有“连接”的概念（因此也没有 Connection ID），
行为模式类似于普通 UDP Socket，可以同时与任何 UDP 应用程序通信。该组件可以以单播、
组播和广播三种模式运行。UDP Node 组件接口如图 2.5.1-1 所示是一个独立的接口，不继承
于 其 它 任 何 接 口 。 主 要 接 口 方 法 如 表 2.5.1-1 所 示 ， 其 它 接 口 方 法 请 参 考
include/hpsocket/SocketInterface.h 文件的相关注释：

UDP Node 监听器接口如图 2.5.1-2 所示也是一个独立的接口，不继承于其它任何接口。
接口回调事件如表 2.5.1-2 所示：




图 2.5.2-1 展示了应用程序与 UDP Node 组件的交互流程：
⚫ 应用程序调用 Start() 方法启动 UDP Node 组件，如果调用成功则返回 TRUE 并收
到 OnPrepareListen 事件。
⚫ 应用程序调用 Send()、SendCast() 等方法发送单播、组播或广播数据，数据发出后
应用程序将收到 OnSend 事件。
⚫ 远程应用程序向应用程序发送数据时，应用程序将收到 OnReceive 事件。
⚫ 数据发送或接收出现异常时，应用程序将收到 OnError 事件。
⚫ 应用程序调用 Stop() 方法关闭 UDP Node 组件，如果调用成功则返回 TRUE 并收
到 OnShutdown 事件。