引言
在React Native应用中高效管理本地数据至关重要。Realm是一个高性能移动数据库，提供流畅的数据存储和检索体验。本文将指导您如何使用@realm/react将Realm集成到React Native项目中，实现数据的创建、读取、更新和删除。
项目设置
首先，安装必要的依赖项：
yarn add realm @realm/react
在React Native中使用Realm
1. 使用RealmProvider包裹应用
为了在整个应用中都能访问数据库架构，需要用RealmProvider包裹整个应用：
import React from 'react';
import { NavigationContainer } from '@react-navigation/native';
import { createBottomTabNavigator } from '@react-navigation/bottom-tabs';
import { RealmProvider } from '@realm/react';
import CreateScreen from './screens/CreateScreen';
import { Person } from './models/Person';
import { Car } from './models/Car';
import { Address } from './models/Address';
const Tab = createBottomTabNavigator();
const App = () => {
return (
);
};
export default App;
2. 理解deleteRealmIfMigrationNeeded
deleteRealmIfMigrationNeeded选项允许开发者在检测到架构更改时自动删除现有的Realm数据库。这在开发过程中非常有用，可以避免迁移相关的崩溃。
3. 定义和添加数据库模型
Realm使用Schema定义数据结构。以下是如何为人员、车辆和地址创建模型，并展示它们之间的关联：
人员模型:
import { Realm } from 'realm';
export class Person extends Realm.Object {
static schema = {
name: 'Person',
primaryKey: '_id',
properties: {
_id: 'objectId',
name: 'string',
age: 'int?',
date: { type: 'date', default: () => new Date() },
cars: { type: 'list', objectType: 'Car' },
address: 'Address?',
},
};
}
车辆模型:
import { Realm } from 'realm';
export class Car extends Realm.Object {
static schema = {
name: 'Car',
primaryKey: '_id',
properties: {
_id: 'objectId',
c_name: 'string',
c_color: 'string',
date: { type: 'date', default: () => new Date() },
},
};
}
地址模型:
import { Realm } from 'realm';
export class Address extends Realm.Object {
static schema = {
name: 'Address',
embedded: true,
properties: {
country: 'string?',
},
};
}
如何在Realm中添加模型及关联
Realm支持对象间的关系。在本例中：人员模型与车辆模型是一对多关系（车辆是一个车辆对象的数组），人员模型与地址模型是一对一关系（地址是一个地址对象）。
- 嵌入式对象（例如地址）直接存储在其父对象中，而不是作为数据库中的单独条目。
- 创建人员条目时，您可以分配多个车辆对象和一个地址对象，从而建立它们之间的关联。
示例：创建人员条目，包含关联的车辆和地址：
realm.write(() => {
const car1 = realm.create('Car', { _id: new Realm.BSON.ObjectID(), c_name: 'Toyota Camry', c_color: 'red' });
const car2 = realm.create('Car', { _id: new Realm.BSON.ObjectID(), c_name: 'Honda Accord', c_color: 'blue' });
realm.create('Person', {
_id: new Realm.BSON.ObjectID(),
name: 'John Doe',
age: 30,
cars: [car1, car2],
address: { country: 'USA' },
});
});
(后续的CreateScreen组件代码和用法示例与原文基本一致，略去重复部分，避免冗余。)
总结
本文介绍了如何使用@realm/react在React Native中设置Realm，理解deleteRealmIfMigrationNeeded，定义和添加Schema（人员、车辆、地址），使用关系构建数据，执行CRUD操作，以及理解嵌入式对象。Realm简化了React Native中的数据库管理，使其成为需要离线功能和高性能的应用的理想选择。
(项目仓库链接 - 此处需根据实际情况补充)
