因为项目需要用到 APP 本地存取数据库的功能，所以采用了 realm 的方案，官方文档地址：https://realm.io/docs/javascript/latest/。
react-native 存储方案
- AsyncStorage
react-native 官方存储方案是 AsyncStorage。AsyncStorage 是一个简单的、异步的、持久化的 Key-Value 存储系统，它对于 App 来说是全局性的。可用来代替 LocalStorage。官方推荐使用者在 AsyncStorage 的基础上做一层抽象封装，而不是直接使用 AsyncStorage。
- AsyncStorage 封装库
react-native-storage 是一个比较好的框架，我们可以直接使用它，方法很简单，说明文档中说得很详细。其他库还有 react-native-simple-store 等。
- realm
realm 是一款专为移动 端开发的高性能数据库，其宣称自己是最快的 react-native 数据库。
realm 整体的优点有这么四点：1.简单易用，2.跨平台，3.快速性能优越，4.提供高级功能。realm 核心数据引擎用 C++ 打造，并不是建立在 SQLite 之上的 ORM。因此性能就是比普通的 ORM 要快很多，甚至比单独无封装的 SQLite 还要快。同时因为是 ORM，本身在设计时也针对移动设备（iOS、Android），所以简单易用，学习成本很低。
realm 常用操作
1、 作为数据库，使用它无法就是「增删改查」等基本操作，使用之前，需要定义 model：
- name：表格名称。
- primaryKey：主键，这个属性的类型可以是 'int' 和 'string'，并且如果设置主键之后，在更新和设置值的时候这个值必须保持唯一性，并且无法修改。声明主键可以有效地查找和更新对象，并为每个值强制实现唯一性。
- properties：这个属性内放置我们需要的字段。
// models/hello.ts
export const HelloSchema = {
name: "Hello",
primaryKey: "uid", // 定义主键后，无法创建同一主键的数据
properties: {
uid: "string",
name: "string", // {type: 'string'} 的简写
phone: { type: "string", default: "136xxxxxxxx" }
}
};
2、 初始化
// 根据提供的表初始化 Realm，可同时往数组中放入多个表
let realm = new Realm({ schema: [HelloSchema] });
3、 增加数据
对域中对象的更改、创建、更新和删除，必须在 write（）事务块中进行。
需要注意：写入事务具有不可忽略的开销，应该尽量减少代码中写入块的数量。
try {
realm.write(() => {
realm.create("Hello", {
uid: "a371d56d7b6f77ba31f71d22",
name: "名字1",
phone: "137xxxxxxxx"
});
realm.create("Hello", {
uid: "a371d56d7b6f77ba31f71d22",
name: "名字1",
phone: "137xxxxxxxx"
});
// ...
});
catch(e) {
console.log("Error on creation");
}
定义 model 时我们使用了 primaryKey，如果我们写入 primaryKey 之前的数据中已存在时，我们写入会出错，并且如果此时我们写入的是多个数据时，会导致后面的写入失败，所以我们可以在单个 realm.create('Hello', item) 的外面使用一个 try...catch...。
const result = await new Promise((resolve, reject) => {
try {
realm.write(() => {
for (let item of data) {
try {
realm.create("Hello", item);
} catch (e) {
console.log("write error: ", e);
}
}
resolve("ok");
});
} catch (e) {
console.log("write error: ", e);
resolve("error");
}
});
console.log("write result: ", result);
4、 查找和删除数据
查询数据允许从 realm 获取单个类型的对象，并可选择过滤和排序这些结果。最基本方法是使用 objects 方法获取给定类型的所有对象。
let dogs = realm.objects('Dog'); // retrieves all Dogs from the Realm
- Filtering 参数可过滤查找结果：
let dogs = realm.objects('Dog').filtered('color = "tan" AND name BEGINSWITH "B"'); - Sorting 参数允许根据单个或多个属性指定排序条件和顺序：
let hondas = realm.objects('Car').filtered('make = "Honda"');
// Sort Hondas by mileage
let sortedHondas = hondas.sorted('miles');
// Sort in descending order instead
sortedHondas = hondas.sorted('miles', true);
// Sort by price in descending order and then miles in ascending
sortedHondas = hondas.sorted([['price', true], ['miles', false]]);
- Limiting 参数提供了对查询结果进行“分页”的能力。这通常是为了避免从磁盘中读取太多内容，或者一次将太多结果拖入内存中。由于 realm 中的查询是惰性的，因此根本不需要执行这种分页行为，因为 realm 只会在显式访问后从查询结果中加载对象。
let cars = realm.objects('Car'); let firstCars = cars.slice(0, 5);
// 删除单个数据
let result = await new Promise((resolve, reject) => {
try {
realm.write(() => {
for (let uid of data) {
try {
let dataRource = realm.objects("Hello").filtered(`uid = "${uid}"`);
realm.delete(dataRource);
console.log("delete: ", uid);
} catch (e) {
console.log("delete error: ", uid);
}
}
resolve("delete ok!");
});
} catch (e) {
console.log("delete error: ", e);
resolve("delete error!");
}
});
console.log("delete done!: ", result);
// delete all Hello
let result = await new Promise((resolve, reject) => {
try {
let dataRource = realm.objects("Hello");
realm.write(() => {
realm.delete(dataRource);
resolve("delete done!");
});
} catch (e) {
resolve("delete error!");
}
});
console.log("delete done!:", result);
5、 修改数据
如果定义 model 时包含主键，则可以让 realm 根据其主键值智能地更新或添加对象。更新时将 true 作为第三个参数传递给 create 方法。
realm.write(() => {
realm.create("Hello", {
uid: "a371d56d7b6f77ba31f71d22",
name: "Recipes",
phone: "135xxxxxxxx"
});
// Update book with new price keyed off the id
realm.create(
"Hello",
{ uid: "a371d56d7b6f77ba31f71d22", phone: "138xxxxxxxx" },
true
);
});
使用报错记录
1.安卓打包安装进入闪退
在 iOS 模拟器和安卓真机调试都是正常的，打包之后安装打开一进入就闪退，通过友盟的错误统计发现报了几个错误（现在找不到记录了 😓）。
GitHub 里面有对应的这些 issue，但是没有人能准确的定位错误，按照别人的建议都没能解决。后来找到一个：
java.lang.ClassNotFoundException: Didn't find class on path: DexPathList - io.realm.react.utils.SSLHelper
试着在 android/app/proguard-rules.pro 加上 -keep class io.realm.react.**，终于解决了，原来是打包的时候被混淆引起的。
2.删除操作记录时报错
Accessing object of type X which has been invalidated or deleted
删除部分数据后，必须更新 store ，如果需要显示删除后的数据也必须先把 store 中显示的 realm 数据置为空，然后再去重新查询。
3.安卓调试模式报错
DOMException: Failed to execute 'open' on 'XMLHttpRequest': Invalid URL
这个可以在这个issue 上找到答案。
