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

时间:2024-10-22 15:05:26

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

借助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);
}
};

输出结果:

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

当然, 还可以通过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); }

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

当然也可以通过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 持久化存储