已阅读5页，还剩24页未读， 继续免费阅读
版权说明：本文档由用户提供并上传，收益归属内容提供方，若内容存在侵权，请进行举报或认领
文档简介
RTXServerSDK 开发前准备 安装RTXServer安装RTXServerSDK 内容 RTXServerSDK功能概述RTXServer应用架构体系RTXServerSDK对象模型应用生命周期的四步曲 注册对象 启动应用 停止应用 注销应用对象模型中一些重要对象示例 RTXServerSDK功能概述 ServerSDK提供给用户一套自己开发应用的接口 让第三方在RTX上开发自己的业务功能 利用SDK接口提供的API可以在服务器获取RTX现有的c s协议的消息类型的数据包 从而第三方可以根据需要对数据包进行处理 开发出新的的业务功能 如IM消息监控 第三方短信网关 离线消息 用户详细资料等应用 开发第三方业务嵌入到RTX系统 这个要与RTXCLIENT的API相结合开发的 RTXServerSDK主要功能 抽取或发送各种消息类型数据包接收 发送短信关注某些用户或所有用户的状态变化文件监控部门 用户 权限管理 RTXServer应用体系整体架构 RTXServer应用体系整体架构 客户端连接的是ConnServer 应用连接的是APPServer 可以理解为APP与Client是对等关系 应用注册给AppServer 当应用启动和停止AppServer会上报给ConnServer应用服务器APPServer与ConnServer相连 第三方应用通过Appserver发送与接收数据 ConnServer负责根据应用的注册信息过滤消息 AppServer只是负责管理应用和数据中转 RTX系统中消息的流动 RTX系统中消息的流动 1 客户端发送给客户端 消息可以根据应用注册的信息被过滤 图中的蓝线 2 客户端发送给应用 图中的红线 3 应用发送给客户端 图中的绿线 消息在被过滤得时候有两种处理方式 抽取和复制 采用抽取的方式时 过滤后不会再被转发 采用复制的方式时 过滤后消息将继续向原来目的地发送 自动升级服务中消息的流动 自动升级服务中消息的流动 自动升级服务组成部分 1 Client的自动升级模块2 Server的升级服务器 检查更新和文件下载服务自动升级过程 客户端登录时会自动检查更新 检查更新的请求通过消息通道发送到升级服务器 升级服务器再通过消息通道将更新项发送给给客户端 客户端检查发现存在自己没有更新过的选项时将通过文件通道下载该更新项 自动升级服务中消息的流动 客户端 升级服务器 自动升级服务中消息的流动 升级服务器 客户端 应用生命周期的四部曲 注册应用启动应用停止应用注销应用 注册应用 应用必须首先向应用服务器注册后才能启动运行 注册时应用属性的设置决定了应用对消息的处理逻辑 向AppServer注册时AppServer会生成一个配置文件 这些属性会保存到配置文件中 应用的属性 应用的属性包括 1 ServerIPAppServer地址2 ServerPortAppServer端口3 AppGUID应用的唯一标识 不能重复 4 AppName应用名 助记符 5 AppPriority应用优先级 如对相同类型的消息进行处理优先级高的应用将先过滤消息6 AppAction过滤动作 拷贝和抽取7 FilterRequestType要过滤的消息类型 如短信的消息类型为Tencent RTX Sms8 FilterKey要过滤关键字9 FilterSender要过滤的消息发送者10 FilterReceiver要过滤的消息接受者11 FilterReceiverState要过滤的接收者状态 启动应用 启动应用之前必须是注册应用成功之后 才能启动成功 应用启动时 会通过Appserver向ConnServer发送应用启动的命令 并将应用的配置信息发送到ConnServer的cache中去 ConnServer将根据应用的设置对消息进行过滤 同样如同一个应用启动多次 后一次启动会踢除前一次已启动的应用 以最后一次的启动应用为主 停止应用 停止应用时 AppServer会向ConnServer发送应用停止的命令 注册应用时生成配置文件将依然保留 除非重新注册 否则下次启动时还将按此配置运行 注销应用 应用注销时 AppServer将删除保存应用属性的配置文件 应用一旦注销 将不能再次启动 RTXServerSDK对象模型 对象介绍 根对象 SDK的对象体系中所有的其它对象都需要通过根对象来创建 根对象提供接口IRTXSAPIRootObj 该接口提供创建各其他对象的函数 另外还提供一些通用的查询函数 如查询版本号 查询企业信息 查询用户状态等 对象介绍 应用对象 应用对象是最为通用的对象 短信对象 状态对象等都可以看作是应用对象的特化 即具有某些特殊属性的应用对象 因而应用对象的属性最多 功能也最灵活 通过对属性的设置 可以使应用对象完成其它一些对象胜任的功能 以状态对象为例 它本质上就是一个关注Tencent RTX ChangeState类型消息和所有接收者的应用对象 对象介绍 消息对象 ServerSDK对应用和RTXServer之间传输的数据做了一个抽象 并封装成为消息对象 消息对象包含了客户端和应用之间逻辑处理需要的信息 并将它们封装成为消息对象的属性 消息对象的属性 AppName应用名称Content收到的xml格式的rtx特定的C S子协议包内容Content的格式为 GET DEPT VER说明 1 必须由作为根节点 作为它的子元素 2 每个子协议必须有 Command 属性 不然没有子协议命令的协议是无意义的 也是非法的 3 Key的属性值与APP与RTXClient之间的协议内容 自定 Type的属性值为该元素内容的数据类型 支持数字 字符 二进制类型 消息对象的属性 续 MsgType消息类型Sender发送者Receivers接收者OfflineReceivers离线的接收者TimeSent发送时间MessageFlag标识位 通过该标识 可以设定该消息的数据包允不允许ConnServer进行过滤 对象介绍 短信对象 短信对象本质上是具有某种特殊功能的应用对象 短信对象提供接口IRTXSAPISmsObj 可以发送上行短信 接收下行短信 发送下行短信回复结果等 对象介绍 状态对象 状态对象本质上是具有某种特殊功能的应用对象 状态对象提供接口IRTXSAPIStateObj 可以关注某些人或所有人状态变化 并在关注对象状态发生变化的时候抛出事件通知 对象介绍 文件监控对象 文件监控对象与以上几种对象有所不同 它不和AppServer进行通信 而是和通信 在一个上 同一时间内只允许一个文件监控对象存在 如果启动第二个文件监控对象 则第一个对象会被踢掉 文件监控对象没有需要设置的属性 文件监控对象与之间有一条TCP的长连接 用于传输客户端文件上传通知 以及信令协议传输 下载文件时 将建立新连接下载指定文件 对象介绍 用户管理部门管理以及权限管理 在ServerSDK对象体系中 还提
温馨提示
- 1. 本站所有资源如无特殊说明，都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等，如果需要附件，请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸，网页内容里面会有图纸预览，若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间，仅对用户上传内容的表现方式做保护处理，对用户上传分享的文档内容本身不做任何修改或编辑，并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容，请与我们联系，我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
评论
0/150
提交评论