【已下架插件文档】数据查询事件版

该插件目前已下架帆软市场，本文档仅提供给历史使用了该插件的客户，帆软目前不再提供该插件的任何获取渠道。

 

功能：在实际业务需求中，我们往往需要在数据集取数之前或者完成后执行某些我们业务特殊的操作~比如埋点、预处理、过滤等等操作。该插件就是提供取数前后的自定义事件处理

 

使用方法：

1. 安装插件

2. 根据你的需要实现事件接口，编译后保存到WEB-INF/plugins/plugin-com.tptj.plugin.hg.event.db.v10-1.0/classes目录下

3. 配置resources目录下的dbevent.xml(配置方法后面会介绍)

4. 使用数据查询事件版数据集来建数据集，更数据库查询一样的方法写好SQL和参数之后，后续换行写

             TPTJ_EVENT{EventName1(Conf1)}TPTJ_EVENT_END

             TPTJ_EVENT{EventName2(Conf2)}TPTJ_EVENT_END

              ...

   来调用事件（现在看不懂不要紧后面会介绍具体的意思）

 

详解：

    1.需要实现的接口类 com.tptj.plugin.hg.fun.AbstractSQLEvent 需要依赖插件的JAR包

       实现其中的方法

                    public boolean run(String conf,Connection conn,Calculator calculator);

                    conf：事件的配置参数

                    conn：改数据集的数据源链接（不要在事件中关闭，否则会造成取数异常）

                    calculator：当前计算的算子。

                    返回值：是否需要继续计算后续的同类事件（一个数据查询中可以有多个事件的）

    2.简单的例子

       一个用于取数前执行，一个用于取数后执行

看这里我们还看不出来怎么控制哪个在取数前哪个在取数后，往后看

 

3.dbevnet.xml介绍

            class就是上面接口类的实例，

    name就是给事件取一个名字【唯一】，

    type 0/1分别代表SQL执行前后，

    conf代表配置的默认参数，假设你定义了默认参数，SQL事件写的是TPTJ_EVENT{EventName()}TPTJ_EVENT_END则会使用这个默认的参数

    autorun 设置为true时，代表这个事件为默认事件，默认事件不能显示的调用，所有的数据集执行时都会自动执行默认事件

    默认事件跟普通事件一样可以有多个，执行顺序是按配置先后顺序执行

 

效果图

数据集的位置

默认事件的测试

手动添加事件（默认事件也会执行）