历史版本6 :数据工厂数据集 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 描述编辑

插件地址 :数据工厂 V9.0 版 数据工厂 V10.0 版

应用场景:

对 FR 的程序数据集接口进行改善和封装(解决原来的程序数据集配置项难剥离代码的问题,解决了原来程序数据集复用率低的问题,解决了原来程序数据集在动态参数时无效的问题)

该插件安装后,提供了额外的取数接口。将 FR 的数据集逻辑,再次切割为两个部分:

  • 从数据来源装载数据——装载器

  • 将装载到的数据组装成FR支持的数据模型——解析器

插件内置了两个装载器和一个解析器分别是:

装载器:

  • 参数装载器——数据通过参数直接传入(比如 JSON、XML 等等的结构化数据)

  • 网络数据装载器——通过配置相关请求,从 Web 装载数据(比如 JSON 服务、WebService 服务等等)

解析器:

1)JSON 解析器——对结构化的 JSON 文本进行解析,生成FR支持的数据模型(只能解析结构型描述的 JSON,业务型描述的 JSON 无法解析,业务型 JSON,解析依赖具体的业务的描述,需要单独实现解析器)

2)WS 解析器——解析 WS 服务的响应(目前还没开发完善,等待更新)

3)爬虫解析器——支持 JQ 的选取语法和描述(目前还没开发完善,等待更新)

要求:具备最基础的 FR 的插件开发能力【当然,后续我这边会持续的上传一些比较常用的解析器和装载器的插件】


2. 操作流程编辑

下面是内置的实现:
222

HTTP 装载器中(支持${}参数和公式写法)

URL 和 charset 就不必说了

type 支持 GET POST JSON这 3 种

properties 是对一些特殊请求需要用到的(比如需要在 Header 中携带一些认证属性呀,Cookie 呀等等的)

222
单参数装载器中:直接通过 data 进行数据的带入
222

JSON 解析器:(简单实现,不支持业务型描述的 JSON)

dataPath: 就是待展示数据的节点(可能并不是所有的数据都要展示,这个是原生实现的,比较简单,不支持 JPath 的写法)

showmap:因为 JSON 数据字段很多都是一些路径的描述,对于作模板看起来会比较吃力,提供一个字段名转义的配置:

比如 path1_key1 path1_key2 这两个字段分别对应姓名,年龄 则写法如下

path1_key1,姓名,path1_key2,年龄 即可


下面是装载器和解析器的接口:

1)装载器接口

package com.tptj.plugin.hg.fun;
import com.fr.script.Calculator;
import com.fr.stable.ParameterProvider;
import com.fr.stable.fun.mark.Mutable;
public interface Loader extends Mutable {
    
    String XML_TAG = "TableDataLoader";
    int CURRENT_LEVEL = 1;
    
    /**
     * 装载数据
     * @param cal   当前算子
     * @param params    需要用到的参数
     * @param others        其他你可能用到的但是又不希望通过参数控制的配置项
     * @return  保存数据的对象
     */
    public Object load( Calculator cal, ParameterProvider[] params, String others);
    
    /**
     * 装载器的名字【显示在数据工厂配置界面的下拉列表里面的】,唯一
     * @return
     */
    public String getName();
    
    /**
     * 
     * @return 默认显示的配置【显示在数据工厂配置界面装载器配置文本域里面的,配置项自定义,其实就是放一些,不想写死在代码里,又不希望被参数篡改的部分】
     */
    public String getDefaultConfig();

2)解析器接口

package com.tptj.plugin.hg.fun;
import com.fr.stable.fun.mark.Mutable;
import com.tptj.plugin.hg.stable.SimpleDataModel;
public interface Resolver extends Mutable {
    
    String XML_TAG = "TableDataResolver";
    int CURRENT_LEVEL = 1;
    
    /**
     * 解析数据
     * @param data 从装载器得到的原始数据
     * @param others  解析时会使用,但是不希望是参数的配置
     * @return 解析出来的二维数据模型
     */
    public SimpleDataModel parse( Object data, String others );
    
    /**
     * 解析器的名字【显示在数据工厂配置界面的下拉列表里面的】,唯一
     * @return
     */
    public String getName();
    
    /**
     * 
     * @return 默认显示的配置【显示在数据工厂配置界面解析器配置文本域里面的,配置项自定义,其实就是放一些,不想写死在代码里,又不希望被参数篡改的部分】
     */
    public String getDefaultConfig();

plugin.xml 注册

<extra-core>
    <TableDataLoader class="com.tptj.plugin.hg.tabledata.factory.core.loader.HttpLoader"/>
    <TableDataLoader class="com.tptj.plugin.hg.tabledata.factory.core.loader.SingleParamLoader"/>
    <TableDataResolver class="com.tptj.plugin.hg.tabledata.factory.core.resolver.JSONResolver"/>
</extra-core>