iXcom36瘦客户端使用指南.docx
《iXcom36瘦客户端使用指南.docx》由会员分享，可在线阅读，更多相关《iXcom36瘦客户端使用指南.docx（8页珍藏版）》请在冰豆网上搜索。
iXcom36瘦客户端使用指南
消息中间件3.6
iXCom
瘦客户端使用指南
版权说明
上海宝信软件股份有限公司版权所有，并保留对本文档及本声明的最终解释权和修改权。
本文档的版权归上海宝信软件股份有限公司所有。
未得到上海宝信软件股份有限公司的书面许可，任何人不得以任何方式或形式对本文档内的任何部分进行复制、摘录、备份、修改、传播、翻译成其它语言、将其全部或部分用于商业用途。
上海宝信软件股份有限公司版权所有1998-2012AllRightsReserved.
目录
1概述1
1.1目的1
1.2产品功能介绍1
1.3词汇表1
2软件结构2
3配置说明2
4接口说明4
5使用说明4
5.1UNIX平台4
5.2windows平台5
6附录-接口代码示例6
7联系方式7
1概述
1.1目的
iXcom产品系列是宝信自主研发的外部通讯中间件产品，目前已经到3.6版本。
该产品系列在宝信所承担的项目中普遍的并越来越多的被采用，且07年已形成体系对外销售。
为了更好的支撑宝信所承担的项目，需要对iXcom进行持续的升级，以逐步完善其功能，提高成熟度和产品化程度，满足业务不断变化的需求，并尝试进入国内的消息中间件市场，提高宝信在系统集成领域的竞争力和知名度。
iXcom新版本将继续延续iXcom产品系列的消息中间件路线，向下兼容前期版本，并修正优化前期版本的一些数据交换区、进程并发处理问题，提高产品运行的稳定性，重点升级产品的数据处理速度，根据市场的需要和趋势为新版本增添新功能，扩展系统接口，重构管理及监控界面。
瘦客户端是宝信消息中间件iXCom的附带简易版本，具有功能简化、协议固定、配置简单、资源消耗小、消息处理速度快、多平台支持等特点，适用于系统终端无数据库环境与完整iXCom进行消息通信。
该文档描述了消息中间件iXcom瘦客户端的构成、配置、使用说明等。
本手册使用对象为：
Ø负责在不同平台上安装iXcom的技术人员
Ø负责配置、管理iXcom的技术人员
Ø使用iXcom进行设计、开发以及运行的技术人员
Ø系统的项目经理或负责人
1.2产品功能介绍
iXCom瘦客户端作为iXCom的简易版本，继承了消息中间件的基本功能，包括屏蔽系统差异，消息的可靠传输等。
作为简易版本，瘦客户端目前支持一种通信协议（29d），消息不支持持久化，只与单一的iXCom节点通信。
由于目前iXCom3.5尚不支持windows平台，瘦客户端可作为windows平台的备用方案。
2软件结构
表21软件构成表
文件名
功能简介
备注
thinxcom（UNIX）/thinxcom.exe（windows）
瘦客户端接收进程
libmsgsend.so（UNIX）/msgsend.dll（windows）
瘦客户端发送函数库
thinxcomcfg.xml
瘦客户端配置文件
start.bat
Windows下启动接收服务
须以管理员身份运行
stop.bat
Windows下关闭接收服务
须以管理员身份运行
3配置说明
编号
配置项
配置值
配置说明
备注
syscfg段
1
listenPort
1024~65535
瘦客户端监听端口
必配
2
ip
有效ip地址
当有多个网卡时可配置监听指定ip，一般情况无需配置
选配
3
nodedc
如“AA”
本节点代号，两位字母
必配
nodedc段
4
name
如“BB”
对端节点代号，两位字母
必配
5
primaryip
有效ip地址
对端节点主ip地址
必配
6
standbyip
有效ip地址
对端节点备用ip地址
选配
7
port
1024~65535
对端节点端口
必配
8
isbigendian
“true”或“false”
选配
messages段
9
id
如“AABB01”
消息号，6位字母或数字
必配
10
aheadnodedc
如“AA”
消息发送方代号，两位字母
必配
11
forwardnodedc
如“BB”
消息目标方代号，两位字母
必配
12
mapmsgid
必配
13
dealfunc
选配
app段
14
libpath
如“./libmsgrecv.so”或
“./msgrecv.dll”
应用接收电文库文件位置
必配，推荐绝对路径，当前路径以“./开始
log段
15
opened
“true”或“false”
是否记录日志
必配
16
logpath
如“/home/ixcom”或“d:
//”
日志文件路径
必配，绝对路径
17
level
“error、warning、info、debug”
日志输出级别
必配
4接口说明
函数
参数
MsgSend
MsgRecv
函数原型
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:
""
"aabbcc"
"<##[（#data#）]##>data"
""
Char*xmlout:
""
"0"
"sucess"
""
Char*xmlin:
""
"aabbcc"
"<##[（#data#）]##>data"
""
""
Char*xmlout:
""
"0"
"sucess"
""
函数提供者
iXCom瘦客户端
应用
备注
传入的messageid应为消息配置中的映射电文号mapmessageid
5使用说明
5.1UNIX平台
瘦客户端提供msgsend接口供应用调用以发送电文，接收进程需要应用编写消息接收库提供MsgRecv接口接收处理电文，接口说明见上一节。
1）编写处理接收电文的应用接口库，实现MsgRecv接口，可参照msgrecv示例；
2）编写调用瘦客户端发送接口的程序，可参照sendtest示例；
3）修改瘦客户端配置文件thinxconcfg.xml：
配置监听端口，远端ip及端口
配置电文号messages
修改libpath＝MsgRecv接口库
修改日志输出路径及日志级别
4）启动监听程序接收电文
执行./thinxcom-D
5）运行发送程序发送电文
6）停止接收进程
kill[瘦客户端pid]
5.2windows平台
1）编写处理接收电文的应用接口库，实现MsgRecv接口，可参照msgrecv示例；
2）编写调用瘦客户端发送接口的程序，可参照sendtest示例；
3）修改瘦客户端配置文件thinxconcfg.xml：
配置监听端口，远端ip及端口
配置电文号messages
修改libpath＝MsgRecv接口库
修改日志输出路径及日志级别，注意日志须为完整绝对路径
4）启动监听程序接收电文
右击start.bat，选择“以管理员身份运行”
打开运行services.msc，查看thinxcom服务是否成功启动
5）运行发送程序发送电文
6）停止接收服务
右击stop.bat，选择“以管理员身份运行”
6
#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格式的消息参数，：
映射电文号，<##[（#data#）]##>：
电文内容
sprintf（xmlin,"
xmlversion=\"1.0\"standalone='no'>\n"
""
"%s"
"<##[（#data#）]##>%s"
"",msgid,testbuf）;
printf（"xmlinis:
%s\n",xmlin）;
/*调用发送接口，其中xmlout是输出xml格式：
""
"0"
"sucess"
""
*/
ret=MsgSend（xmlin,xmlout）;
printf（"returnis:
%s,code=%d\n\n\n",xmlout,ret）;
return0;
}
附录-接口代码示例
7联系方式
感谢您使用宝信消息中间件iXcom3.5产品，如在安装过程中遇到问题，可按照下述方式联系我们。
联系人
iXCom项目组
联系电话
86-21-66797663
Ｅｍａｉｌ
联系地址
上海市宝山区友谊西路1016号607室
邮编
201900
升级会员 