RSuite 的 开发与调试

基于 RSuite-3.6.0-rc22-setup.jar版本的server开发和调试

1. 通过web service实现新的RSuite plugin时，通过extends DefaultRemoteApiHandler来达到扩展的目的。否则会出现java.lang.AbstractMethodError错误，发生RSuite版本中类的兼容问题。

2. 配置rsuite-plugin.xml
配置web service时，通过制定id 属性设置 web service的标识符，不要通过name属性设置 web service的标识符。

<remoteApiDefinition
			id="acmepublishing.get-time"
			handler="com.acmepublishing.webservice.GetTimeHandler"
			description="report server time">
		</remoteApiDefinition>

3. 在ecipse里关联tomcat调试RSuite plugin时，应选择tomcat 5.5 版本。

4. 附件 my-rsuite-plugin.rar: RSuite plugin的调试例子。

5. RSuite 3.3.4连接MarkLogic 4.2.2时,使用xcc.jar与MarkLogic进行通信时,会因为xcc.jar版本与MarkLogic 4.2.2不兼容,出现用户无法登陆MarkLogic问题,进而影响RSuite与MarkLogic通信,使用户无法登陆RSuite.

6. RSuite 3.3.4, 配置ASTD项目里的scripts\setenv.bat里的RSUITE_HOME路径值时,应将它指向当前RSuite中包含clients\admin内容的路径.

7. 导入工作流时,必须在MySQL数据库中根据Rsuite3.34\rsuite-core\src\java\rsuite-sql\mysql\jbpm中的脚本建立jbpm相关的一组表.
如果不导入与jbpm相关的一组表,会导致RSuite的Inbox界面里出现error提示。

8. 为 RSuite 3.5.2 and 3.5.4 定义MarkLogic的XDBC server时，需要将default xquery version设为 0.9-ml。否则会出现RSuite发送给MarkLogic的XQuery语法无法正常解析，导致错误抛出。

9. for triumph learning, 在eclipse编译完源代码后,依次运行ant build.xml里的各个task，然后依次运行如下批处理命令。

a.	Lmd.bat
b.	Load_icore_lmd.bat
c.	Load_all_dtds_and_schemas.bat
d.	Load_activity_dtd.bat
e.	Run_configure_hotfolders.bat
f.	Run_load_workflows.bat 

按如上所述的步骤，可以使student guide 的hotfolder正常运行。
参考文档： F:\study\triumph\triumph\docs\installation\Rsuite_Server_Install.doc