云控脚本函数

EC的实例代码

以下是云控实例代码

1
function main() {
2
    //如果自动化服务正常
3
    if (!autoServiceStart(3)) {
4
        logd("自动化服务启动失败，无法执行脚本");
5
        exit();
6
        return;
7
    }
8
    logd("开始执行脚本...{} = {}", ecloud.getDeviceNo(), ecloud.getCloudUrl());
9
    let ts = ecloud.getTaskInfo();
10
    logd(ts);
11
    if (ts == null) {
12
        logd("没有任务信息");
13
        return;
14
    }
15
    logd("任务信息:" + JSON.stringify(ts));
16
    logd(ts["taskName"]);
17
    if (ts.valueJson) {
18
        //获取任务-参数设定中 名称 = haoma  的值
19
        logd("valueJson " + ts.valueJson["haoma"]);
20
        //获取任务-参数设定中 名称 = 账号  的值
21
        logd("valueJson " + ts.valueJson['账号']);
22
        //打印参数
23
        logd("valueJson " + ts.valueJson);
24

25
    }
26

27
    //这里开始编写你要的业务逻辑
28
    clickSettingTask();
29
    sleep(3000)
30
    //对数据进行增删改查、追加和移出一条的演示
31
    dataOptDemo()
32

33
}
34

35
/**
36
 * 打开设置按钮
37
 **/
38
function clickSettingTask() {
39
    //这里模拟业务逻辑
40
    sleep(4000);
41

42
}
43

44
function dataOptDemo() {
45
    // 按照组名获取数据
46
    let data = ecloud.getData({
47
        "groupName": "账号组2"
48
    });
49
    if (data) {
50
        logd("账号组2数据: " + JSON.stringify(data));
51
    }
52

53
    //组名+指定的数据名 获取数据
54
    data = ecloud.getData({
55
        "groupName": "账号组2",
56
        "dataName": "001-1112"
57
    });
58
    if (data) {
59
        logd("账号组2数据 + dataName : " + JSON.stringify(data));
60
    }
61

62
    // 模拟上传数据
63
    let d = ecloud.addData({
64
        "groupName": "账号组2",
65
        "dataName": ecloud.getDeviceNo() + "-111",
66
        "content": "xxx" + new Date()
67
    });
68
    logd("第一次创建账号组2 数据结果 - " + d)
69

70

71
    //模拟更新数据
72
    let update2 = ecloud.updateData({
73
        "groupName": "账号组2",
74
        "dataName": ecloud.getDeviceNo() + "-111",
75
        "content": "牛逼" + new Date()
76
    });
77
    logd("更新 数据结果 - " + d)
78
    sleep(3000)
79

80
    //按照组 + 数据名移出数据
81
    // let remove2 = ecloud.removeData({
82
    //     "groupName": "账号组2",
83
    //     "dataName": ecloud.getDeviceNo() + "-111"
84
    //
85
    // });
86
    // logd("组+数据 移出 数据结果 - " + remove2)
87

88
    //按照组 + 数据名移出数据
89
    let remove3 = ecloud.removeData({
90
        "groupName": "账号组2"
91

92
    });
93
    logd("组 移出 数据结果 - " + remove3)
94

95
    //再次演示创建数据
96
    let d2 = ecloud.addData({
97
        "groupName": "账号组2",
98
        "dataName": ecloud.getDeviceNo() + "-111",
99
        "content": "星星xxx" + new Date()
100
    });
101
    logd("第二次创建账号组2 数据结果 - " + d2)
102
    sleep(3000)
103
    //这里演示 进行增加数据
104
    let append1 = ecloud.appendOneLineData({
105
        "groupName": "账号组2",
106
        "dataName": ecloud.getDeviceNo() + "-111",
107
        "content": "我是要增加的数据1"
108
    });
109
    logd("追加数据 数据结果 - " + append1)
110

111
    // 第二次追加数据
112
    let append2 = ecloud.appendOneLineData({
113
        "groupName": "账号组2",
114
        "dataName": ecloud.getDeviceNo() + "-111",
115
        "content": "我是要增加的数据2"
116
    });
117
    logd("追加数据 数据结果 - " + append2)
118

119
    //第一次移出数据
120
    let removeline1 = ecloud.removeOneLineData({
121
        "groupName": "账号组2",
122
        "dataName": ecloud.getDeviceNo() + "-111",
123
        "content": "我是要增加的数据1"
124
    });
125
    logd("删除一条 数据结果 - " + removeline1)
126
    sleep(3000)
127
}
128

