使用Realm数据库构建React本地应用

引言

在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 (
    <RealmProvider schema={[Person, Car, Address]}>
      <NavigationContainer>
        <Tab.Navigator>
          <Tab.Screen name="Create" component={CreateScreen} />
        </Tab.Navigator>
      </NavigationContainer>
    </RealmProvider>
  );
};

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支持对象间的关系。在本例中：人员模型与车辆模型是一对多关系（车辆是一个车辆对象的数组），人员模型与地址模型是一对一关系（地址是一个地址对象）。

1. 嵌入式对象（例如地址）直接存储在其父对象中，而不是作为数据库中的单独条目。
2. 创建人员条目时，您可以分配多个车辆对象和一个地址对象，从而建立它们之间的关联。

示例：创建人员条目，包含关联的车辆和地址：

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中的数据库管理，使其成为需要离线功能和高性能的应用的理想选择。

(项目仓库链接 - 此处需根据实际情况补充)