UniMedia IDE集成環(huán)境訪問網(wǎng)絡服務器實例解析
2009/05/27
1.目標功能
在IDE中實現(xiàn)Socket客戶端,向TCP/IP服務端發(fā)送數(shù)據(jù)串。
2.數(shù)據(jù)格式說明:
如果外部應用采用NETX控件與IDE進行通信,則以MSG對象格式進行數(shù)據(jù)傳遞,不需要進行格式拆分。
MSG對象格式示例:
MSG userMsg
userMsg.UserMsgType = 8
userMsg.Int0 = 0
userMsg.Int1 = 1
userMsg.Int2 = 2
userMsg.Int3 = 3
userMsg.Int4 = 4
userMsg.Int5 = 5
userMsg.Int6 = 6
userMsg.Int7 = 7
userMsg.Int8 = 8
userMsg.Int9 = 9
userMsg.Str0 = “a”
userMsg.Str1 = “b”
userMsg.Str2 = “c”
userMsg.Str3 = “d”
userMsg.Str4 = “e”
userMsg.Str5 = “f”
userMsg.Str6 = “g”
userMsg.Str7 = “h”
userMsg.Str8 = “i”
userMsg.Str9 = “j”
如果與外部之間通過SOCKET直接進行碼流通信,以上面的對象值為例,具體消息格式舉例說明如下,碼流格式為ASCII碼:
其中:
MID是消息ID(正整數(shù))
4199
1-10等字段字用戶填上述固定值即可;
StringListSize 字段的值為10個有效字符數(shù), 其它字段可根據(jù)業(yè)務需要填寫;
說明:10個Str字符的總長不能大于1024個字節(jié),單個字段的長度不能大于1024個字節(jié),整個消息包不能大于2048個字節(jié)。
NETX使用
如果不想自己拆分數(shù)據(jù),可直接使用NetX控件。
4.2.4.3 IDE腳本實例
///////////////////////////////////////////////////////////////
#define TCP_SERVER_IP "127.0.0.1"
#define TCP_SERVER_PORT 14445
SCPMANAGER g_SCPManager
//主函數(shù)
sub main(LIST& cpl)
{
CONN l_CONNVar
MSG l_MSGSendVar
String l_stringIpOfClientVar
Int l_intPortClientVar,l_intConnIDClientVar,l_intRetVar
Bool l_boolConnectStatusVar
//初始化IP和PORT
l_stringIpOfClientVar = TCP_SERVER_IP
l_intPortClientVar = TCP_SERVER_PORT
//發(fā)起TCP Client端連接
l_CONNVar.OpenConn(PT_TCP, CT_CLIENT, l_stringIpOfClientVar,
l_intPortClientVar, l_intConnIDClientVar,
false, l_intRetVar)
//等待2秒,等待底層網(wǎng)絡連接
Wait(2000)
//設置網(wǎng)絡對象具備自動重連特性
l_CONNVar.SetAutoReconnect(true, l_intRetVar)
//注冊數(shù)據(jù)到達事件
EventMap(INF_SYS_CONNDATAINCOME, OnConnDataIncome, 0)
while(true)
{
//取網(wǎng)絡連接狀態(tài)
l_CONNVar.GetStatus(l_boolConnectStatusVar, l_intRetVar)
//分析是否已經(jīng)建立網(wǎng)絡連接,建立則發(fā)送數(shù)據(jù)
if (l_boolConnectStatusVar == true)
{
//初始化發(fā)送數(shù)據(jù)
l_MSGSendVar.UserMsgType = 8
l_MSGSendVar.Int0 = 10
l_MSGSendVar.Str0 = "aaa"
Log(DBG,"發(fā)送數(shù)據(jù)..." )
//發(fā)送數(shù)據(jù)
l_CONNVar.SendMsg(l_MSGSendVar, l_intRetVar)
//TODO 發(fā)送數(shù)據(jù)后結(jié)束,為驗證數(shù)據(jù)接收,可以考慮不結(jié)束
break
}
//如果連接沒有成功,則過一會再進行查詢
Wait(5000)
}// end of while
//斷開網(wǎng)絡連接,關閉對象
l_CONNVar.CloseConn()
}
//接收網(wǎng)絡數(shù)據(jù)事件回調(diào)函數(shù)
sub OnConnDataIncome(int tag, CONN& conn)
{
int l_intRetVar
bool l_boolHasMsgVar, l_boolConnectStatusVar
MSG l_MSGReadVar
Log(DBG,"有網(wǎng)絡數(shù)據(jù)到達事件!")
//可能有多條消息,進行循環(huán)讀取接收
while(true)
{
//開始讀消息...
conn.ReadMsg(l_MSGReadVar, l_boolHasMsgVar, l_intRetVar)
if((l_intRetVar == RET_SUCC) && (l_boolHasMsgVar == true))
{
Log(DBG,"(TCP CLIENT READ ,(RET=",l_intRetVar,
",CONNID=", conn.ConnID,
",Type=", l_MSGReadVar.UserMsgType,
",Int0=", l_MSGReadVar.Int0,
",Str0=", l_MSGReadVar.Str0,")")
}
else
{
//沒有數(shù)據(jù)或錯誤
return
}
} //end of While read
}
NEX控件說明:
NETX 是以ActiveX控件以接口方式被外部應用程序調(diào)用。對高層應用程序而言,直接利用控件,可以在不了解UniMedia內(nèi)部協(xié)議的前提下,實現(xiàn)與IDE的網(wǎng)絡通信,具體通信內(nèi)容是上述定義的MSG對象。詳細接口說明可以參考《接口及使用手冊-NETX.PDF》
CTI論壇報道
相關鏈接: