RTX2008SDKJava语言支持文档.doc

RTX2008 Server SDK Java语言开发指导 目 录 RTX2008 Server SDK Java语言开发指导 1 一、功能说明 2 二、配置环境 2 三、文件说明 3 四、开发向导(以JCreator为例) 3 五、接口说明 4 1．系统函数 4 2．扩展函数 6 六、RTX2008与RTX3.61 Java语言支持的差异 10  一、功能说明 RTX2008 Java SDK 可以实现以下五大功能： 1． 部门用户管理(数据同步)，可以对RTX服务器的部门及用户进行操作，通过该操作可以实现从其他系统同步用户数据到RTX服务器。 2． 单点登录，登录OA或ERP时RTX客户端自动登录，不需要输入密码。 3． 待办事宜提醒,办公提醒，邮件到达提醒、公文到达提醒等。 4． 手机短信，向手机发送、接收短信，群发短信。 5． 状态推送，在网页上显示用户状态头像，并可以对在线用户发起会话。 二、配置环境 1． 在开发机器安装RTX2008 Server SDK包。 2． 进入Server SDK安装目录(默认路径：x:\Program Files\Tencent\RTXSSDK\)，把该目录下的dll文件及rtxServerApi.ini拷贝到系统的System32目录下（RTX2008Beta2之后的RTX版本安装时已经自动拷贝到该目录下），如果在网页调用java接口，需要另拷贝一份到JDK的bin目录下。 3． 用记事本打开System32下的rtxServerApi.ini文件，把Host改为RTX服务器的IP地址。 4． 进入RTX服务器安装目录下，用记事本打开SDKPorperty.xml文件，在里面增加开发机器地址(如下图所示)，保存后重启RTX服务。 5． 拷贝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服务器。 四、开发向导(以JCreator为例) 启动JCreator ，创建一个空白工程，把RTXSvrApi.java和您想调试的示例程序添加进来，如下图所示： 例如把RTXSvrApi.java和AddDept.java添加进来，点击菜单Build- Compile Poject，编译成功后按F5运行工程，即可看到添加部门结果，如下图所示：  3. 进入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(iHandle) //iHandle是一个句柄 说明：调用成功释放句柄 语法：int AddProperty(int iPropertyHandle, String szName, String szVal