129

130
function autoServiceStart(time) {
131
    for (var i = 0; i < time; i++) {
132
        if (isServiceOk()) {
133
            return true;
134
        }
135
        var started = startEnv();
136
        logd("第" + (i + 1) + "次启动服务结果: " + started);
137
        if (isServiceOk()) {
138
            return true;
139
        }
140
    }
141
    return isServiceOk();
142
}
143

144
main();

基础操作

ecloud.log 发送日志

发送日志到云端
@param msg 日志信息

1
function main() {
2
   ecloud.log("我是CLOUD日志")
3
}
4

5
main();

ecloud.getDeviceNo 获取机器编号

获取机器编号
@return {string} 机器编码或者null

1
function main() {
2
   var d = ecloud.getDeviceNo()
3
   logd(d)
4
}
5

6
main();

ecloud.getDeviceId 获取设备ID

获取设备ID
适配EC 11.8.0+
@return {string} 设备ID或者null

1
function main() {
2
   var d = ecloud.getDeviceId()
3
   logd(d)
4
}
5

6
main();

ecloud.getCloudUrl 获取云控的URL地址

获取云控的URL地址
@return {string} 云控的URL地址或者null

1
function main() {
2
   var d = ecloud.getCloudUrl()
3
   logd(d)
4
}
5

6
main();

ecloud.getTaskInfo 获取当前任务信息

取得当前任务的信息，当前任务已经被推送到本地了，直接获取
@return {json} 对象

1
function main() {
2
   var d = ecloud.getTaskInfo()
3
   logd(d)
4
}
5

6
main();

返回值示例
taskId: 云端主任务ID
taskName: 云端主任务名称
scriptId: 脚本的云端ID
scriptName: 脚本名称
scriptVersion: 脚本的版本号
scriptName: 脚本名称
scriptUrl: 脚本的地址
valueJson: 附加参数
任务信息函数返回的值

1
{
2
   "taskId": "1",
3
   "taskName": "X手浏览",
4
   "sort": 3,
5
   "scriptId": "1",
6
   "scriptName": "X手脚本",
7
   "scriptUrl": "http://baidu.com/a.iec",
8
   "scriptVersion": "1",
9
   "valueJson": {
10
       "a1": "test",
11
       "a2": "test"
12
   }
13
}

ecloud.removeScriptFile 清除脚本

删除脚本文件保证安全
适合版本： EC 6.11.0+
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
   var d = ecloud.removeScriptFile()
3
   logd(d)
4
}
5

6
main();

数据共享表操作

数据共享对应的云控数据管理中的数据分组和数据列表功能
表结构是固定好的，用户不可更改

ecloud.getData 取得数据

通过数据组名或者数据名称取得数据, 前提是要中云控中存在这个数据
@param map 可扩展参数表
例如 {"groupName":"数据组1","dataName":"key"}
key定义： groupName = 数据组名称
dataName = 数据名称

1
function main() {
2
   var d = ecloud.getData({"groupName": "资源组1", "dataName": "111"})
3
   logd(d)
4
}
5

6
main();

返回值示例
id: 数据id，不用管这个
name: 数据的名称
content: 数据的内容

1
[
2
    {
3
        "id": "",
4
        "name": "",
5
        "content": ""
6
    }
7
]

ecloud.getDataPop 取得并删除数

通过数据组名或者数据名称取得数据,获取后云控自动删除, 前提是要中云控中存在这个数据
@param map 可扩展参数表
例如 {"groupName":"数据组1","dataName":"key","getType":1,"size":1}
key定义： groupName = 数据组名称
dataName = 数据名称
getType = 获取数据方式，1 头部获取，2 尾部获取，3 随机获取
size = 需要获取的数据条数
@return {json数组} 空或者JSON数组

