From f6136c4570bcafab73dec670bac45f3222a4da53 Mon Sep 17 00:00:00 2001
From: hdwZous <18310002219@163.com>
Date: Tue, 16 Dec 2025 18:33:19 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20[Issues:=20#ICQ5WX]=20=E4=BF=AE?=
=?UTF-8?q?=E6=94=B9sqlite=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
en/react-native-sqlite-storage.md | 638 ---------------------------
zh-cn/react-native-sqlite-storage.md | 18 +-
2 files changed, 9 insertions(+), 647 deletions(-)
diff --git a/en/react-native-sqlite-storage.md b/en/react-native-sqlite-storage.md
index 73859e53..e69de29b 100644
--- a/en/react-native-sqlite-storage.md
+++ b/en/react-native-sqlite-storage.md
@@ -1,638 +0,0 @@
-> Template version: v0.2.2
-
-
-
react-native-sqlite-storage
-
-
-
- 
-
-
- 
-
-
-
-> [!TIP] [Github address](https://github.com/react-native-oh-library/react-native-sqlite-storage)
-
-
-## Installation and Usage
-
-Find the matching version information in the release address of a third-party library: [@react-native-oh-tpl/react-native-sqlite-storage Releases](https://github.com/react-native-oh-library/react-native-sqlite-storage/releases).For older versions that are not published to npm, please refer to the [installation guide](/en/tgz-usage-en.md) to install the tgz package.
-
-Go to the project directory and execute the following instruction:
-
-
-
-
-
-#### **npm**
-
-```bash
-npm install @react-native-oh-tpl/react-native-sqlite-storage
-```
-
-#### **yarn**
-
-```bash
-yarn add @react-native-oh-tpl/react-native-sqlite-storage
-```
-
-The following code shows the basic use scenario of the repository:
-
-> [!WARNING] The name of the imported repository remains unchanged.
-
-```js
-/**
- * @format
- */
-import React, {Component} from 'react';
-import { StyleSheet, Text, View, FlatList} from 'react-native';
-import SQLite from 'react-native-sqlite-storage';
-SQLite.DEBUG(true);
-SQLite.enablePromise(false);
-
-const database_name = 'Test.db';
-const database_version = '1.0';
-const database_displayname = 'SQLite Test Database';
-const database_size = 200000;
-let db: any;
-const Item = (props: any) => {
- const { title } = props;
- return(
-
- {title}
-
- )
-};
-
-interface SQLiteDemo {
- progress: string[]
-}
-
-interface State {
- progress: string[]
-}
-
-interface rowsType {
- item: any,
- length: number
-}
-
-interface ResultType {
- rows: rowsType
-}
-
-class SQLiteDemo extends Component<{}, State> {
- constructor(props: any) {
- super(props);
- this.progress = [];
- this.state = {
- progress: [],
- };
- }
-
- updateProgress = (text: string, resetState?: boolean) => {
- let progress: string[] = [];
- if (!resetState) {
- progress = [...this.progress];
- }
- progress.push(text);
- this.progress = progress;
- this.setState({
- progress,
- });
- };
-
- componentWillUnmount = () => {
- this.closeDatabase();
- };
-
- errorCB = (err: any) => {
- console.log('error: ', err);
- this.updateProgress('Error: ' + (err.message || err));
- return false;
- };
-
- successCB = () => {
- console.log('SQL executed ...');
- };
-
- openCB = () => {
- this.updateProgress('Database OPEN');
- };
-
- closeCB = () => {
- this.updateProgress('Database CLOSED');
- };
-
- deleteCB = () => {
- console.log('Database DELETED');
- this.updateProgress('Database DELETED');
- };
-
- // eslint-disable-next-line no-shadow
- populateDatabase = (db: any) => {
- this.updateProgress('Database integrity check');
- db.executeSql(
- 'SELECT 1 FROM Version LIMIT 1',
- [],
- () => {
- this.updateProgress('Database is ready ... executing query ...');
- db.transaction(this.queryEmployees, this.errorCB, () => {
- this.updateProgress('Processing completed');
- });
- },
- (error: any) => {
- console.log('received version error:', error);
- this.updateProgress('Database not yet ready ... populating data');
- db.transaction(this.populateDB, this.errorCB, () => {
- this.updateProgress('Database populated ... executing query ...');
- db.transaction(this.queryEmployees, this.errorCB, () => {
- console.log('Transaction is now finished');
- this.updateProgress('Processing completed');
- // this.closeDatabase();
- });
- });
- },
- );
- };
-
- populateDB = (tx: any) => {
- this.updateProgress('Executing DROP stmts');
-
- tx.executeSql('DROP TABLE IF EXISTS Employees;');
- tx.executeSql('DROP TABLE IF EXISTS Offices;');
- tx.executeSql('DROP TABLE IF EXISTS Departments;');
-
- this.updateProgress('Executing CREATE stmts');
-
- tx.executeSql(
- 'CREATE TABLE IF NOT EXISTS Version( ' +
- 'version_id INTEGER PRIMARY KEY NOT NULL); ',
- [],
- this.successCB,
- this.errorCB,
- );
-
- tx.executeSql(
- 'CREATE TABLE IF NOT EXISTS Departments( ' +
- 'department_id INTEGER PRIMARY KEY NOT NULL, ' +
- 'name VARCHAR(30) ); ',
- [],
- this.successCB,
- this.errorCB,
- );
-
- tx.executeSql(
- 'CREATE TABLE IF NOT EXISTS Offices( ' +
- 'office_id INTEGER PRIMARY KEY NOT NULL, ' +
- 'name VARCHAR(20), ' +
- 'longtitude FLOAT, ' +
- 'latitude FLOAT ) ; ',
- [],
- this.successCB,
- this.errorCB,
- );
-
- tx.executeSql(
- 'CREATE TABLE IF NOT EXISTS Employees( ' +
- 'employe_id INTEGER PRIMARY KEY NOT NULL, ' +
- 'name VARCHAR(55), ' +
- 'office INTEGER, ' +
- 'department INTEGER, ' +
- 'custom_info TEXT DEFAULT "",' +
- 'FOREIGN KEY ( office ) REFERENCES Offices ( office_id ) ' +
- 'FOREIGN KEY ( department ) REFERENCES Departments ( department_id ));',
- [],
- );
-
- this.updateProgress('Executing INSERT stmts');
-
- tx.executeSql(
- 'INSERT INTO Departments (name) VALUES ("Client Services");',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Departments (name) VALUES ("Investor Services");',
- [],
- );
- tx.executeSql('INSERT INTO Departments (name) VALUES ("Shipping");', []);
- tx.executeSql(
- 'INSERT INTO Departments (name) VALUES ("Direct Sales");',
- [],
- );
-
- tx.executeSql(
- 'INSERT INTO Offices (name, longtitude, latitude) VALUES ("Denver", 59.8, 34.);',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Offices (name, longtitude, latitude) VALUES ("Warsaw", 15.7, 54.);',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Offices (name, longtitude, latitude) VALUES ("Berlin", 35.3, 12.);',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Offices (name, longtitude, latitude) VALUES ("Paris", 10.7, 14.);',
- [],
- );
-
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Sylvester Stallone", 2, 4, \'{"known": true}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Elvis Presley", 2, 4, \'{"known": true}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Leslie Nelson", 3, 4, \'{"known": true}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Fidel Castro", 3, 3, \'{"known": true}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Bill Clinton", 1, 3, \'{"known": false}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Margaret Thatcher", 1, 3, \'{"known": true}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Donald Trump", 2, 4, \'{"known": true, "impeached": true}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Dr DRE", 2, 2, \'{"known": true}\')',
- [],
- );
- tx.executeSql(
- 'INSERT INTO Employees (name, office, department, custom_info) VALUES ("Samantha Fox", 2, 1, \'{"known": true}\')',
- [],
- );
-
- console.log('all config SQL done');
- };
-
- queryEmployees = async (tx: any) => {
- console.log('Executing JSON1 queries...');
-
- // 1. JSON_OBJECT
- await tx.executeSql(
- "SELECT JSON_OBJECT('name', e.name, 'office_id', e.office, 'department_id', e.department) AS data FROM Employees e",
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 2. JSON_ARRAY
- // Expected: [1,2,"3",4]
- await tx.executeSql(
- "SELECT JSON_ARRAY(1, 2, '3', 4) AS data ",
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 3. JSON_ARRAY_LENGTH
- // Expected: 4
- await tx.executeSql(
- "SELECT JSON_ARRAY_LENGTH('[1, 2, 3, 4]') AS data",
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 4. JSON_EXTRACT
- await tx.executeSql(
- "SELECT JSON_EXTRACT(e.custom_info, '$.known') AS data FROM Employees e",
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 5. JSON_INSERT
- // Expected: {"a":1,"b":2,"c":3}
- await tx.executeSql(
- 'SELECT JSON_INSERT(\'{"a": 1, "b": 2}\', \'$.c\', 3) AS data',
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 6. JSON_REPLACE
- // Expected: {"a":1,"b":3}
- await tx.executeSql(
- 'SELECT JSON_REPLACE(\'{"a": 1, "b": 2}\', \'$.b\', 3) AS data',
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 7. JSON_SET
- // Expected: {"a":1,"b":123}
- await tx.executeSql(
- 'SELECT JSON_SET(\'{"a": 1, "b": 2}\', \'$.b\', 123) AS data',
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 8. JSON_REMOVE
- // Expected: {"a":1"}
- await tx.executeSql(
- 'SELECT JSON_REMOVE(\'{"a": 1, "b": 2}\', \'$.b\') AS data',
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 9. JSON_TYPE
- // Expected: integer
- await tx.executeSql(
- 'SELECT JSON_TYPE(\'{"a": 1, "b": 2}\', \'$.a\') AS data',
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 10. JSON_VALID
- // Expected: 0
- await tx.executeSql(
- 'SELECT JSON_VALID(\'{"a": 1, "b": 2\') AS data',
- [],
- this.querySuccess,
- this.errorCB,
- );
-
- // 11. JSON_QUOTE
- // Expected: "value"
- await tx.executeSql(
- "SELECT JSON_QUOTE('value') AS data",
- [],
- this.querySuccess,
- this.errorCB,
- );
- };
-
- querySuccess = (tx: any, results: ResultType) => {
- this.updateProgress('Query completed');
- var len = results.rows.length;
- for (let i = 0; i < len; i++) {
- let row = results.rows.item(i);
- this.updateProgress(`${row.data}`);
- }
- };
-
- loadAndQueryDB = () => {
- this.updateProgress('Opening database ...', true);
- this.updateProgress('Database OPEN');
- db = SQLite.openDatabase(
- database_name,
- database_version,
- database_displayname,
- database_size,
- this.openCB,
- this.errorCB,
- );
- this.populateDatabase(db);
- };
-
- deleteDatabase = () => {
- this.updateProgress('Deleting database');
- SQLite.deleteDatabase(database_name, this.deleteCB, this.errorCB);
- };
-
- closeDatabase = () => {
- if (db) {
- console.log('Closing database ...');
- this.updateProgress('Closing database');
- db.close(this.closeCB, this.errorCB);
- } else {
- this.updateProgress('Database CLOSE callback function error');
- // this.updateProgress('Database was not OPENED');
- }
- };
-
- runDemo = () => {
- this.updateProgress('Starting SQLite Callback Demo', true);
- this.loadAndQueryDB();
- };
-
- attachDatabase = () =>{
- if (db!=null) {
- this.updateProgress('Attach database ...');
- let dbMaster = SQLite.openDatabase('test2.db',database_version,database_displayname,database_size,
- () => {
- dbMaster.attach( database_name, database_displayname, () => console.log("Database attached successfully"), () => console.log("ERROR"))
- this.updateProgress('Attach database successfully');
- },
- this.errorCB,
- );
- } else {
- this.updateProgress('Database not open');
- }
-
- }
-
- render = () => {
- return (
-
-
-
- Run Demo
-
-
- Attach DB
-
-
- Close DB
-
-
- Delete DB
-
-
-