Java数据源

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

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数据源节点，在更多操作选择 新建Java数据集对象（S），如图：

界面介绍

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

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

操作步骤

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

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