1
function main() {
2
   var d = ecloud.getDataPop({"groupName": "资源组1", "dataName": "111", "getType": 1, "size": 10})
3
   logd(d)
4
   logd(d[0])
5
}
6

7
main();

返回值示例

1
  ["aaa","bbb"]

ecloud.addData 新增数据

新增一组数据，如果组名存在了，会自动最近数据
@param map 可扩展参数表
例如 {"groupName":"数据组1","dataName":"key","content":"数据"}
key定义：
groupName = 数据组名称
dataName = 数据名称
content=内容
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
    var d = ecloud.addData({"groupName": "资源组1", "dataName": "111", "content": "test数据"})
3
    logd(d)
4
}
5

6
main();

ecloud.updateData 修改数据

修改某个组下面的数据，组名和数据名必填
@param map 可扩展参数表
例如
- {"groupName":"数据组1","dataName":"key","content":"数据"}
- key定义：
- groupName = 数据组名称
- dataName = 数据名称
- content=内容
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
    var d = ecloud.updateData({"groupName": "资源组1", "dataName": "111", "content": "test数据"})
3
    logd(d)
4
}
5

6
main();

ecloud.removeData 删除数据

删除某个组下面的数据，如果只填写组名，该组下面全部被删除，如果组名和数据名都有，就删除该组下数据名相同的数据
@param map 可扩展参数表
例如 {"groupName":"数据组1","dataName":"key"}
key定义：
groupName = 数据组名称
dataName = 数据名称
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
   var d = ecloud.removeData({"groupName": "资源组1", "dataName": "111"})
3
   logd(d)
4
}
5

6
main();

ecloud.appendOneLineData 追加一条数据

查询该组下面的数据名的内容，并向内容尾追加一条数据
@param map 可扩展参数表
例如 {"groupName":"数据组1","dataName":"key","content":"数据"}
key定义：
- groupName = 数据组名称
- dataName = 数据名称
- content=内容
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
    var d = ecloud.appendOneLineData({"groupName": "资源组1", "dataName": "111", "content": "test数据"})
3
    logd(d)
4
}
5

6
main();

ecloud.removeOneLineData 删除一条数据

查询该组下面的数据名的内容，并删除其中一条与content相等的数据
@param map 可扩展参数表
例如 {"groupName":"数据组1","dataName":"key","content":"数据"}
key定义：
- groupName = 数据组名称
- dataName = 数据名称
- content=内容
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
    var d = ecloud.removeOneLineData({"groupName": "资源组1", "dataName": "111", "content": "test数据"})
3
    logd(d)
4
}
5

6
main();

动态数据接口

动态数据对应的云控数据管理中的数据分组和数据列表功能
表结构不固定，用户自己创建，数据自己填充

ecloud.dynamicCreateTable 动态创建更新表

创建或者更新动态数据表结构
如果columns有增加新的，就自动创建字段，如果少了某个字段，就自动从表中移出字段
请谨慎操作表，以免数据丢失！！！
适合版本EC 6.16.0+
@param param 参数

1
  {
2
    "tableName": "我是牛逼的表",
3
    "tableNameEn": "niubi_table",
4
    "columns": [{
5
        "columnInfo": "姓名",
6
        "columnName": "name",
7
        "columnSize": 500
8
      },
9
      {
10
        "columnInfo": "年龄",
11
        "columnName": "age",
12
        "columnSize": 500
13
      },
14
      {
15
        "columnInfo": "性别",
16
        "columnName": "sex",
17
        "columnSize": 500
18
      }
19
    ]
20
  }

解释:
- tableName: 中文表名，相当于名称，但是不是实际表名
- tableNameEn: 英文表名，真实的表名
- columns: 表的字段数据，字段类型统一是字符串
- columnInfo: 字段的注释信息
- columnName: 字段名称，要用英文，不要有空格和特殊字符
- columnSize: 字段长度
- @return {string} JSON字符串，执行转换为JSON对象
- 成功返回示例：{"result":{"data":1}}，data代表操作的成功行数
- 失败返回示例：{"result":{"msg":"我是错误信息"}}

