Java数据源

Java数据源是指由用户通过二次开发，编写JavaQueryData接口实现类，以实现自定义数据结构的一类数据源。

Java数据源不同于关系数据源和多维数据源之处为：Java数据源允许没有一个物理数据库存储其字段和数据，比如可以通过类将任意一个含有数据的文件或报表通过解析后，运用到Smartbi中，当然它也允许对数据库中的数据查询出来通过Java代码进行二次计算加工后返回给Smartbi。

下图显示了从Java数据源到分析报表定制的整个流程，其中红色虚线标识的部分为新建Java数据源连接的流程。

Java数据源等同于一个分类目录节点，用于存储Java数据集对象，因此在新建Java数据源连接的流程中，“新建Java数据集对象”为新建Java数据源连接的核心环节。

下面介绍如何创建Java数据源、如何创建Java数据集对象，使用二次开发的类并获取数据。

新建Java数据源

新建Java数据源相当于新建一个Java数据源的分类目录节点。

1、选择系统导航栏的 数据连接 ，或者选择系统快捷菜单 数据连接，如图：

2、在“数据连接”界面主菜单选择 本地数据库 > Java数据源 ，如图：

“新建Java数据源”界面如图：

各界面配置项说明如下：

新建Java数据源，此Java数据源只是作为一个目录节点，存储Java数据集对象，因此Java数据源本身并无太多配置项。

建立好Java数据源之后，即可进行下一步 新建Java数据集对象。

Java数据集对象是指通过加载并解析系统内置的类文件或用户自定义的类文件而获取的结果，包括参数和结果集，是进行Java数据集所需的对象。

新建Java数据集对象即是配置自定义类名和获取参数与结果集的过程。

选中已新建的Java数据源节点，在更多操作选择 新建Java数据集对象（S），如图：

进入“新建Java数据集对象[Java]”界面，该界面主要分为两个区域：

基本信息区：该区主要用于设置Java数据集对象的名称和需要加载的类名。
其中系统内置了CSV查询、TXT查询、JavaScript查询和webService查询几个类，也可以输入用户自定义的类名，选择类名后，单击该区的获取默认配置按钮，系统自动到类文件存放的路径下加载并解析类。
配置信息区：该区主要用于显示解析类后需要输入的参数及返回的结果。

新建Java数据集对象时，设置步骤如下：

步骤	说明
1、设置名称、别名、描述等基本信息
2、选择类名	可以选择内置的CSV查询、TXT查询、JavaScript查询、WebService查询；也可以直接输入自定义的类名。 1）选择内置的类 2）输入自定义类名在输入自定义类名之前，需要先参考二次开发文档，编写IJavaQueryData接口实现类，实现自己的JAVABean逻辑，并将编译好的class文件添加到系统中。在JAVA数据集对象界面中，直接输入自定义的类的类名，如下：需要先把txt文件上传到服务器上，文件存放路径不限，只要是服务器能访问的路径就可以。文件路径为绝对路径。上传的文件如果没有列头，则默认第一行数据为列头。
3、设置配置项	在选择类名之后，点击右侧的获取默认配置，在配置信息中会出现java类中定义的一些配置信息，对此进行配置。如下：
4、获取参数与结果集	配置完毕之后，需要点击获取参数与结果集按钮，获取到根据配置项和java类代码，得到的参数和结果字段数据。
5、保存Java数据集对象	保存此Java数据集对象，即可基于此Java数据集对象，新建Java数据集，并应用于报表中。关于Java数据集的创建方法，详情请参考 Java数据集。

关注我们

服务支持