iXcom36瘦客户端使用指南.docx

1、iXcom36瘦客户端使用指南消息中间件3.6iXCom 瘦客户端使用指南版权说明上海宝信软件股份有限公司版权所有，并保留对本文档及本声明的最终解释权和修改权。本文档的版权归上海宝信软件股份有限公司所有。未得到上海宝信软件股份有限公司的书面许可，任何人不得以任何方式或形式对本文档内的任何部分进行复制、摘录、备份、修改、传播、翻译成其它语言、将其全部或部分用于商业用途。上海宝信软件股份有限公司 版权所有 1998-2012 All Rights Reserved. 目 录1 概述 11.1 目的 11.2 产品功能介绍 11.3 词汇表 12 软件结构 23 配置说明 24 接口说明 45 使用

2、说明 45.1 UNIX平台 45.2 windows平台 56 附录-接口代码示例 67 联系方式 71 概述1.1 目的iXcom产品系列是宝信自主研发的外部通讯中间件产品，目前已经到3.6版本。该产品系列在宝信所承担的项目中普遍的并越来越多的被采用，且07年已形成体系对外销售。为了更好的支撑宝信所承担的项目，需要对iXcom 进行持续的升级，以逐步完善其功能，提高成熟度和产品化程度，满足业务不断变化的需求，并尝试进入国内的消息中间件市场，提高宝信在系统集成领域的竞争力和知名度。iXcom 新版本将继续延续iXcom产品系列的消息中间件路线，向下兼容前期版本，并修正优化前期版本的一些数据交

3、换区、进程并发处理问题，提高产品运行的稳定性，重点升级产品的数据处理速度，根据市场的需要和趋势为新版本增添新功能，扩展系统接口，重构管理及监控界面。瘦客户端是宝信消息中间件iXCom的附带简易版本，具有功能简化、协议固定、配置简单、资源消耗小、消息处理速度快、多平台支持等特点，适用于系统终端无数据库环境与完整iXCom进行消息通信。该文档描述了消息中间件iXcom瘦客户端的构成、配置、使用说明等。本手册使用对象为： 负责在不同平台上安装iXcom的技术人员 负责配置、管理iXcom的技术人员 使用iXcom进行设计、开发以及运行的技术人员 系统的项目经理或负责人1.2 产品功能介绍iXCom瘦

4、客户端作为iXCom的简易版本，继承了消息中间件的基本功能，包括屏蔽系统差异，消息的可靠传输等。作为简易版本，瘦客户端目前支持一种通信协议（29d），消息不支持持久化，只与单一的iXCom节点通信。由于目前iXCom3.5尚不支持windows平台，瘦客户端可作为windows平台的备用方案。2 软件结构表 21软件构成表文件名功能简介备注thinxcom(UNIX)/thinxcom.exe(windows)瘦客户端接收进程libmsgsend.so(UNIX)/msgsend.dll(windows)瘦客户端发送函数库thinxcomcfg.xml瘦客户端配置文件start.batWind

5、ows下启动接收服务须以管理员身份运行stop.batWindows下关闭接收服务须以管理员身份运行3 配置说明编号配置项配置值配置说明备注syscfg段1listenPort102465535瘦客户端监听端口必配2ip有效ip地址当有多个网卡时可配置监听指定ip，一般情况无需配置选配3nodedc如“AA”本节点代号，两位字母必配nodedc段4name如“BB”对端节点代号，两位字母必配5primaryip有效ip地址对端节点主ip地址必配6standbyip有效ip地址对端节点备用ip地址选配7port102465535对端节点端口必配8isbigendian“true”或“false”

6、选配messages段9id如“AABB01”消息号，6位字母或数字必配10aheadnodedc如“AA”消息发送方代号，两位字母必配11forwardnodedc如“BB”消息目标方代号，两位字母必配12mapmsgid必配13dealfunc选配app段14libpath如“./libmsgrecv.so”或“./msgrecv.dll”应用接收电文库文件位置必配，推荐绝对路径，当前路径以“./开始log段15opened“true”或“false”是否记录日志必配16logpath如“/home/ixcom”或“d:/”日志文件路径必配，绝对路径17level“error、warnin

7、g、info、debug”日志输出级别必配4 接口说明 函数 参数MsgSendMsgRecv函数原型int MsgSend(char* xmlin, char* xmlout)int MsgRecv(char* xmlin,char* xmlout)涵义电文发送API函数电文接收API函数库文件libmsgsend.so(UNIX)msgsend.dll(WIN)libmsgrecv.so(UNIX)msgrecv.dll(WIN)参数定义Char* xmlin:aabbcc dataChar* xmlout:0 sucessChar* xmlin:aabbcc data2012101012

8、1212Char* xmlout:0 sucess 函数提供者iXCom瘦客户端应用备注传入的messageid应为消息配置中的映射电文号mapmessageid5 使用说明5.1 UNIX平台瘦客户端提供msgsend接口供应用调用以发送电文，接收进程需要应用编写消息接收库提供MsgRecv接口接收处理电文，接口说明见上一节。1) 编写处理接收电文的应用接口库，实现MsgRecv接口，可参照msgrecv示例；2) 编写调用瘦客户端发送接口的程序，可参照sendtest示例；3) 修改瘦客户端配置文件thinxconcfg.xml：配置监听端口，远端ip及端口配置电文号messages修改l

9、ibpathMsgRecv接口库修改日志输出路径及日志级别4) 启动监听程序接收电文执行 ./thinxcom -D5) 运行发送程序发送电文6) 停止接收进程kill 瘦客户端pid 5.2 windows平台1) 编写处理接收电文的应用接口库，实现MsgRecv接口，可参照msgrecv示例；2) 编写调用瘦客户端发送接口的程序，可参照sendtest示例；3) 修改瘦客户端配置文件thinxconcfg.xml：配置监听端口，远端ip及端口配置电文号messages修改libpathMsgRecv接口库修改日志输出路径及日志级别，注意日志须为完整绝对路径4) 启动监听程序接收电文右击st

10、art.bat，选择“以管理员身份运行”打开运行services.msc，查看thinxcom服务是否成功启动5) 运行发送程序发送电文6) 停止接收服务右击stop.bat，选择“以管理员身份运行”6 #include thinxcom.hint main()char testbuf4000 = 0;char xmlin4000 = 0; char msgid12 = 0; char xmlout400 = 0; int ret; printf(insert messageid:); scanf(%s,msgid); printf(insert buffer:); scanf(%s,test

11、buf); / 组装发送xml格式的消息参数，：映射电文号， ：电文内容 sprintf(xmlin, n %s %s ,msgid,testbuf); printf(xmlin is:%sn,xmlin); /*调用发送接口，其中xmlout是输出xml格式： 0 sucess */ ret = MsgSend(xmlin,xmlout);printf(return is:%s,code=%dnnn,xmlout,ret); return 0; 附录-接口代码示例7 联系方式感谢您使用宝信消息中间件iXcom3.5产品，如在安装过程中遇到问题，可按照下述方式联系我们。联系人iXCom项目组联系电话 86-21-66797663联系地址上海市宝山区友谊西路1016号607室邮编201900