《RTX二次开发word精品文档13页.doc》由会员分享，可在线阅读，更多相关《RTX二次开发word精品文档13页.doc（13页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、如有侵权，请联系网站删除，仅供学习与交流RTX二次开发【精品文档】第 12 页RTX二次开发西安美林电子有限公司二一年六月版本历史日期版本说明（文档修改描述）作者审核人2010-6-10.0.1文档编写刘俊岐目 录1引言41.1目的41.2背景41.3适用范围52腾讯RTX介绍52.1体系架构52.1.1系统整体架构62.1.2软硬件部署83软件安装93.1安装所需软硬件环境93.2最新版本及相关资料下载103.3服务器防火墙配置103.4RTX服务器软件的安装103.5RTX客户端软件的安装124RTX二次开发144.1RTX Server SDK介绍144.1.1RTX Server SD
2、K概述144.1.2RTX Server SDK主要功能144.1.3RTX Server 应用体系整体架构154.1.4RTX Server SDK对象模型164.2人员同步184.3单点登录184.4消息提醒184.5状态感知181 引言1.1 目的RTX应用开发可以有更加完善的资源文档，使更多的同事可以快速掌握RTX的应用开发。1.2 背景RTX的应用在部门内的部分项目中都有涉及，而部门内关于RTX的应用开发的知识资源并没有形成，由于在实际的项目中都已经开始进行了开发应用，所以有必要将此知识形成文档，以便其他同事可以共享资源。1.3 适用范围腾讯RTX服务器端及客户端2009版2 腾讯R
3、TX介绍RTX（腾讯通）是腾讯公司推出的企业级即时通信平台。RTX的前身是BQQ（企业QQ）。RTX平台的主要功能，包括企业内部实时信息交互、语音视频交流、企业短信中心、自动存档主题讨论等等。RTX平台具有很高的实用性、易用性和可管理性。除了底层采用128位对称加密技术之外，在实际应用中，RTX可以通过员工实名制、记录交互信息等措施，确保企业应用的通信安全。RTX包括服务器端和客户端软件，可在企业本地自建服务器，迅速搭建企业的内部即时通信平台。同时，RTX提供二次开发接口，支持第三方在RTX上进行二次开发。2.1 体系架构从整体架构来讲， RTX系统是一个开放的体系结构，是一个平台化、组件化的
4、可扩展平台。第三方厂商可以在RTX系统所提供SDK API的基础上，开发具有即时通讯特性的应用。2.1.1 系统整体架构图2.1.1 RTX系统整体架构图Group ServerRTX_Conn1File ServerSession ServerApp Server轻总线重总线控制总线投票会议IPPBX应用总线RTX_Conn2RCRTX_DBRTX_GWLICENSE图2.1.2 RTX系统总线图图2.1.3 RTX应用服务架构图2.1.2 软硬件部署RTX系统的软硬件部署，主要包括三个部分：RTX用户工作台（安装RTXClient）、RTX服务器（安装RTX各类服务）、数据/文件服务器（安
5、装数据库软件/文件系统）。其中，在实际应用中，RTX服务器与数据/文件服务器可以根据实际情况整合为一台服务器。另外，整个系统通过应用网关RTX_Gateway与Internet连接，所以，网关的服务器与应用服务器为同一台服务器。如下图所示：图2.1.4 软硬件部署示意图3 软件安装3.1 安装所需软硬件环境【腾讯RTX服务端】企业人数CPU内存硬盘剩余空间操作系统500人以下P4 2.0G以上512M40G以上Windows2000（sp4以上）500人以上双P4 2.0G以上2G80G以上Win2000Server（sp4以上）【腾讯RTX 客户端】企业人数CPU内存硬盘剩余空间操作系统50
6、0人以下PIII800MHz128M以上500M以上Windows2000（sp4以上）500人以上奔腾 1.2GHz以上256M1G以上Win2000、WinXP3.2 最新版本及相关资料下载RTX安装包及使用手册等详细资料除了从安装光盘获取外，也可以通过如下网址下载安装或阅读：把下载的文件解压缩到本地硬盘目录中，获得4个文件：RTX服务端安装文件：RTXSxxx.exeRTX客户端安装文件：RTXCxxx.exeRTX进行二次开发，请使用如下两个SDK开发包：RTX服务端SDK开发包软件：RTXSSDKxxx.exeRTX客户端SDK开发包软件：RTXCSDKxxx.exe3.3 服务器防
7、火墙配置如果安装RTX服务器的机器上有防火墙，需要打开服务器如下端口：1) TCP 8000，登录端口。2) TCP 8003，小文件、多人会话文件传输端口。3) TCP 8880，大文件传输、语音视频端口。4) TCP 8009，客户端程序自动升级端口。5) TCP 8010，组织架构、资料照片、自定义标签等功能实现。6) TCP 8012，快速部署端口。3.4 RTX服务器软件的安装从RTX官方网站下载所有安装软件，下载完成后是一个压缩文件，打开后找到rtxserver2009formal.exe点击运行程序进行安装。安装过程中涉及“阅读许可协议”、“输入服务与许可证” 、“安装路径设置”
8、、“安装后使用者限定”等问题。如图所示：图3.4.1 阅读软件许可协议图3.4.2 选择目标目录图3.4.3 设置服务端界面语言确定了安装路径之后，点击安装即可完成安装。安装完成后，将会自动找到RTX服务管理器进行配置，以前出现超级管理员帐号设置密码将在服务管理器里进行设置，第一次安装的默认密码为空，可以通过重新设置管理员密码进行设置。3.5 RTX客户端软件的安装安装RTXClient之前，先完成RTXServer安装及完成其配置。已安装及配置完成RTXServer的情况下，RTXClient安装的步骤：l 获取RTXClient安装包（有如下方法）通过RTXServer进行获取(因为RTX
9、Server安装包会自带RTXClient)获取方法，通过TX管理器中的快速部署的URL进行获取，如下图中的红色框中显示的地方；图3.5.1 快速部署在IE游览器中打开此即可看到下载客户端安装包的界面，如下图：图3.5.2 快速部署网页通过其它方式，如通过tencent的RTX官方网站运行RTXClient安装包里的 “RTXC2009*.exe”程序进行安装，按默认下一步即可完成安装。通过以上的介绍大家基本是初步了解了RTX这个软件的应用及安装部署情况，当然RTX本身提供了很多的配置操作，其中的一些配置会影响到二次开发。具体的配置及应用如果有兴趣可以查看下面的文档，文档中有比较详细的配置说明
10、。4 RTX二次开发4.1 RTX Server SDK介绍4.1.1 RTX Server SDK概述RTX本身提供了很发好的二次开发接口API。第三方用户可以通过这些API进行自己的业务功能开发。首先要进行二次开发就必须安装RTX Server SDK应用。Server SDK提供给用户一套自己开发应用的接口，让第三方在RTX上开发自己的业务功能：利用SDK接口提供的API 可以在服务器获取RTX现有的c/s协议的消息类型的数据包，从而第三方可以根据需要对数据包进行处理，开发出新的业务。如IM消息监控、第三方短信网关、离线消息、用户详细资料等应用。4.1.2 RTX Server SDK主
11、要功能1、抽取或发送各种消息类型数据包2、接收，发送短信3、关注某些用户或所有用户的状态变化4、文件监控5、部门，用户，权限管理4.1.3 RTX Server 应用体系整体架构图4.1.3.1 应用体系架构图从上图中可以看出来，在AppServer服务后就是业务应用，而二次开发所要做的就是业务应用的开发。下面的图就更加直观的说明了RTX客户端与RTX Server和RTX Server SDK之间的关系。图4.1.3.2 信息流动图4.1.4 RTX Server SDK对象模型图4.1.4.1 对象结构图4.1.4.1 根对象SDK的对象体系中所有的其它对象都需要通过根对象来创建，根对象提
12、供接口IRTXSAPIRootObj。该接口提供创建各其他对象的函数，另外还提供一些通用的查询函数，如查询版本号，查询企业信息，查询用户状态等。4.1.4.2 应用对象应用对象是最为通用的对象，短信对象，状态对象等都可以看作是应用对象的特化 - 即具有某些特殊属性的应用对象。因而应用对象的属性最多，功能也最灵活，通过对属性的设置，可以使应用对象完成其它一些对象胜任的功能。以状态对象为例，它本质上就是一个关注Tencent.RTX.ChangeState类型消息和所有接收者的应用对象。4.1.4.3 消息对象Server SDK对应用和RTX Server之间传输的数据做了一个抽象，并封装成为消
13、息对象。消息对象包含了客户端和应用之间逻辑处理需要的信息，并将它们封装成为消息对象的属性。4.1.4.4 文件监控对象文件监控对象与以上几种对象有所不同，它不和AppServer进行通信，而是和FileServer通信。在一个FileServer上，同一时间内只允许一个文件监控对象存在，如果启动第二个文件监控对象，则第一个对象会被踢掉。文件监控对象没有需要设置的属性。文件监控对象与FileServer之间有一条TCP的长连接，用于传输客户端文件上传通知，以及信令协议传输。下载文件时，将建立新连接下载指定文件。4.1.4.5 用户管理部门管理以及权限管理在Server SDK对象体系中，还提供了
14、另一类对象，用于操作数据库。它们不属于应用对象的类型，不需要向应用服务器注册，启动运行。这些对象是RTXSAPIDeptManager，RTXSAPIUserManager, RTXSAPIRightManager，用于添加，删除，更新数据库里的数据。它们作为根对象的属性，可以直接获取，并进行各种操作。4.2 开发准备工作4.2.1 安装目录文件配置在需要调用SDK的机器上安装Server SDK包。如果RTX Server和SDK调用端安装在不同服务器，需要配置 SDK 服务器IP地址限制规则。打开RTX服务器安装目录下 SDKProperty.XML 中的IP限制选项，并指定合适的值，配置
15、文件中相关内容如下：红色标记的部分就是需要调用SDK的客户端IP。以上的配置是由于SDK的安装与RTX Server不在同一台服务器上，所以需要进行配置，如果在同一台服务器上则不需要配置。如果RTX Server和SDK调用端安装在不同服务器，需要配置Server SDK安装目录下的rtxServerApi.ini ,配置文件中相关内容如下：4.3 JAVA语言二次开发RTX的二次开发有多种语言平台的，而JAVA自然也在其中。RTX提供了部分JAVA语言的RTX操作接口，在进行应用开发的时候在需要的时候进行调用。RTX对于JAVA提供了哪些接口？对于JAVA二次开发需要配置哪里环境？下面就针对
16、这些进行详细的说明。4.3.1 JAVA二次开发环境配置如果需要JAVA的二次开发还需要配置以下的内容：进入Server SDK安装目录(默认路径：x:Program FilesTencentRTXSSDK)，把该目录下的dll文件及rtxServerApi.ini拷贝到系统的System32目录下（RTX2008Beta2之后的RTX版本安装时已经自动拷贝到该目录下），如果在网页调用java接口，需要另拷贝一份到JDK的bin目录下。如果在weblogic或Tomcat下进行部署开发的话，需要将SDK安装目录 下的所有DLL文件拷贝在Weblogic服务器的weblogic92serverb
17、in目录或者Tomcat服务器的bin目录下。否则会报找不到SDK的异常，无法进行接口的调用。RTXSvrApi.java是一个类库，里面封装了很多RTX操作的方法，主要是提供方法给外部调用。这个类是我们在JAVA二次开发时会大量使用到的，所以这个类一定要与其他调用类包在同一级下，即此类的包路径只能是src/rtx，如下图所示：而且此类的包路径必须是这样，否则会报找不到类等异常。RTX二次开发可以支持多种语言，其中官方提供最多的为VB和.NET环境下的开发。以下就是VB开发调用的对象：1. 根对象2. 应用对象3. 消息对象4. 状态对象5. 短信对象6. 文件监控对象7. 部门管理对象8.
18、用户管理对象9. 权限管理对象10. 扩展状态对象11. 用户认证对象12. 组织架构对象13. 其他对象以上的这些对象基本上都是以VB进行开发设计的，在此我们只对JAVA语言的开发进行说明，在以上的二次开发的功能中也有许多是用JAVA可以完成的。主要有以下内容：1. 部门用户管理(数据同步)，可以对RTX服务器的部门及用户进行操作，通过该操作可以实现从其他系统同步用户数据到RTX服务器。2. 单点登录，登录OA或ERP时RTX客户端自动登录，不需要输入密码。3. 待办事宜提醒,办公提醒，邮件到达提醒、公文到达提醒等。4. 手机短信，向手机发送、接收短信，群发短信。5. 状态推送，在网页上显示用户状态头像，并可以对在线用户发起会话。下面我们就针对以上的内容对二次开发进行说明。