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
copyright@ 2008-2022 冰豆网网站版权所有
经营许可证编号:鄂ICP备2022015515号-1