如何调用键值对存储_物联网终端操作系统(AliOS Things)-阿里云帮助中心

key-value-键值对存储有两类接口：存储在Flash接口，调用该接口的存储为持久化存储，设备掉电无影响。存储在内存接口，调用该接口的存储为临时存储，系统掉电或者复位存储的数据将消失。

硬件平台

产品型号	是否支持	硬件类型	固件版本号
HaaS600Kit	是	开发板	4.0.1
HaaS510	是	DTU	4.0.1
HaaS520	是	DTU	4.0.1
HaaS530	是	DTU	4.0.1
HaaS531	是	DTU	4.0.1
HaaS632-LT32V	是	蜂窝模组	4.0.1
HaaS600-EC600S	是	蜂窝模组	4.0.1
HaaS600-EC600N	是	蜂窝模组	4.0.1
HaaS600-EC600U	是	蜂窝模组	4.0.1
HaaS600-N715	是	蜂窝模组	4.0.1

kv.setStorageSync(String key, String value)

新增或更新Flash中的key-value。

入参

属性	类型	是否必填	说明
key	String	是	需要新增的`key`，长度不超过64字节。
value	String	是	需要新增的`value`，长度不超过256字节。

返回值	说明
0	表示成功。
其他	表示失败。

kv.getStorageSync(String key)

读取Flash中的key-value值。

入参

属性	类型	是否必填	说明
key	String	是	需要读取的`key`。

返回值	说明
value值	读取的键值，String类型。
undefined	失败。

kv.removeStorageSync(String key)

清除Flash中的key-value值。

入参

属性	类型	是否必填	说明
key	String	是	需要清除的`key`。

返回值	说明
0	表示成功。
其他	表示失败。

kv.setMemory(String key, String value)

新增或更新RAM中的key-value。

入参

属性	类型	是否必填	说明
key	String	是	需要新增的`key`。
value	String	是	需要新增的`value`。

返回值	说明
0	表示成功。
其他	表示失败。

`kv.getMemory(String key)`

读取RAM中的key-value值。

入参

属性	类型	必填	说明
key	String	是	需要读取的key

返回值	说明
value值	读取的键值，String类型。
undefined	表示失败。

kv.removeMemory(String key)

清除RAM中的key-value值。

入参

属性	类型	是否必填	说明
key	String	是	需要清除的`key`。

返回值	说明
0	表示成功。
其他	表示失败。

示例代码

import * as kv from 'kv';

var key1 = 'key-test';
var value1 = 'this is amp kv flash test file';

// kv set
kv.setStorageSync(key1, value1);

// kv get
var val = kv.getStorageSync(key1);
console.log('kv read: ' + val);

// kv remove
kv.removeStorageSync(key1);

var key2 = 'key-ram';
var value2 = 'this is amp kv ram test file';

// kv set
kv.setMemory(key2, value2);

// kv get
var val2 = kv.getMemory(key2);
console.log('kv read ram: ' + val2);

// kv remove
kv.removeMemory(key2);