1
function main() {
2
    let crateTable = {
3
        "tableName": "我是牛逼的表",
4
        "tableNameEn": "niubi_table",
5
        "columns": [
6
            {
7
                "columnInfo": "姓名",
8
                "columnName": "name",
9
                "columnSize": 500
10
            },
11
            {
12
                "columnInfo": "年龄",
13
                "columnName": "age",
14
                "columnSize": 500
15
            },
16
            {
17
                "columnInfo": "性别",
18
                "columnName": "sex",
19
                "columnSize": 500
20
            }
21
        ]
22
    };
23

24
    let creae = ecloud.dynamicCreateTable(crateTable)
25
    logd("=== {}", creae);
26
}
27

28
main();

ecloud.dynamicQuery 动态查询表数据

动态查询数据
适合版本EC 6.16.0+
@param param 参数

1
  {
2
    "pageNumber": 1,
3
    "pageSize": 4,
4
    "fields": "id,name",
5
    "query": "and name like '%我是%'",
6
    "tableNameEn": "niubi_table",
7
    "search": {
8
      "id": "1",
9
      "name": "我是name"
10
    }
11
  }

解释:
- pageNumber: 页码从1开始如果是-1这个字段不生效，这个是使用limit实现
- pageSize: 每页条数如果是-1这个字段不生效，这个是使用limit实现
- fields: 要查下的字段，可以不写，如果填写就是用英文逗号链接，请看例子
- query: 自定义的查询条件，遵循sql的写法
- order: 排序字段例如 order by id desc，如果order里含有limit，请将 pageNumber 设置为-1 防止多个limit出现
- tableNameEn: 英文的表名
- search：查询条件，和query查询条件二选一，这个查询是等于模式
- search 例子： “id”:“1” 代表查询字段id=1的记录
- @return {string} JSON字符串，自行转换为JSON对象
- 成功返回示例：{"result":{"data":[{"name":"3","id":2}]}}，data代表返回的数据数组
- 失败返回示例：{"result":{"msg":"我是错误信息"}}

1
function main() {
2
    let query = {
3
        "pageNumber": 1,
4
        "pageSize": 2,
5
        "fields": "",
6
        "query": " and age like '%2%'",
7
        "tableNameEn": "niubi_table",
8
        "order":"",
9
        "search": {}
10
    };
11
    let queryr = ecloud.dynamicQuery(query)
12
    logd("=== {}", queryr);
13

14
  //随机查询
15
  let query2 = {
16
    "pageNumber": -1,
17
    "pageSize": -1,
18
    "fields": "",
19
    "query": "",
20
    "tableNameEn": "niubi_table",
21
    "order":"order by rand() limit 1",
22
    "search": {}
23
  };
24
  let queryr2 = ecloud.dynamicQuery(query2)
25
  logd("=== {}", queryr2);
26
}
27

28
main();

ecloud.dynamicAdd 动态增加表数据

动态增加数据
适合版本EC 6.16.0+

1
  {
2
    "tableNameEn": "niubi_table",
3
    "columns": {
4
      "name": "我是牛逼",
5
      "age": "niubi_table2",
6
      "sex": "niubi_table2"
7
    }
8
  }

@param param 参数
解释:
- tableNameEn: 英文的表名
- columns: 字段和字段值列表
- 例如 “name”: “我是牛逼的表”，代表插入一个数据name=我是牛逼的表
- @return {string} JSON字符串，自行转换为JSON对象
- 成功返回示例：{"result":{"data":1}}，data代表操作的成功行数
- 失败返回示例：{"result":{"msg":"我是错误信息"}}

1
function main() {
2
    let add = {
3
        "tableNameEn": "niubi_table",
4
        "columns": {
5
            "name": "我是牛逼的表",
6
            "age": "niubi_table2",
7
            "sex": "niubi_table2"
8
        }
9
    }
10

11
    let queryr = ecloud.dynamicAdd(add)
12
    logd("=== {}", queryr);
13

14
}
15

16
main();

ecloud.dynamicUpdate 动态更新表数据

动态更新数据
适合版本EC 6.16.0+
@param param 参数

