◆ 实例请参考API实例 / 自定义类 / 自定义远程服务
接口介绍:
远程服务器相当于客户端和服务器之间的一个中间层,这个中间层避免了客户端直接访问服务器,通过该中间层实现了用户权限的控制。为方便用户对报表设计器中远程服务器功能的自定义修改,润乾报表提供了com.scudata.ide.custom.Server接口。可通过实现该接口将远程服务植入报表中。
方法介绍:
getName
语 法: public String getName()
功能说明: 获取服务器名称
Returns : 服务器名称
setName
语 法: public void setName(String name)
参数说明: name 服务器名称
功能说明: 设置服务器名称
Returns : 空
getUrl
语 法: public String getUrl()
功能说明: 获取服务器URL
Returns : 服务器URL
setUrl
语 法: public void setUrl(String url)
参数说明: url 服务器URL
功能说明: 设置服务器URL
Returns : 空
login
语 法: public boolean login(String user, String pwd)
参数说明: user 用户名
pwd 密码
功能说明: 登录服务器
Returns : true表示登录成功,false表示登录失败
open
语 法: public InputStream open(String fileName)
参数说明: fileName 服务器端文件名
功能说明: 打开文件生成文件流
Returns : 文件流
save
语 法: public void save(String fileName, byte[] fileBytes)
参数说明: fileName 服务器端文件名
fileBytes 文件转成的字节数组
功能说明: 保存文件到服务器
Returns : 空
save
语 法: public void save(String fileName, File localFile)
参数说明: fileName 服务器端文件名
localFile 本地文件名
功能说明: 上传本地文件到服务器
Returns : 空
listFiles
语 法: public List<FileInfo> listFiles(String path)
参数说明: path 目录路径,path=null或/时表示服务器根目录
功能说明: 返回指定目录下的文件信息
Returns : 指定目录下的文件信息
getDBConfigList
语 法: public List<DBConfig> getDBConfigList()
功能说明: 获取当前用户可用的数据源配置
Returns : 数据源列表(用户有权限访问的)
logout
语 法: public void logout()
功能说明: 注销
Returns : 空
接口使用说明:
相关配置文件: reportsystemconfig_zh.xml
操作步骤:
1)自定义类实现com.scudata.ide.custom.Server接口
2)将自定义类放到设计器类路径下
3)配置文件位置:【产品安装根目录】\report\config\reportsystemconfig_zh.xml
4)在此配置文件下的<CONFIG />标签中增加Server属性,属性值为用户自定义类路径
按照上述步骤配置完成后,重启润乾报表设计器,报表主菜单中会显示“远程服务”菜单,如下图:
l 登录
服务器名称——指定服务器名称,不能与已经登录的服务器重名。
URL——指定登录服务器的URL。支持HTTP路径或绝对路径,格式如http://192.168.9.147:8080/demo、“D:/remoteserver/test”。
用户名/密码——访问远程服务器填写可用的用户名和密码。
保存密码——指定当前密码是否保存。
自动登录——指定当前服务器是否自动登录。
l 注销
点击注销菜单后,服务器下拉框中默认为当前使用的服务器,用户可通过下拉框选择要注销的服务器,选择后点击注销,则与服务器断开,并在左侧资源文件树上移除该服务器上的资源。
l 连接数据源
可以通过服务器下拉框选择需要打开的远程服务数据源,选中数据源可进行连接、断开操作。
l 上传文件
上传服务器——默认显示当前使用的服务器,还可通过下拉框选择需要上传的目标服务器。
选择节点——文件上传的目标位置,默认是服务器根目录”\”。
选择文件——选择需要上传的文件,支持上传一个或多个文件。