AsyncStorage是一个简单的、具有异步特性的键值对的存储系统。相对整个App而言,它是全局的,
AsyncStorage提供了比较全的方法供我们使用。每个方法都有一个回调函数,而回调函数的第一个参数都是错误对象。如果发生错误,该对象就会展示错误信息,否则为null.所有的方法执行后,都会返回一个promise对象。
static getItem(key: string,callback?: ?(error: ?Error,result: ?string) => void)
读取key
字段并将结果作为第二个参数传递给callback
。如果有任何错误发生,则会传递一个Error
对象作为第一个参数。返回一个Promise
对象。
2、设置键值对
static setItem(key: string,value: string,callback?: ?(error: ?Error) => void)
将key
字段的值设置成value
,并在完成后调用callback
函数。如果有任何错误发生,则会传递一个Error
对象作为第一个参数。返回一个Promise
对象。
3、根据键移除一项。
static removeItem(key: string,callback?: ?(error: ?Error) => void)
删除一个字段。返回一个Promise
对象。
static mergeItem(key: string,callback?: ?(error: ?Error) => void)
假设已有的值和新的值都是字符串化的JSON,则将两个值合并。返回一个Promise
对象。还没有被所有原生实现都支持。
static clear(callback?: ?(error: ?Error) => void)
6、获取所有的键
static getAllKeys(callback?: ?(error: ?Error,keys: ?Array<string>) => void)
7、获取多项,其中key是字符串数组.
static multiGet(keys: Array<string>,callback?: ?(errors: ?Array<Error>,result: ?Array<Array<string>>) => void)
获取keys所包含的所有字段的值,调用callback回调函数时返回一个key-value数组形式的数组。返回一个Promise
对象。
multiGet(['k1','k2'],cb) -> cb([['k1','val1'],['k2','val2']])
8、设置多项,其中keyValuePairs是字符串的二维数组。
static multiSet(keyValuePairs: Array<Array<string>>,callback?: ?(errors: ?Array<Error>) => void) #
multiSet和multiMerge都接受一个与multiGet输出值一致的key-value数组的数组。返回一个Promise
对象。
multiSet([['k1','val2']],cb);
9、删除多项,其中keys是字符串数组
static multiRemove(keys: Array<string>,callback?: ?(errors: ?Array<Error>) => void)
删除所有键在keys
数组中的数据。返回一个Promise
对象。
10、多个键值对全并,其中keyValuePairs是字符串的二维数组。
static multiMerge(keyValuePairs: Array<Array<string>>,callback?: ?(errors: ?Array<Error>) => void)
11、清除所有进行中的查询操作。static flushGetRequests()
清除所有进行中的查询操作。