Module: miot/host/storage

本地轻量级存储服务, 键值对格式

Methods

(static) get(key) → {*}

获取一个key 保存的字符串,如果已经调用 set 则返回对应的值,未调用 set 则返回空字串 '' 如果value已过期,则会reject

Parameters:
Name Type Description
key string
Returns:
Type
*
Example
import {Host} from 'miot'
...
var value = await Host.storage.get('prop1')
//or
Host.storage.get('prpp1')
.then(val => {
 //load val success}
 console.log('load value:', val)
)
.catch(err => {
 //load val error 
 if (err === 'expired') {console.log('value for key already expired')}
})
...

(static) load(keys) → {promise.<Array.<json>>}

获取所有 keys 的 values

Parameters:
Name Type Description
keys array
Returns:

返回的promise传出的值是values数组,和传入的keys对应 [{key,value}]

Type
promise.<Array.<json>>
Example
import {Host} from 'miot'
...
Host.storage.load(['key1','key2']).then(res => console.log('success'))
...

(static) save(keyValues, optopt) → {void}

保存所有 keyValues 的数据,例如{key1:value1 , key2:value2 , key3:value3} 每个 key 可单独更新数据,如果调用 set(key2,value4) 则只更新 key2,key1和 key3的值保持不变

Parameters:
Name Type Attributes Default Description
keyValues Object

需要存储的数据

opt object <optional>
{ expire: 0 }

opt.expire 有效期 从保存的时候开始 expire ms以内数据有效。

Returns:
Type
void
Example
import {Host} from 'miot'
...
Host.storage.save({'key1':'val1','key2':'val2'})
//or
Host.storage.save({'key1':'val1','key2':'val2'}, {expire:3600})
...

(static) set(key, val, optopt) → {void}

和 get 相对应,持久化一个 key=value 的数据

Parameters:
Name Type Attributes Default Description
key string

获取 value 时传入的唯一标识

val object

要保存的数据

opt object <optional>
{ expire: 0 }

opt.expire 有效期 从保存的时候开始 expire ms以内数据有效。

Returns:
Type
void
Example
import {Host} from 'miot'
...
Host.storage.set('key1','value1')
//or
Host.storage.set('key1','value1', {expire:3600})
...