UniApp中的本地存储方式详解

引言

在移动应用开发中，本地存储是一个关键的功能，能够帮助应用在没有网络连接的情况下保持数据的持久性。UniApp提供了两种主要的本地存储方式：本地缓存和本地数据库。本文将详细介绍这两种存储方式及其使用方法，以便开发者根据需求选择合适的解决方案。

一、本地缓存

本地缓存是一种轻量级的存储方式，适用于存储小型数据。它采用键值对的形式，数据在小程序关闭后仍然保留。

1.1 使用uni.setStorageSync保存数据

要将数据存储到本地缓存中，可以使用 uni.setStorageSync方法。该方法接受两个参数：键（key）和数据（data）。

uni.setStorageSync('username', 'john_doe');

以上代码将字符串 'john_doe'保存到键为 'username'的本地缓存中。

1.2 使用uni.getStorageSync获取数据

要从本地缓存中获取数据，可以使用 uni.getStorageSync方法。该方法接受一个参数：键（key）。

const username = uni.getStorageSync('username');
console.log(username); // 输出: john_doe

以上代码将获取键为 'username'的值，并输出到控制台。

1.3 使用uni.removeStorageSync移除数据

要从本地缓存中移除数据，可以使用 uni.removeStorageSync方法。该方法接受一个参数：键（key）。

uni.removeStorageSync('username');

以上代码将移除键为 'username'的数据。

1.4 使用uni.clearStorageSync清空所有数据

要清空本地缓存中的所有数据，可以使用 uni.clearStorageSync方法。

uni.clearStorageSync();

以上代码将清空本地缓存中的所有数据。

二、本地数据库

本地数据库基于SQLite，支持更复杂的数据操作，如查询、更新和删除。适用于需要持久存储和管理大量数据的应用。

2.1 打开或创建数据库

要打开或创建一个本地数据库，可以使用 uni.openDatabase方法。该方法接受一个对象，包含数据库的名称（name）和路径（path）。

const db = uni.openDatabase({
    name: 'my_database',
    path: '_doc/my_database.db'
});

以上代码将打开或创建一个名为 'my_database'的数据库，数据库文件保存在路径 '_doc/my_database.db'。

2.2 执行SQL语句

要在数据库中执行SQL语句，可以使用 database.executeSql方法。该方法接受一个对象，包含SQL语句（sql）和成功回调函数（success）。

db.executeSql({
    sql: 'CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)',
    success: function () {
        console.log('Table created successfully');
    }
});

以上代码将在数据库中创建一个名为 'users'的表。

2.3 执行查询操作

要执行查询操作，可以使用相同的 executeSql方法，并在回调函数中处理查询结果。

db.executeSql({
    sql: 'SELECT * FROM users',
    success: function (result) {
        console.log(result.rows); // 输出查询结果
    }
});

以上代码将查询 'users'表中的所有数据，并输出到控制台。

2.4 开启事务

要在数据库中开启一个事务，可以使用 database.transaction方法。该方法接受一个对象，包含一系列的SQL操作和成功回调函数。

db.transaction({
    actions: [
        { sql: 'INSERT INTO users (name) VALUES (?)', args: ['Alice'] },
        { sql: 'INSERT INTO users (name) VALUES (?)', args: ['Bob'] }
    ],
    success: function () {
        console.log('Transaction completed successfully');
    }
});

以上代码将在事务中插入两条记录到 'users'表中。

本地存储方式对比分析

思维导图

总结

UniApp提供了本地缓存和本地数据库两种本地存储方式，开发者可以根据具体需求选择合适的存储方式。对于轻量级的数据存储，本地缓存是一个简单而高效的选择；而对于需要复杂数据操作和管理的场景，本地数据库则提供了更强大的功能。通过本文的详细介绍和示例，您可以在开发过程中灵活应用这两种存储方式，提升应用的用户体验和数据管理能力。