数据持久化就是指应用程序将某些数据存储在手机存储空间中。

借助native存储

这种方式不言而喻,就是把内容传递给native层,通过原生API存储，详见从零学React Native之05混合开发

AsyncStorage API

RN框架为开发者提供了 AsyncStorage API，开发者可以利用它将任意“字符串键值对”保存到存储空间中。

它是简单的，异步的。用它可以取代Android的sharedperference和ios的NSUserDefault。

AsyncStorage存储的数据对该RN应用全局都是可以访问的，只需要知道通过它增删改查数据就可以了。

写入数据

开发者可以通过静态函数setItem来存储数据。setItem的JavaScript原型是：

static object setItem(key,value,aCallBack)

写入数据有好几种方式，直接看代码：

// 构造
    constructor(props) {
        super(props);
        this.doSomething=this.doSomething.bind(this);
    }

    doSomething(error){
        if(error!=null){   //如发生错误 处理
            console.log('error message:'+error.message);
            return;
        }
        // 执行保存成功的操作
        console.log("name保存成功!");
    }
    //下面4种写法,推荐第三种和第四种
    componentWillMount() {
        //最简单的写法,无法检测保存何时结束,是否成功
        AsyncStorage.setItem('NO','01'); 
        console.log("NO保存成功");

        // 通过自带的回调方法,一旦发生出错就可以监控到
        AsyncStorage.setItem('name','张三',this.doSomething);


        //Promise操作 ES2015推荐的写法
        AsyncStorage.setItem('age',"18").then(
            ()=>{   //成功的操作
                console.log("age保存成功!");
            },);
        // 使用ES2017推荐的异步的写法
        this.saveSex();

    }
    // 箭头函数不需要在构造函数中bind(this)了
    saveSex = async ()=> {
        try {
           await AsyncStorage.setItem('sex','female');
            console.log("sex保存成功!");
        } catch(error) {
            console.error(error);
        }
    };

输出结果:

当然,还可以通过AsyncStorage的静态函数multiSet一次存储多个数据。

static object multiSet(aArray,aCallback)

//参数类型
multiSet([['k1','val1'],['k2','val2']],cb);

Promise机制还可以通过下面的方式捕获异常,如果不了解Promise可以参考[React Native]Promise机制

AsyncStorage.multiSet([['name','李四'],["sex","male"]])
            .then(
                ()=>{
                    console.log("name,sex保存成功");
                }
            ).catch((errors)=>{
                console.log('error,length:'+errors.length);
                if(errors.length>0){  //保存操作有异常
                    console.log(errors[0].message);
                    //...
                }else{
                    //异常不是数组,有可能是成功操作的处理函数抛出的异常
                    //...
                }
        });

获取数据

可以通过AsyncStorage类的静态函数getItem获取数据，JS原型是：

static object getItem(aKey,aCallback)

直接看代码:

componentWillMount() {

        //...

        //方式一 读取数据
        AsyncStorage.getItem("name",this.handleResult);

        //方式二
        AsyncStorage.getItem('sex')
            .then(  //使用Promise机制的方法
                (result)=> {   //使用Promise机制,如果操作成功不会有error参数
                    if (result == null) {
                        //没有指定的key
                        return;
                    }
                    console.log("sex:" + result);
                }
            ).catch((error)=> { //读取操作失败 console.log('error:' + error.message); }); } handleResult(error,result) { if (error != null) { console.log('error message:' + error.message); return; } if (result == null) { //没有指定的key return; } console.log("name:" + result); }

当然也可以通过getAllKeys函数获取当前存储的所有键,再通过multiGet获取所有值。两个函数的原型分别是：

static object getAllkeys([aCallback])
static object multiGet(aArrays,aCallBack)

官方示例代码:

AsyncStorage.getAllKeys((err,keys) => {
  AsyncStorage.multiGet(keys,(err,stores) => {
   stores.map((result,i,store) => {
     // get at each store's key/value so you can work with it
     let key = store[i][0];
     let value = store[i][1];
    });
  });
});

注意的是，AsyncStorage API存储数据是无序的。

开发者还可以通过AsyncStorage的静态函数flushGetRequests取消前面的所有未执行的完成的multiGet操作。

static object flushGetRequests()

最好也借助Promise机制。

删除数据

删除数据通过 removeItem或者multiRemove 删除。当然还可以通过clear函数全部清空。
函数原型：

static removeItem(key,callback?) 

static multiRemove(keys,callback?) 

static clear(callback?)

写法和上面差不多，就不列举示例代码了。

JSON对象存储

使用AsyncStorage类保存数据，只能通过key-value形式保存一个字符串类型的数据。很难满足开发者的需求。
但是配合JSON类，把JSON格式的对象转换为一个字符串。然后通过AsyncStorage类的key-value形式进行保存，就可以满足绝大多数需求了。

我们借助下上篇文章中[React Native] 解析JSON文件中的json文件,通过JSON类就可以转化为字符串了

let studentData = require('./data/student.json');
let newJSONString=JSON.stringify(studentData);

读取出来的字符串也可以转换回JSON对象。

let jsonObject=JSON.parse(newJSONString)

需要注意的是 JSONparse函数要求严格,不允许有尾逗号,如果有机会抛出异常,如下:

JSON.parse('{"name":"张三",}');

数据库

如果你想存放数据结构复杂的数据的时候，就需要用到数据库,比如sqlite这种跨平台的数据存储方式在ReactNative里也有对应的方式，那就是react-native-sqlite。点这里可以进行下载集成到应用程序中。

处理sqlite还有比较牛的就是realm，realm也支持react native了。大家可以按照官方文档去配置。
https://realm.io/docs/react-native/latest/

调用数据库相对复杂了，我们后面再详细介绍。

更多精彩请关注微信公众账号likeDev

从零学React Native之13 持久化存储