简介
AsyncStorage是一个简单的、异步的、持久化的Key-Value存储系统,它对于App来说是全局性的。
在真正使用的过程中建议在AsyncStorage的基础上做一层抽象封装,而不是直接使用AsyncStorage。
推荐由React Native中文网封装维护的react-native-storage模块,提供了较多便利功能。
常用API
1. 读取数据
//读取key字段并将结果作为第二个参数传递给callback
static getItem(key: string, callback?: ?(error: ?Error, result: ?string) => void)
//获取keys所包含的所有字段的值,调用callback回调函数时返回一个key-value数组形式的数组
static multiSet(keyValuePairs: Array<Array<string>>, callback?: ?(errors: ?Array<Error>) => void)
2. 写入数据
将key字段的值设置成value,并在完成后调用callback函数。如果有任何错误发生,则会传递一个Error对象作为第一个参数。返回一个Promise对象。
//写入一个数据
static setItem(key: string, value: string, callback?: ?(error: ?Error) => void)
//写入一组数据(key-value数组)
static multiSet(keyValuePairs: Array<Array<string>>, callback?: ?(errors: ?Array<Error>) => void)
3. 删除数据
删除一个字段。返回一个Promise对象。
static removeItem(key: string, callback?: ?(error: ?Error) => void)
删除所有键在keys数组中的数据。返回一个Promise对象。
static multiRemove(keys: Array<string>, callback?: ?(errors: ?Array<