1
  {
2
    "tableNameEn": "niubi_table",
3
    "columns": {
4
      "name": "我x是牛逼xxxx的表",
5
      "age": "niubi_table2",
6
      "sex": "niubi_table2"
7
    },
8
    "query": "and id=1",
9
    "search": {
10
      "id": "7"
11
    }
12
  }

query: 自定义的查询条件，遵循sql的写法
tableNameEn: 英文的表名
search：查询条件，和query查询条件二选一，这个查询是等于模式
search 例子： “id”:“1” 代表查询字段id=1的记录
columns: 要更新的字段和字段值列表
例如 “name”: “我是牛逼的表”，代表把name的指更新为我是牛逼的表
@return {string} JSON字符串，自行转换为JSON对象
成功返回示例：{"result":{"data":1}}，data代表操作的成功行数
失败返回示例：{"result":{"msg":"我是错误信息"}}

1
function main() {
2
    let update = {
3
        "tableNameEn": "niubi_table",
4
        "columns": {
5
            "name": "1我x是牛逼xxxx的表",
6
            "age": "niubi_table2",
7
            "sex": "niubi_table2"
8
        },
9
        "query": "and name like '%我%'",
10
        "search": {
11
            "id": "7"
12
        }
13
    }
14

15
    let updater = ecloud.dynamicUpdate(update)
16
    logd("=== {}", updater);
17

18
}
19

20
main();

ecloud.dynamicRemove 动态删除表数据

动态删除数据
适合版本EC 6.16.0+

1
  {
2
    "tableNameEn": "niubi_table",
3
    "query": "and name like '%我%'",
4
    "search": {
5
      "id": "1"
6
    }
7
  }

@param param 参数
解释:
query: 自定义的查询条件，遵循sql的写法
tableNameEn: 英文的表名
search：查询条件，和query查询条件二选一，这个查询是等于模式
search 例子： “id”:“1” 代表查询字段id=1的记录
@return {string} JSON字符串，自行转换为JSON对象
成功返回示例：{"result":{"data":1}}，data代表操作的成功行数
失败返回示例：{"result":{"msg":"我是错误信息"}}

1
function main() {
2
    let del = {
3
        "tableNameEn": "niubi_table",
4
        "query": "and name like '%我%'",
5
        "search": {
6
            "id": "7"
7
        }
8
    }
9
    let delr = ecloud.dynamicRemove(del)
10
    logd("=== {}", delr);
11
}
12

13
main();

数据缓存接口

该接口用于操作redis缓存一般表现为kv形式
支持缓存过期，字符串，set集合
如果需要支持boolean、整数，可以转换成字符串处理

ecloud.addCache 新增缓存

新增一个存放在redis的缓存
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key","expireTime":300,"dataType":1,"content":"数据"}
key定义：
cacheKey = 缓存key
expireTime = 过期时间单位是秒，为空或者小于等于0代表不过期
dataType=数据类型，1 字符串，2 set集合用换行符\n分割的
content=数据，如果dataType=2这个数据将会用换行符\n分割转换为集合存储到redis中
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 1,
7
        "content": "数据"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11

12
    // SET集合
13
    let sss = "s1\ns2\ns3";
14
    let setData = {
15
        "cacheKey": "key1",
16
        "expireTime": 300,
17
        "dataType": 2,
18
        "content": sss
19
    }
20
    let addSet = ecloud.addCache(setData);
21
    logd("addSet {}", addSet);
22
}
23

24
main();

ecloud.getCache 获取缓存

获取一个缓存，如果缓存失效了无数据返回
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key"}
key定义：
cacheKey = 缓存key
@return {string} 服务端返回的JSON字符串，解析result节点即可

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 1,
7
        "content": "数据"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11

12
    // SET集合
13
    let sss = "s1\ns2\ns3";
14
    let setData = {
15
        "cacheKey": "key1",
16
        "expireTime": -1,
17
        "dataType": 2,
18
        "content": sss
19
    }
20
    let addSet = ecloud.addCache(setData);
21
    logd("addSet {}", addSet);
22

23

24
    let data = ecloud.getCache({"cacheKey": "key1"});
