uniapp本地存储详解

前言

在开发uniapp应用时，我们常常需要使用本地存储来保存一些数据，比如用户登录信息、设置项等，使得应用能够在设备上保存和读取数据，以便提供更好的用户体验和离线功能支持，本文将简单介绍uniapp中的本地存储相关API使用方式。

存储原理分析

为了更好地理解uniapp本地存储，先简单介绍一下计算机的存储原理。计算机的存储系统通常由主存储器（RAM）和辅助存储器（硬盘、固态硬盘等）组成。

主存储器

主存储器是计算机中用于临时存储数据和指令的地方。它以字节为单位进行存储，每个字节都有一个唯一的地址。主存储器具有快速的读写速度，但容量有限。数据在主存储器中存储时，会被划分为连续的存储单元，可以通过地址访问。

辅助存储器

辅助存储器通常具有更大的容量，但访问速度相对较慢。常见的辅助存储器包括硬盘和固态硬盘。数据在辅助存储器中以块的形式存储。块是存储器中最小的可读写单位，通常具有固定的大小（如4KB）。当需要读取或写入数据时，计算机会按照块的粒度进行操作。

存储格式和字节对齐

数据在存储器中以二进制形式表示。不同的数据类型（如整数、浮点数、字符等）在存储器中占用的字节数不同。为了高效存储和访问数据，计算机要求数据按照字节对齐的方式存储。字节对齐指的是数据存储的起始地址必须是其数据类型大小的整数倍。

uniapp 本地存储

1. uni.setStorage(OBJECT)与uni.getStorage(OBJECT)

uni.setStorage(OBJECT)

将数据存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个异步接口。

示例代码

uni.setStorage({
    
    
	key: 'storage_key',
	data: 'hello',
	success: function () {
    
    
		console.log('success');
	}
});

uni.getStorage(OBJECT)

从本地缓存中异步获取指定 key 对应的内容。

示例代码

uni.getStorage({
    
    
	key: 'storage_key',
	success: function (res) {
    
    
		console.log(res.data);
	}
});

2. uni.setStorageSync与uni.getStorageSync

uni.setStorageSync(KEY,DATA)

将 data 存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个同步接口。

try {
    
    
	uni.setStorageSync('storage_key', 'hello');
} catch (e) {
    
    
	// error
}

uni.getStorageSync(KEY)

从本地缓存中同步获取指定 key 对应的内容。

示例代码

try {
    
    
	const value = uni.getStorageSync('storage_key');
	if (value) {
    
    
		console.log(value);
	}
} catch (e) {
    
    
	// error
}

3. 获取存储信息uni.getStorageInfo与uni.getStorageInfoSync

uni.getStorageInfoSync()

同步获取当前 storage 的相关信息。

示例

try {
    
    
	const res = uni.getStorageInfoSync();
	console.log(res.keys);
	console.log(res.currentSize);
	console.log(res.limitSize);
} catch (e) {
    
    
	// error
} 

uni.getStorageInfo(OBJECT)

异步获取当前 storage 的相关信息

示例代码

uni.getStorageInfo({
    
    
	success: function (res) {
    
    
		console.log(res.keys);
		console.log(res.currentSize);
		console.log(res.limitSize);
	}
});

4. 移除 uni.removeStorage与uni.removeStorageSync

uni.removeStorage(OBJECT)

从本地缓存中异步移除指定 key。

代码示例

uni.removeStorage({
    
    
	key: 'storage_key',
	success: function (res) {
    
    
		console.log('success');
	}
}); 

uni.removeStorageSync(KEY)

从本地缓存中同步移除指定 key。

示例代码

try {
    
    
	uni.removeStorageSync('storage_key');
} catch (e) {
    
    
	// error
} 

uni.clearStorage()

清理本地数据缓存。

示例

uni.clearStorage();

uni.clearStorageSync()

同步清理本地数据缓存。

示例

try {
    
    
	uni.clearStorageSync();
} catch (e) {
    
    
	// error
}

注意事项

• uni.setStorageSync和uni.getStorageSync都是同步方法，调用后会阻塞线程，所以在使用时需要注意不要在UI线程中频繁调用这些方法，以免影响应用性能。
• uni.setStorageSync保存的数据大小不能超过10MB。
• uni.setStorageSync保存的数据只能在当前小程序中访问，不能跨小程序或跨设备访问。
• 如果要保存的数据较大或者需要长期保存，建议使用uni.setStorage和uni.getStorage方法，这两个方法是异步方法，不会阻塞线程。在实现上，它们可能会使用文件系统缓存等技术来提高读写效率。
• H5端为localStorage，浏览器限制5M大小，是缓存概念，可能会被清理
• App端为原生的plus.storage，无大小限制，不是缓存，是持久化的
• 各个小程序端为其自带的storage api，数据存储生命周期跟小程序本身一致，即除用户主动删除或 超过一定时间被自动清理，否则数据都一直可用。
• 微信小程序单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
• 支付宝小程序单条数据转换成字符串后，字符串长度最大200*1024。同一个支付宝用户，同一个小程序缓存总上限为10MB。
• 百度小程序策略详见、字节跳动小程序策略详见
• 非App平台清空Storage会导致uni.getSystemInfo获取到的deviceId改变
• 除此之外，其他数据存储方案：
  H5端还支持websql、indexedDB、sessionStorage
  App端还支持SQLite、IO文件等本地存储方案。

总结

当我们调用对应方法时，uniapp会将数据以键值对的形式存储在本地存储中。具体实现中，uniapp会将键值对转换成字节流，并将字节流写入到设备的存储器中。这个过程涉及到计算机底层存储原理的数据存储和字节对齐。在读取数据时，会根据指定的键，从本地存储中读取相应的数据。根据键的索引或哈希值，定位到存储器中相应的数据块，并读取字节流。然后，将字节流转换为相应的数据类型，供应用程序使用。调用uni.removeStorageSync方法，将指定键的数据从本地存储中移除。计算机会找到相应的数据块，并将其标记为可覆盖的状态，从而释放存储空间。

结语

以上就是uniapp提供的各种本地存储方式及其底层实现机制的简单罗列和使用示例，uniapp的本地存储的逻辑涉及到计算机数据的写入、读取、文件系统管理、磁盘块分配等底层技术。在实际开发中，我们应该根据需求选择合适的方法进行本地存储操作，并尽量减少对本地存储的频繁访问，以提高应用性能。