React Native——AsyncStorage

AsyncStorage是一个简单的、具有异步特性的键值对的存储系统。相对整个App而言，它是全局的，

AsyncStorage提供了比较全的方法供我们使用。每个方法都有一个回调函数，而回调函数的第一个参数都是错误对象。如果发生错误，该对象就会展示错误信息，否则为null.所有的方法执行后，都会返回一个promise对象。

1、根据键来获取值，获取的结果会在回调函数中。

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对象。

4、合并现有值和输入值

static mergeItem(key: string, value: string, callback?: ?(error: ?Error) => void)

假设已有的值和新的值都是字符串化的JSON，则将两个值合并。返回一个Promise对象。还没有被所有原生实现都支持。

5、清除所的项目

static clear(callback?: ?(error: ?Error) => void)

删除全部的AsyncStorage数据，不论来自什么库或调用者。通常不应该调用这个函数——使用removeItem或者multiRemove来清除你自己的key。返回一个Promise对象。

6、获取所有的键

static getAllKeys(callback?: ?(error: ?Error, keys: ?Array<string>) => void)

获取所有本应用可以访问到的数据，不论来自什么库或调用者。返回一个Promise对象。

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', 'val1'], ['k2', '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)

将多个输入的值和已有的值合并，要求都是字符串化的JSON。返回一个Promise对象。

还没有被所有原生实现都支持。

11、清除所有进行中的查询操作。

static flushGetRequests() 

清除所有进行中的查询操作。