25
    logd("data {}", JSON.stringify(data));
26
    //直接输出
27
    logd("data {}", data.result);
28
    //分割后 for打印
29
    data.result.split("\n").forEach(function (item) {
30
        console.log(item)
31
    })
32

33
}
34

35
main();

ecloud.updateCache 更新缓存

更新一个redis的缓存
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key","expireTime":300,"dataType":1,"content":"数据"}
key定义：
cacheKey = 缓存key
expireTime = 过期时间单位是秒，为空或者小于等于0代表不过期
dataType=数据类型，1 字符串，2 set集合用换行符\n分割的
content=数据，如果dataType=2这个数据将会用换行符\n分割转换为集合存储到redis中
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 1,
7
        "content": "数据"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11
    let data = ecloud.getCache({"cacheKey": "key1"});
12
    logd("data {}", JSON.stringify(data));
13
    //直接输出
14
    logd("data {}", data.result);
15

16
    let up = ecloud.updateCache({"cacheKey": "key1", "content": "test123"})
17

18
    data = ecloud.getCache({"cacheKey": "key1"});
19
    logd("更新后的数据data {}", JSON.stringify(data));
20
    //直接输出
21
    logd("更新后的数据data {}", data.result);
22

23
}
24

25
main();

ecloud.updateCacheExpire 更新过期时间

更新一个redis的缓存过期时间
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key","expireTime":300}
key定义：
cacheKey = 缓存key
expireTime = 过期时间单位是秒，为空或者小于等于0代表不过期
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 1,
7
        "content": "数据"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11
    let data = ecloud.getCache({"cacheKey": "key1"});
12
    logd("data {}", JSON.stringify(data));
13
    //直接输出
14
    logd("data {}", data.result);
15
    let up = ecloud.updateCacheExpire({"cacheKey": "key1", "expireTime": 0})
16
    logd("up {}", up);
17
    let leftTime = ecloud.getCacheExpire({"cacheKey": "key1"})
18
    logd("剩余过期时间 {}", leftTime);
19
}
20

21
main();

ecloud.getCacheExpire 获取剩余过期时间

获取一个redis的key剩余的过期时间
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key"}
key定义：
cacheKey = 缓存key
@return {long} 返回redis剩余的过期时间负数代表永不过期

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 1,
7
        "content": "数据"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11
    let data = ecloud.getCache({"cacheKey": "key1"});
12
    logd("data {}", JSON.stringify(data));
13
    //直接输出
14
    logd("data {}", data.result);
15
    let up = ecloud.updateCacheExpire({"cacheKey": "key1", "expireTime": 0})
16
    logd("up {}", up);
17
    let leftTime = ecloud.getCacheExpire({"cacheKey": "key1"})
18
    logd("剩余过期时间 {}", leftTime);
19
}
20

21
main();

ecloud.removeCache 删除缓存

删除一个redis的缓存
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key"}
key定义：
cacheKey = 缓存key
@return {bool} true代表成功 false ，代表失败

1
function main() {
2
   //字符串
3
   let stringData = {
4
       "cacheKey": "key1",
5
       "expireTime": 300,
6
       "dataType": 1,
7
       "content": "数据"
8
   }
9
   let addString = ecloud.addCache(stringData);
10
   logd("addString {}", addString);
11

12
   let data = ecloud.getCache({"cacheKey": "key1"});
13
   logd("data {}", JSON.stringify(data));
14
   //直接输出
15
   logd("data {}", data.result);
16

17

18
   let del = ecloud.removeCache({"cacheKey": "key1"})
19

20
   logd("删除 {}", del);
21

22
   data = ecloud.getCache({"cacheKey": "key1"});
23
   logd("删除后data {}", JSON.stringify(data));
24
   //直接输出
25
   logd("删除后data {}", data.result);
26
}
27

28
main();

ecloud.appendOneLineCache 追加缓存

追加一个redis set的缓存
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key","content":"数据"}
key定义：
cacheKey = 缓存key
content=数据，作为一整行，追加到redis的set集合中
@return {string} 服务端返回的JSON字符串，解析result节点即可

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 2,
7
        "content": "a\nb\nc"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11

