云智开发平台

# 数据网关

本平台的数据源主要分为以下两部分：

  1. 数据网关配置，直接配置SQL查询方案，通过数据网关引擎来执行。
  2. 后台动态脚本服务开发，在后台服务IDE中通过JavaScript来开发，进行逻辑处理和数据组装。

# 数据网关配置

数据网关是由服务和数据方案组成的，一个服务可对应一个或者多个数据方案，当一个服务对应多个数据方案的时候，要求多个数据方案的数据库配置保持一致。配置一个完整的数据方案，需要以下三个步骤：

1、配置数据库连接

勾选数据类型，根据数据类型配置项填写数据库配置信息并进行连接测试

数据库配置

2、配置数据服务 填写服务名称和服务描述信息

服务配置

TIP

服务名是调用数据网关接口的唯一标识，请规范服务名和服务描述

3、配置数据方案 用于新增数据方案或者关联已有的数据方案 数据方案有读配置和写配置两种

  • 读配置
    • 编写sql语句，遵循标准的sql语法，其中参数形式如 :x，x为参数名称
    • 点击入参和出参后动态解析参数，并补充参数描述

读配置

  • 写配置
    • 点击更新配置，填写操作对象名称，操作对象名称为数据库中表名
    • 然后点击解析列，将解析出表的列名
    • 勾选业务中的主键和需要更新的列保存即可

写配置

TIP

在读配置中，参数名区分大小写，参数值中应避免特殊字符，例如：' (单引号)

在写配置中，只有勾选了主键和配置了更新列，并且参数必须传输对应的主键值和更新字段值才会进行更新

在写的配置中，可复选复杂更新，该场景用来处理个性化的写操作，可直接在此处编写insert、update、delete操作，多编写多个语句，以分号‘；’隔开

# 后台服务开发

后台动态脚本服务的编写遵循JavaScript语法，其中对数据接口、返回结果进行了封装，标准化输出格式，详情见$ResultBody；数据接口的请求封装了$api类，提供get、post、invoke三个方法，详情见$api

# JavaScript脚本兼容性

支持标准的JavaScript脚本语法和类型、函数，暂不支持浏览器对象window,document，附脚本样例：

# 服务参数解析

入参数识别规则：通过识别服务脚本最后一行的main方法的参数来解析入参名称，解析出来的参数将展示在参数参数列表中，如图： 入参解析

TIP

基于以上解析规则，动态脚本的基本结构应如下：

function main(p1,p2){
    //脚本编写内容
}
main(p1,p2)

# 参数列表

参数列表包含入参和出参的设置，入参设置项包括参数类型、参数格式以及参数值，其中参数值的设置是用于在线调试或者运行，以便于快速查看执行的过程和结果；出参规范了统一输出结构，设置项主要包含数据的类型 参数列表

TIP

上例中，入参和出参的类型设置和对用的输入输出值必须对应，能实现值类型的转换，否则会抛出异常信息