当前位置：首页 > article >正文

开发培训：慧集通（DataLinkX）iPaaS集成平台-基于接口的组件开发

article 2025/1/7 15:21:10

以聚合数据中的免费接口进行举例

聚合数据https://www.juhe.cn/

接口组件开发

组件创建

基于接口的组件开发讲解https://www.bilibili.com/video/BV1xy6BYZEWP/?vd_source=ffebc06439df75565840848480963c6c

基于Http接口的组件开发

组件新建https://www.bilibili.com/video/BV1yy6BYZEUA/?vd_source=ffebc06439df75565840848480963c6c

1.1 拖拽http组件，流程页签下拖拽平台页签【基础组件-http】组件

组件常规页签说明

文本：当前组件重命名

版本：组件发布版本号，按日期降序排序

标识：设置组件唯一标识，可为空

日志选项：用于调试阶段组件控制台日志输出；转JSON用于日志参数为Json 格式；如图：

1.2 http组件内部说明

①接口请求方法：GET、POST、PUT、DELETE；方法说明：

接口请求的六种常见方式详解（get、post、head等）https://blog.csdn.net/QingQingKK/article/details/110211364

②接口地址设置，方式分为两种：

方法一：固定写法，如图：

方法二：动态写法

1、通过应用实例配置

1.1、配置应用实例

基于接口的应用开发（不需要认证机制）

1.2、引用实例参数

常量中处理方式：#{$SuiteProps.实例参数编码}，如图：

表达式处理方式：$SuiteProps.实例编码，如图：

2、通过流程参数调用

2.1、定义流程参数，配置编码、环境路径及说明

2.2 引用流程参数

③接口返回格式：JSON、XML、TEXT、FILE

http配置页签说明

1.1、接口连接超时及读取超时时间设置，通过调用流程参数中的值决定；

1.2、平台内各环境连接时间默认为10000毫秒

组件入参定义及应用

流程入参引用https://www.bilibili.com/video/BV1xy6BYZEWm/?vd_source=ffebc06439df75565840848480963c6c

接口出参结果处理

1、流程页签拖拽【平台页签-基础组件-Groovy】，通过【常规】中文本为组件重新命名；

代码示例

// 引入jar包
import com.onboxs.ofw.core.exception.OfwRuntimeException

return {$$ ->

        //前置节点结果赋值给PRB
        def PRB = $$.$PRB
        
        //如果PRB结果中的error_code（返回码） 不等于0 ，则将PRB中的reason（返回说明）结果输出到控制台
        if(PRB['error_code']!=0){
                throw new OfwRuntimeException(PRB['reason'])
        }
        
        //将PRB中的result（返回结果集赋值给变量$Reutlt）
        $$.$Result = PRB['result']
        
}

组件出参定义

1.1、根据控制台中【出参结果处理】组件输出内容定义，如图（控制台输出内容，第4行文本【天气查询!Http > 出参结果处理中的JSON 】）

2022-12-28 16:36:30 INFO 02001725 [n_c_1] com.onboxs.bridge.agent.service.impl.FragmentServiceImpl : Begin【Manual】
2022-12-28 16:36:31 INFO 02001725 [n_c_1] N 天气查询!Http!Groovy : the url is http://apis.juhe.cn/simpleWeather/query?city=%E9%83%91%E5%B7%9E&key=c13cda9c0210ee52c5dab6c0c6e6b626
2022-12-28 16:36:31 INFO 02001725 [n_c_1] N 天气查询!Http!Groovy : headers is null
2022-12-28 16:36:31 INFO 02001725 [n_c_1] N 天气查询!Http > 出参结果处理 : 【出参】 - {"abort":false,"body":{"realtime":{"wid":"00","temperature":"6","direct":"南风","aqi":"48","humidity":"29","power":"3级","info":"晴"},"city":"郑州","future":[{"date":"2022-12-28","wid":{"night":"00","day":"00"},"temperature":"-4/7℃","weather":"晴","direct":"南风转西南风"},{"date":"2022-12-29","wid":{"night":"00","day":"00"},"temperature":"-5/7℃","weather":"晴","direct":"东风转西南风"},{"date":"2022-12-30","wid":{"night":"00","day":"00"},"temperature":"-3/8℃","weather":"晴","direct":"南风转西南风"},{"date":"2022-12-31","wid":{"night":"02","day":"01"},"temperature":"-1/10℃","weather":"多云转阴","direct":"西南风转西风"},{"date":"2023-01-01","wid":{"night":"02","day":"02"},"temperature":"-1/7℃","weather":"阴","direct":"东北风"}]},"code":"200","success":true}

2022-12-28 16:36:31 INFO 02001725 [n_c_1] com.onboxs.bridge.agent.service.impl.FragmentServiceImpl : End【Manual】

1.2、通过JSON格式化工具处理，复制json中body中的内容，并在出参页面进行逆向解析

Json.cnhttps://www.json.cn/注：逆向解析出参名称需自行维护