12
    let data = ecloud.getCache({"cacheKey": "key1"});
13
    logd("data {}", JSON.stringify(data));
14
    //直接输出
15
    logd("data {}", data.result);
16

17

18
    let inc = ecloud.appendOneLineCache({"cacheKey": "key1", "content": "test"})
19
    logd("==inc {}", inc);
20
    inc.result.split("\n").forEach(function (item) {
21
        console.log("append --- {}", item)
22
    })
23

24
}
25

26
main();

ecloud.removeOneLineCache 删除一行缓存

删除一个redis set的缓存元素
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key","content":"数据"}
key定义：
cacheKey = 缓存key
content=数据，作为一整行，追加到redis的set集合中
@return {string} 服务端返回的JSON字符串，解析result节点即可

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 2,
7
        "content": "a\nb\nc"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11

12
    let data = ecloud.getCache({"cacheKey": "key1"});
13
    logd("data {}", JSON.stringify(data));
14
    //直接输出
15
    logd("data {}", data.result);
16

17

18
    let inc = ecloud.appendOneLineCache({"cacheKey": "key1", "content": "test"})
19
    logd("==inc {}", inc);
20
    inc.result.split("\n").forEach(function (item) {
21
        console.log("append --- {}", item)
22
    })
23
    inc = ecloud.removeOneLineCache({"cacheKey": "key1", "content": "test"})
24
    logd("==inc {}", inc);
25
    inc.result.split("\n").forEach(function (item) {
26
        console.log("append --- {}", item)
27
    })
28
}
29

30
main();

ecloud.incrementCache 自增缓存

redis的自增长计数功能，每次调用这个key的值都会+1
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key"}
key定义：
cacheKey = 缓存key
@return {long} 返回redis自增后的值

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 2,
7
        "content": "a\nb\nc"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11

12
    let data = ecloud.getCache({"cacheKey": "key1"});
13
    logd("data {}", JSON.stringify(data));
14
    //直接输出
15
    logd("data {}", data.result);
16

17

18
    let inc = ecloud.incrementCache({"cacheKey": "key2"})
19
    logd("==inc {}", inc);
20
    let get = ecloud.getCache({"cacheKey": "key2"})
21
    //这里获取的是字符串
22
    logd("==get {}", get.result);
23

24
}
25

26
main();

ecloud.decrementCache 自减缓存

redis的自减计数功能，每次调用这个key的值都会-1
适合版本 EC 7.5.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key"}
key定义：
cacheKey = 缓存key
@return {long} 返回redis自减的值

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "expireTime": 300,
6
        "dataType": 2,
7
        "content": "a\nb\nc"
8
    }
9
    let addString = ecloud.addCache(stringData);
10
    logd("addString {}", addString);
11
    let data = ecloud.getCache({"cacheKey": "key1"});
12
    logd("data {}", JSON.stringify(data));
13
    //直接输出
14
    logd("data {}", data.result);
15
    let inc = ecloud.incrementCache({"cacheKey": "key2"})
16
    logd("==inc {}", inc);
17
    let get = ecloud.decrementCache({"cacheKey": "key2"})
18
    //这里获取的是字符串
19
    logd("==get {}", get);
20
}
21

22
main();

ecloud.popPushCache push或者pop命令

redis push或者pop命令
适合版本 EC 7.8.0+
@param map 可扩展参数表
例如 {"cacheKey":"缓存key"}
key定义：
cmd = 支持 spop，rpush，lpush，lpop，rpop
cacheKey = 缓存key
content = push或者pop的内容
@return {string} 服务端返回的JSON字符串，解析result节点即可

1
function main() {
2
    //字符串
3
    let stringData = {
4
        "cacheKey": "key1",
5
        "cmd": "lpush",
6
        "content": "aaa"
7
    }
8
    let popPushCachex = ecloud.popPushCache(stringData);
9
    logd("popPushCachex {}", popPushCachex);
10
    let data = ecloud.getCache({"cacheKey": "key1"});
11
    logd("data {}", JSON.stringify(data));
12

13
}
14

15
main();