React Native Quick SQLite 使用教程

React Native Quick SQLite 使用教程

react-native-quick-sqlite A fast react-native SQLite library built using JSI 项目地址: https://gitcode.com/gh_mirrors/rea/react-native-quick-sqlite

1. 项目介绍

react-native-quick-sqlite 是一个基于 JSI（JavaScript Interface）构建的快速 React Native SQLite 库。它嵌入了最新版本的 SQLite，并提供了一个低级别的 JSI 支持的 API 来执行 SQL 查询。与传统的桥接方式相比，react-native-quick-sqlite 在性能上有显著提升，尤其是在处理大量数据时。

主要特点：

• 高性能：使用 JSI 技术，性能提升显著，尤其是在处理大量数据时。
• 低级别 API：提供了一个低级别的 API，允许开发者直接执行 SQL 查询。
• 支持 TypeORM：虽然 TypeORM 在 React Native 0.71 版本中存在解析问题，但该库仍然支持 TypeORM。

2. 项目快速启动

安装

首先，通过 npm 或 yarn 安装 react-native-quick-sqlite：

yarn add react-native-quick-sqlite
npx pod-install

初始化数据库

在你的 React Native 项目中，初始化并打开一个 SQLite 数据库：

import { open } from 'react-native-quick-sqlite';

const db = open('myDb.sqlite');

执行查询

执行一个简单的 SQL 查询：

try {
  const [rows] = db.execute('SELECT somevalue FROM sometable');
  rows.forEach((row) => {
    console.log(row);
  });
} catch (e) {
  console.error('Something went wrong executing SQL commands:', e.message);
}

异步查询

如果查询量较大，可以使用异步版本：

db.executeAsync('SELECT * FROM User').then(([rows]) => {
  console.log('users', rows);
});

3. 应用案例和最佳实践

事务处理

在处理大量数据时，使用事务可以显著提高性能：

await db.transaction((tx) => {
  const [status] = tx.execute('UPDATE sometable SET somecolumn = ? where somekey = ?', [0, 1]);
  // 异步执行
  await tx.executeAsync('UPDATE sometable SET somecolumn = ? where somekey = ?', [0, 1]);
  // 手动提交或回滚
  tx.commit();
  // 或者 tx.rollback();
});

批量操作

批量执行 SQL 命令可以减少开销：

const commands = [
  ['CREATE TABLE TEST (id integer)'],
  ['INSERT INTO TEST (id) VALUES (?)', [1]],
  ['INSERT INTO TEST (id) VALUES (?)', [2]],
  ['INSERT INTO TEST (id) VALUES (?)', [[3], [4], [5], [6]]],
];

const res = db.executeBatch(commands);
console.log(`Batch affected ${res.rowsAffected} rows`);

4. 典型生态项目

TypeORM

react-native-quick-sqlite 可以与 TypeORM 结合使用，但需要注意 TypeORM 在 React Native 0.71 版本中存在解析问题。你可以通过以下方式解决：

1. 暴露 package.json：TypeORM 需要访问 package.json，因此你需要手动暴露它。
2. 使用 patch-package：通过 patch-package 将这些更改永久化。

// package.json
{
  "name": "your-project",
  "dependencies": {
    "typeorm": "latest"
  },
  "main": "index.js",
  "scripts": {
    "postinstall": "patch-package"
  }
}

其他生态项目

• React Native Paper：一个 Material Design 风格的 UI 库，可以与 react-native-quick-sqlite 结合使用，提供更好的用户体验。
• React Navigation：用于导航的库，可以帮助你更好地组织和管理应用的导航结构。

通过这些生态项目的结合，你可以构建一个功能强大且性能优越的 React Native 应用。

react-native-quick-sqlite A fast react-native SQLite library built using JSI 项目地址: https://gitcode.com/gh_mirrors/rea/react-native-quick-sqlite