iXcom3.6瘦客户端使用指南

消息中间件3.6iXCom瘦客户端使用指南版权阐明上海宝信软件股份有限企业版权所有，并保留对本文档及本申明的最终解释权和修改权。本文档的版权归上海宝信软件股份有限企业所有。未得到上海宝信软件股份有限企业的书面许可，任何人不得以任何方式或形式对本文档内的任何部分进行复制、摘录、备份、修改、传播、翻译成其他语言、将其所有或部分用于商业用途。上海宝信软件股份有限企业版权所有1998-AllRightsReserved.目录1 概述 11.1 目的 11.2 产品功能简介 11.3 词汇表 12 软件构造 23 配置阐明 24 接口阐明 45 使用阐明 45.1 UNIX平台 45.2 windows平台 56 附录-接口代码示例 67 联络方式 7概述目的iXcom产品系列是宝信自主研发的外部通讯中间件产品，目前已经到3.6版本。该产品系列在宝信所承担的项目中普遍的并越来越多的被采用，且已形成体系对外销售。为了更好的支撑宝信所承担的项目，需要对iXcom进行持续的升级，以逐渐完善其功能，提高成熟度和产品化程度，满足业务不停变化的需求，并尝试进入国内的消息中间件市场，提高宝信在系统集成领域的竞争力和著名度。iXcom新版本将继续延续iXcom产品系列的消息中间件路线，向下兼容前期版本，并修正优化前期版本的某些数据互换区、进程并发处理问题，提高产品运行的稳定性，重点升级产品的数据处理速度，根据市场的需要和趋势为新版本增添新功能，扩展系统接口，重构管理及监控界面。瘦客户端是宝信消息中间件iXCom的附带简易版本，具有功能简化、协议固定、配置简朴、资源消耗小、消息处理速度快、多平台支持等特点，合用于系统终端无数据库环境与完整iXCom进行消息通信。该文档描述了消息中间件iXcom瘦客户端的构成、配置、使用阐明等。本手册使用对象为：负责在不一样平台上安装iXcom的技术人员负责配置、管理iXcom的技术人员使用iXcom进行设计、开发以及运行的技术人员系统的项目经理或负责人产品功能简介iXCom瘦客户端作为iXCom的简易版本，继承了消息中间件的基本功能，包括屏蔽系统差异，消息的可靠传播等。作为简易版本，瘦客户端目前支持一种通信协议（29d），消息不支持持久化，只与单一的iXCom节点通信。由于目前iXCom3.5尚不支持windows平台，瘦客户端可作为windows平台的备用方案。软件构造表STYLEREF1\s2SEQ表\*ARABIC\s11软件构成表文献名功能简介备注thinxcom(UNIX)/thinxcom.exe(windows)瘦客户端接受进程libmsgsend.so(UNIX)/msgsend.dll(windows)瘦客户端发送函数库thinxcomcfg.xml瘦客户端配置文献start.batWindows下启动接受服务须以管理员身份运行stop.batWindows下关闭接受服务须以管理员身份运行配置阐明编号配置项配置值配置阐明备注syscfg段1listenPort1024~65535瘦客户端监听端口必配2ip有效ip地址当有多种网卡时可配置监听指定ip，一般状况无需配置选配3nodedc如“AA”本节点代号，两位字母必配nodedc段4name如“BB”对端节点代号，两位字母必配5primaryip有效ip地址对端节点主ip地址必配6standbyip有效ip地址对端节点备用ip地址选配7port1024~65535对端节点端口必配8isbigendian“true”或“false”选配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、warning、info、debug”日志输出级别必配接口阐明函数参数MsgSendMsgRecv函数原型intMsgSend(char*xmlin,char*xmlout)intMsgRecv(char*xmlin,char*xmlout)涵义电文发送API函数电文接受API函数库文献libmsgsend.so(UNIX)\msgsend.dll(WIN)libmsgrecv.so(UNIX)\msgrecv.dll(WIN)参数定义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>" 函数提供者iXCom瘦客户端应用备注传入的messageid应为消息配置中的映射电文号mapmessageid使用阐明UNIX平台瘦客户端提供msgsend接口供应用调用以发送电文，接受进程需要应用编写消息接受库提供MsgRecv接口接受处理电文，接口阐明见上一节。编写处理接受电文的应用接口库，实现MsgRecv接口，可参照msgrecv示例；编写调用瘦客户端发送接口的程序，可参照sendtest示例；修改瘦客户端配置文献thinxconcfg.xml：配置监听端口，远端ip及端口配置电文号messages修改libpath＝MsgRecv接口库修改日志输出途径及日志级别启动监听程序接受电文执行./thinxcom-D运行发送程序发送电文停止接受进程kill[瘦客户端pid]windows平台编写处理接受电文的应用接口库，实现MsgRecv接口，可参照msgrecv示例；编写调用瘦客户端发送接口的程序，可参照sendtest示例；修改瘦客户端配置文献thinxconcfg.xml：配置监听端口，远端ip及端口配置电文号messages修改libpath＝MsgRecv接口库修改日志输出途径及日志级别，注意日志须为完整绝对途径启动监听程序接受电文右击start.bat，选择“以管理员身份运行”打开运行services.msc，查看thinxcom服务与否成功启动运行发送程序发送电文停止接受服务右击stop.bat，选择“以管理员身份运行”#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); //组装发送xml格式的消息参数，<messageid>：映射电文号，<##[(#data#)]##>：电文内容 sprintf(xmlin,"<?xmlversion=\"1.0\"standalone='no'>\n" "<xmlin>" "<messageid>%s</messageid>" "<##[(#data#)]##>%s</##[(#data#)]##>" "</xmlin>",msgid,testbuf); printf("xmlinis:%s\n",xmlin); /*调用发送接口，其中xmlout是输出xml格式："<xmlout>""<returncode>0</returncode>""<info>sucess</info>""<xmlout>"*/