数据持久化就是指应用程序将某些数据存储在手机存储空间中。
借助native存储
这种方式不言而喻,就是把内容传递给native层,通过原生API存储,详见
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可以参考
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形式进行保存,就可以满足绝大多数需求了。
我们借助下上篇文章中 中的json文件,通过JSON类就可以转化为字符串了, 注意,因为JSON是js自带的对象千万别化蛇添足把JSON添加到import组件中
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,公众账号名称:爱上Android。