此文档说明如何使用Smartbi服务器端SDK.
Smartbi 服务器端SDK通过JAVA API提供:CatalogService、Systemconfig、OperateionLog、SimpleReportService、ManageReportService、AnalysisReportService以及UserManagerSerive七项服务接口。
1. CatalogService: 提供资源目录树的访问功能等。
2. Systemconfig: 系统设置相关操作功能。
3. OperateionLog: 提供操作日志相关操作功能
4. SimpleReportService: 提供灵活报表相关操作功能。
5. ManageReportService: 提供业务报表相关操作功能。
6. AnalysisReportService: 提供多维分析相关操作功能。
7. UserManagerSerivce:提供用户相关操作,包括:读取/维护用户信息、读取/维护组信息、读取/维护角色信息、为用户和组分配角色等。
布署步骤:
1. 假设Smartbi服务器已经部署到应用服务器中,访问地址为:http://server:8080/smartbi/vision。
2. 打开服务器部署文件smartbi.war,解压后将smartbi.war\WEB-INF\lib\目录下的smartbi-SDK.jar、smartbi-Common.jar、commons-logging-1.1.jar、ezmorph-0.8.1.jar、commons-beanutils.jar、commons-collections-3.2.2.jar 包加入到您的JAVA项目的classpath中去。
使用说明:
1. 创建应用连接器。在跟Smartbi服务器进行任何通信之前必须先创建一个ClientConnector对象,即应用链接器。客户代码仅需要创建一个ClientConnector实例。
例如:
String connectorURL = "http://localhost:8080/smartbi";
ClientConnector conn = new ClientConnector(connectorURL);
conn.open("username", "password");
2. 创建服务对象。以ClientConnector为构造函数参数,创建是将之前的ClientConnector实例传入。
例如:
CatalogService catalogService = new CatalogService(conn);
UserManagerService userService = new UserManagerService(conn);
3. 使用服务对象。在获得服务对象后就可以进行所需的操作了,具体的用法请参考
示例。
4. 关闭应用连接器。操作完毕后必须关闭应用连接器,最好采用finally结构,例如:
try{
//操作服务对象
}catch(RemoteException e){
e.printStackTrace();
}finally{
//关闭应用连接器
conn.close();
}
5. 错误处理。SDK提供RemoteException对来自smartbi服务器的异常进行封装。需要注意的是,RemoteException是一个RuntimeException,因而不会显示要求进行处理,如果需要严格的错误处理可以使用try-catch结构。