React Native：异步存储

异步存储是一个简单的、异步的、持久的、全局的、键-值存储系统。它应该会代替本地存储被使用。

由于异步存储是全局性的，建议您在异步存储之上使用抽象体，而不是对任何轻微用法直接使用异步存储。

在本地 iOS 实现上 JS 代码是一个简单的外观模式，用来提供一个清晰的 JS API，真正的错误对象，和简单的非多元化功能。每个方法返回一个 Promise 对象。

方法

static **getItem**(key: string, callback: (error: ?Error, result: ?string) => void)

如果有任何一个错误，获取 key 并传递 callback 的结果，返回一个 Promise 对象。

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

如果有任何一个错误，获取 key 并在结束时调用 callback 函数，返回一个 Promise 对象。

static **removeItem**(key: string, callback: ?(error: ?Error) => void)

返回一个 Promise 对象。

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

将现有值与输入值进行合并，假设它们是 stringified json，返回一个 Promise 对象。

所有本地实现不支持。

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

为所有客户、函数库等清除所有的异步存储。你可能不想调用这个-使用 removeItem 或者 multiRemove 来清除只属于你的键值。返回一个 Promise 对象。

static **getAllKeys**(callback: (error: ?Error) => void)

为调用者、函数库等获取系统已知的所有键值。返回一个 Promise 对象。

static **multiGet**(keys: Array<string>, callback: (errors: ?Array<Error>, result: ?Array<Array<string>>) => void)

multiGet利用一个键值对的数组调用回调函数来获取multiSet的输入格式。返回一个 `Promise` 对象。

multiGet([k1, k2], cb) -> cb([[k1, val1], [k2, val2]])

static **multiSet**(keyValuePairs: Array<Array<string>>, callback: ?(errors: ?Array<Error>) => void)

multiSet 和 multiMerge 利用键值对的数组匹配multiGet的输出。返回一个 Promise 对象。例如，

multiSet([[k1, val1], [k2, val2]], cb);

static **multiRemove**(keys: Array<string>, callback: ?(errors: ?Array<Error>) => void)

删除键值数组中所有的键值。返回一个 Promise 对象。

static **multiMerge**(keyValuePairs: Array<Array<string>>, callback: ?(errors: ?Array<Error>) => void)

将现有值与输入值进行合并，假设它们是 stringified json，返回一个 Promise 对象。

所有本地实现不支持。

例子

dit on GitHub

    use strict;    var React = require(react-native);    var {
      AsyncStorage,
      PickerIOS,
      Text,
      View
    } = React;    var PickerItemIOS = PickerIOS.Item;    var STORAGE_KEY = @AsyncStorageExample:key;    var COLORS = [red, orange, yellow, green, blue];    var BasicStorageExample = React.createClass({
      componentDidMount() {
        AsyncStorage.getItem(STORAGE_KEY)
          .then((value) => {            if (value !== null){              this.setState({selectedValue: value});              this._appendMessage(Recovered selection from disk:  + value);
            } else {              this._appendMessage(Initialized with no selection on disk.);
            }
          })
          .catch((error) => this._appendMessage(AsyncStorage error:  + error.message))
          .done();
      },
      getInitialState() {        return {          selectedValue: COLORS[0],          messages: [],
        };
      },
      render() {        var color = this.state.selectedValue;        return (
          <View>
            <PickerIOS
              selectedValue={color}
              onValueChange={this._onValueChange}>
              {COLORS.map((value) => (
                <PickerItemIOS
                  key={value}
                  value={value}
                  label={value}
                />
              ))}
            </PickerIOS>
            <Text>
              {Selected: }
              <Text style={{color}}>
                {this.state.selectedValue}
              </Text>
            </Text>
            <Text>{ }</Text>
            <Text onPress={this._removeStorage}>
              Press here to remove from storage.
            </Text>
            <Text>{ }</Text>
            <Text>Messages:</Text>
            {this.state.messages.map((m) => <Text>{m}</Text>)}
          </View>
        );
      },
      _onValueChange(selectedValue) {        this.setState({selectedValue});
        AsyncStorage.setItem(STORAGE_KEY, selectedValue)
          .then(() => this._appendMessage(Saved selection to disk:  + selectedValue))
          .catch((error) => this._appendMessage(AsyncStorage error:  + error.message))
          .done();
      },
      _removeStorage() {
        AsyncStorage.removeItem(STORAGE_KEY)
          .then(() => this._appendMessage(Selection removed from disk.))
          .catch((error) => { this._appendMessage(AsyncStorage error:  + error.message) })
          .done();
      },
      _appendMessage(message) {        this.setState({messages: this.state.messages.concat(message)});
      },
    });
    exports.title = AsyncStorage;
    exports.description = Asynchronous local disk storage.;
    exports.examples = [
      {        title: Basics - getItem, setItem, removeItem,
        render(): ReactElement { return <BasicStorageExample />; }
      },
    ];