iXcom3.6瘦客戶端使用指南

消息中間件3.6iXCom瘦客戶端使用指南版權(quán)闡明上海寶信軟件股份有限企業(yè)版權(quán)所有，并保留對本文檔及本申明的最終解釋權(quán)和修改權(quán)。本文檔的版權(quán)歸上海寶信軟件股份有限企業(yè)所有。未得到上海寶信軟件股份有限企業(yè)的書面許可，任何人不得以任何方式或形式對本文檔內(nèi)的任何部分進(jìn)行復(fù)制、摘錄、備份、修改、傳播、翻譯成其他語言、將其所有或部分用于商業(yè)用途。上海寶信軟件股份有限企業(yè)版權(quán)所有1998-AllRightsReserved.目錄1 概述 11.1 目的 11.2 產(chǎn)品功能簡介 11.3 詞匯表 12 軟件構(gòu)造 23 配置闡明 24 接口闡明 45 使用闡明 45.1 UNIX平臺 45.2 windows平臺 56 附錄-接口代碼示例 67 聯(lián)絡(luò)方式 7概述目的iXcom產(chǎn)品系列是寶信自主研發(fā)的外部通訊中間件產(chǎn)品，目前已經(jīng)到3.6版本。該產(chǎn)品系列在寶信所承擔(dān)的項(xiàng)目中普遍的并越來越多的被采用，且已形成體系對外銷售。為了更好的支撐寶信所承擔(dān)的項(xiàng)目，需要對iXcom進(jìn)行持續(xù)的升級，以逐漸完善其功能，提高成熟度和產(chǎn)品化程度，滿足業(yè)務(wù)不停變化的需求，并嘗試進(jìn)入國內(nèi)的消息中間件市場，提高寶信在系統(tǒng)集成領(lǐng)域的競爭力和著名度。iXcom新版本將繼續(xù)延續(xù)iXcom產(chǎn)品系列的消息中間件路線，向下兼容前期版本，并修正優(yōu)化前期版本的某些數(shù)據(jù)互換區(qū)、進(jìn)程并發(fā)處理問題，提高產(chǎn)品運(yùn)行的穩(wěn)定性，重點(diǎn)升級產(chǎn)品的數(shù)據(jù)處理速度，根據(jù)市場的需要和趨勢為新版本增添新功能，擴(kuò)展系統(tǒng)接口，重構(gòu)管理及監(jiān)控界面。瘦客戶端是寶信消息中間件iXCom的附帶簡易版本，具有功能簡化、協(xié)議固定、配置簡樸、資源消耗小、消息處理速度快、多平臺支持等特點(diǎn)，合用于系統(tǒng)終端無數(shù)據(jù)庫環(huán)境與完整iXCom進(jìn)行消息通信。該文檔描述了消息中間件iXcom瘦客戶端的構(gòu)成、配置、使用闡明等。本手冊使用對象為：負(fù)責(zé)在不一樣平臺上安裝iXcom的技術(shù)人員負(fù)責(zé)配置、管理iXcom的技術(shù)人員使用iXcom進(jìn)行設(shè)計(jì)、開發(fā)以及運(yùn)行的技術(shù)人員系統(tǒng)的項(xiàng)目經(jīng)理或負(fù)責(zé)人產(chǎn)品功能簡介iXCom瘦客戶端作為iXCom的簡易版本，繼承了消息中間件的基本功能，包括屏蔽系統(tǒng)差異，消息的可靠傳播等。作為簡易版本，瘦客戶端目前支持一種通信協(xié)議（29d），消息不支持持久化，只與單一的iXCom節(jié)點(diǎn)通信。由于目前iXCom3.5尚不支持windows平臺，瘦客戶端可作為windows平臺的備用方案。軟件構(gòu)造表STYLEREF1\s2SEQ表\*ARABIC\s11軟件構(gòu)成表文獻(xiàn)名功能簡介備注thinxcom(UNIX)/thinxcom.exe(windows)瘦客戶端接受進(jìn)程libmsgsend.so(UNIX)/msgsend.dll(windows)瘦客戶端發(fā)送函數(shù)庫thinxcomcfg.xml瘦客戶端配置文獻(xiàn)start.batWindows下啟動接受服務(wù)須以管理員身份運(yùn)行stop.batWindows下關(guān)閉接受服務(wù)須以管理員身份運(yùn)行配置闡明編號配置項(xiàng)配置值配置闡明備注syscfg段1listenPort1024~65535瘦客戶端監(jiān)聽端口必配2ip有效ip地址當(dāng)有多種網(wǎng)卡時(shí)可配置監(jiān)聽指定ip，一般狀況無需配置選配3nodedc如“AA”本節(jié)點(diǎn)代號，兩位字母必配nodedc段4name如“BB”對端節(jié)點(diǎn)代號，兩位字母必配5primaryip有效ip地址對端節(jié)點(diǎn)主ip地址必配6standbyip有效ip地址對端節(jié)點(diǎn)備用ip地址選配7port1024~65535對端節(jié)點(diǎn)端口必配8isbigendian“true”或“false”選配messages段9id如“AABB01”消息號，6位字母或數(shù)字必配10aheadnodedc如“AA”消息發(fā)送方代號，兩位字母必配11forwardnodedc如“BB”消息目的方代號，兩位字母必配12mapmsgid必配13dealfunc選配app段14libpath如“./libmsgrecv.so”或“./msgrecv.dll”應(yīng)用接受電文庫文獻(xiàn)位置必配，推薦絕對途徑，目前途徑以“./開始log段15opened“true”或“false”與否記錄日志必配16logpath如“/home/ixcom”或“d://”日志文獻(xiàn)途徑必配，絕對途徑17level“error、warning、info、debug”日志輸出級別必配接口闡明函數(shù)參數(shù)MsgSendMsgRecv函數(shù)原型intMsgSend(char*xmlin,char*xmlout)intMsgRecv(char*xmlin,char*xmlout)涵義電文發(fā)送API函數(shù)電文接受API函數(shù)庫文獻(xiàn)libmsgsend.so(UNIX)\msgsend.dll(WIN)libmsgrecv.so(UNIX)\msgrecv.dll(WIN)參數(shù)定義Char*xmlin:"<xmlin>""<messageid>aabbcc</messageid>""<##[(#data#)]##>data</##[(#data#)]##>""<xmlin>"Char*xmlout:"<xmlout>""<returncode>0</returncode>""<info>sucess</info>""<xmlout>"Char*xmlin:"<xmlin>""<messageid>aabbcc</messageid>""<##[(#data#)]##>data</##[(#data#)]##>""<time>12</time>""<xmlin>"Char*xmlout:"<xmlout>""<returncode>0</returncode>""<info>sucess</info>""<xmlout>" 函數(shù)提供者iXCom瘦客戶端應(yīng)用備注傳入的messageid應(yīng)為消息配置中的映射電文號mapmessageid使用闡明UNIX平臺瘦客戶端提供msgsend接口供應(yīng)用調(diào)用以發(fā)送電文，接受進(jìn)程需要應(yīng)用編寫消息接受庫提供MsgRecv接口接受處理電文，接口闡明見上一節(jié)。編寫處理接受電文的應(yīng)用接口庫，實(shí)現(xiàn)MsgRecv接口，可參照msgrecv示例；編寫調(diào)用瘦客戶端發(fā)送接口的程序，可參照sendtest示例；修改瘦客戶端配置文獻(xiàn)thinxconcfg.xml：配置監(jiān)聽端口，遠(yuǎn)端ip及端口配置電文號messages修改libpath＝MsgRecv接口庫修改日志輸出途徑及日志級別啟動監(jiān)聽程序接受電文執(zhí)行./thinxcom-D運(yùn)行發(fā)送程序發(fā)送電文停止接受進(jìn)程kill[瘦客戶端pid]windows平臺編寫處理接受電文的應(yīng)用接口庫，實(shí)現(xiàn)MsgRecv接口，可參照msgrecv示例；編寫調(diào)用瘦客戶端發(fā)送接口的程序，可參照sendtest示例；修改瘦客戶端配置文獻(xiàn)thinxconcfg.xml：配置監(jiān)聽端口，遠(yuǎn)端ip及端口配置電文號messages修改libpath＝MsgRecv接口庫修改日志輸出途徑及日志級別，注意日志須為完整絕對途徑啟動監(jiān)聽程序接受電文右擊start.bat，選擇“以管理員身份運(yùn)行”打開運(yùn)行services.msc，查看thinxcom服務(wù)與否成功啟動運(yùn)行發(fā)送程序發(fā)送電文停止接受服務(wù)右擊stop.bat，選擇“以管理員身份運(yùn)行”#include"thinxcom.h"int#include"thinxcom.h"intmain(){chartestbuf[4000]={0};

charxmlin[4000]={0}; charmsgid[12]={0}; charxmlout[400]={0}; intret; printf("insertmessageid:"); scanf("%s",msgid); printf("insertbuffer:"); scanf("%s",testbuf); //組裝發(fā)送xml格式的消息參數(shù)，<messageid>：映射電文號，<##[(#data#)]##>：電文內(nèi)容 sprintf(xmlin,"<?xmlversion=\"1.0\"standalone='no'>\n" "<xmlin>" "<messageid>%s</messageid>" "<##[(#data#)]##>%s</##[(#data#)]##>" "</xmlin>",msgid,testbuf); printf("xmlinis:%s\n",xmlin); /*調(diào)用發(fā)送接口，其中xmlout是輸出xml格式："<xmlout>""<returncode>0</returncode>""<info>sucess</info>""<xmlout>"*/