RTXServerSDKJava语言支持文档解析.docVIP

RTX Server SDK Java语言开发指导 目 录 RTX Server SDK Java语言开发指导 1 一、功能说明 2 二、配置环境 2 三、文件说明 3 四、开发向导(以Eclipse为例) 3 五、接口说明 5 1．系统函数 5 2．扩展函数 7 六、RTX2010与RTX3.61 Java语言支持的差异 11 七、BUG解决 12 2010 Java SDK 可以实现以下五大功能： 1． 部门用户管理(数据同步)，可以对RTX服务器的部门及用户进行操作，通过该操作可以实现从其他系统同步用户数据到RTX服务器。 2． 单点登录，登录OA或ERP时RTX客户端自动登录，不需要输入密码。 3． 待办事宜提醒,办公提醒，邮件到达提醒、公文到达提醒等。 4． 手机短信，向手机发送、接收短信，群发短信。 5． 状态推送，在网页上显示用户状态头像，并可以对在线用户发起会话。 二、配置环境 1． 在开发机器安装RTX2010 Server SDK包。 2． 进入Server SDK安装目录(默认路径：x:\Program Files\Tencent\RTXSSDK\)，把该目录下的dll文件及rtxServerApi.ini拷贝到系统的System32目录下（RTX2008Beta2之后的RTX版本安装时已经自动拷贝到该目录下），如果在网页调用java接口，需要另拷贝一份到JDK的bin目录下。 3． 进入RTX服务器安装目录下，用记事本打开SDKPorperty.xml文件，在里面增加开发机器地址(如下图所示)，保存后重启RTX服务。 4． 拷贝Java目录(默认路径：x:\Program Files\Tencent\RTXSSDK\Demo Source\Server Sample\Java)下的RTXSvrApi.java及其他示例文件到您的工作目录下。 三、文件说明 RTXSvrApi.java是一个类库，里面封装了很多方法，但没有main函数，因此该文件只能编译不能运行，主要是提供方法给外部调用。 RTXSvrApi.java 文件里面导入 SDKAPIJava.dll，该dll是在SDKAPIC.dll上面封装，SDK目录下的dll相互有联系，因此必须把这些dll拷贝到System32下，否则编译RTXSvrApi.java将出错，提示找不到SDKAPIC。 Java目录下的文件除了RTXSvrApi.java，其他的都是示例文件（请参看示例文件使用各种函数）。 RtxServerApi.ini 文件用于设置服务器的IP地址及端口。 SDKPorperty.xml 文件用于SDK访问RTX服务器权限管理，只有这个文件添加的IP才能访问RTX服务器。 四、开发向导(以Eclipse为例) 启动Eclipse ，创建一个空白的Java Project，如下图所示： 在工程src添加一个名为rtx的package，并将RTXSvrApi.java拖进这个package，如下图所示：  注意：RTXSvrApi.java只能放进rtx下，rtx 不能有父package，否则会报错。 3. 把SetSvrIpPort.java拖到src，自动生成一个(defalt package)并放在这个目录下，SvrIP填写正确的RTX服务器IP地址后按Ctrl+F11运行，如下图所示： 4. 把AddDept.Java拖到src，自动生成一个(defalt package)并放在这个目录下，按Ctrl+F11运行，如下图所示： 5. 进入RTX 用户管理器，就可以看到刚刚添加的部门，如下图所示： 五、接口说明 1．系统函数 语法：boolean Init() 功能：初始化类 参数：无 调用：Init() 说明：初始化RTXSvrApi，成功返回true，失败返回false 语法：void UnInit() 功能：析构类 参数：无 调用：Init() 说明：析构RTXSvrApi 语法：int GetNewObject(String szObjectName) 功能：获取一个业务对象句柄 参数：szObjectName 业务对象名称 调用：GetNewObject(OBJNAME_RTXSYS) 说明：调用成功返回一个业务对象句柄 语法：int GetNewPropertys() 功能：获取属性集合句柄 参数：无 调用：GetNewPropertys() 说明：调用成功返回一个属性合集的柄 语法：int ReleaseHandle(int iHandle) 功能：释放句柄 参数：iHandle 句柄 调用：ReleaseHandle(iHa