異步存儲(chǔ)

異步存儲(chǔ)是一個(gè)簡單的、異步的、持久的、全局的、鍵-值存儲(chǔ)系統(tǒng)。它應(yīng)該會(huì)代替本地存儲(chǔ)被使用。

由于異步存儲(chǔ)是全局性的，建議您在異步存儲(chǔ)之上使用抽象體，而不是對(duì)任何輕微用法直接使用異步存儲(chǔ)。

在本地 iOS 實(shí)現(xiàn)上 JS 代碼是一個(gè)簡單的外觀模式，用來提供一個(gè)清晰的 JS API，真正的錯(cuò)誤對(duì)象，和簡單的非多元化功能。每個(gè)方法返回一個(gè) Promise 對(duì)象。

方法

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

如果有任何一個(gè)錯(cuò)誤，獲取 key 并傳遞 callback 的結(jié)果，返回一個(gè) Promise 對(duì)象。

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

如果有任何一個(gè)錯(cuò)誤，獲取 key 并在結(jié)束時(shí)調(diào)用 callback 函數(shù)，返回一個(gè) Promise 對(duì)象。

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

返回一個(gè) Promise 對(duì)象。

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

將現(xiàn)有值與輸入值進(jìn)行合并，假設(shè)它們是 stringified json，返回一個(gè) Promise 對(duì)象。

所有本地實(shí)現(xiàn)不支持。

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

為所有客戶、函數(shù)庫等清除所有的異步存儲(chǔ)。你可能不想調(diào)用這個(gè)-使用 removeItem 或者 multiRemove 來清除只屬于你的鍵值。返回一個(gè) Promise 對(duì)象。

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

為調(diào)用者、函數(shù)庫等獲取系統(tǒng)已知的所有鍵值。返回一個(gè) Promise 對(duì)象。

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

multiGet利用一個(gè)鍵值對(duì)的數(shù)組調(diào)用回調(diào)函數(shù)來獲取multiSet的輸入格式。返回一個(gè) `Promise` 對(duì)象。

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

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

multiSet 和 multiMerge 利用鍵值對(duì)的數(shù)組匹配multiGet的輸出。返回一個(gè) Promise 對(duì)象。例如，

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

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

刪除鍵值數(shù)組中所有的鍵值。返回一個(gè) Promise 對(duì)象。

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

將現(xiàn)有值與輸入值進(jìn)行合并，假設(shè)它們是 stringified json，返回一個(gè) Promise 對(duì)象。

所有本地實(shí)現(xiàn)不支持。

例子

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 />; }
      },
    ];