D

dw-example

陈刚提交了 · cf5d48b4 merge from dev

dw example 使用手册

数据格式

  • OBJ:传统的JSON格式,返回数组包含严格的 key:value

  • SL:修剪过的JSON格式,字段名称和字段值分别分开存储在不同数组中,格式如下

    {
    "headData": [
            "currency_id",
            "currency_code",
            "currency_name"
        ]
    },
    "columnDataList": [
        [
            14186,
            "USD",
            "美元"
        ],
        [
            14187,
            "USD",
            "美元"
        ],
        ...
    ]    
    }

    因为SL格式每次数据交互只序列化一次key,和传统的JSON结构相比。生成的JSON字符串长度会缩小20% ~ 40%, 但相对的比较难解析,可以在DwParamVo中指定格式。

修改配置文件

修改 application.yml 的 dwAppIddwAppSecret 配置

  • dwAppId:傲基数仓 APP 模块的 AppId。

  • dwAppSecret:傲基数仓 APP 模块的 应用秘钥。

提供三种数据请求方案

  • 全量请求:一次http请求获取所有数据,有数量限制,最大3000条。适合小批量数据同步。

  • 分页请求:多次http请求获取所有数据,分页参数pageNumber, pageSize(取值范围[1,3000]). 适合中批量数据同步。

  • 流式请求:一次http请求获取所有数据,没有数量限制,要求网络稳定,最好是内网环境。适合大批量数据同步。

token更新

TokenJob 为tokne更新定时任务

TokenController token更新回调地址

定时任务定点调用dw服务刷新token api,然后dw将最新token作为参数调用数仓平台上对应的APP配置 的回调地址,将token传递给客户端。

如何使用

  1. 申请API

  2. 启动项目

  3. 访问 http://localhost:8099/swagger-ui.html

  4. 源码 demo 在 TestApiController

Demo by wgf.