iXcom36瘦客户端使用指南Word格式.docx
《iXcom36瘦客户端使用指南Word格式.docx》由会员分享，可在线阅读，更多相关《iXcom36瘦客户端使用指南Word格式.docx（8页珍藏版）》请在冰豆网上搜索。
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地址
6
standbyip
对端节点备用ip地址
7
port
对端节点端口
8
isbigendian
“true”或“false”
messages段
9
id
如“AABB01”
消息号，6位字母或数字
10
aheadnodedc
消息发送方代号，两位字母
11
forwardnodedc
消息目标方代号，两位字母
12
mapmsgid
13
dealfunc
app段
14
libpath
如“./libmsgrecv.so”或
“./msgrecv.dll”
应用接收电文库文件位置
必配，推荐绝对路径，当前路径以“./开始
log段
15
opened
是否记录日志
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:
"
<
xmlin>
messageid>
aabbcc<
/messageid>
##[（#data#）]##>
data<
/##[（#data#）]##>
Char*xmlout:
xmlout>
returncode>
0<
/returncode>
info>
sucess<
/info>
time>
20121010121212<
/time>
函数提供者
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平台
修改日志输出路径及日志级别，注意日志须为完整绝对路径
右击start.bat，选择“以管理员身份运行”
打开运行services.msc，查看thinxcom服务是否成功启动
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）;
insertbuffer:
testbuf）;
//组装发送xml格式的消息参数，<
：
映射电文号，<
电文内容
sprintf（xmlin,"
?
xmlversion=\"
1.0\"
standalone='
no'
>
\n"
"
%s<
/xmlin>
msgid,testbuf）;
xmlinis:
%s\n"
xmlin）;
/*调用发送接口，其中xmlout是输出xml格式：
"
*/
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
升级会员 