微信小程序API 数据缓存

微信小程序API 数据缓存

微信小程序提供了丰富的API来帮助开发者实现数据缓存功能，数据缓存可以帮助小程序在离线状态下仍然能够访问到一些重要的数据，提高用户体验，本文将介绍微信小程序中常用的数据缓存API，并给出相应的使用示例。

1、本地缓存

微信小程序提供了本地缓存API，可以将数据存储在本地，以便在离线状态下进行访问，本地缓存分为两种类型：永久存储和临时存储。

1、1 永久存储

永久存储是指将数据存储在本地的磁盘上，即使小程序被关闭或手机重启，数据仍然存在，可以使用wx.setStorageSync()和wx.getStorageSync()方法进行数据的存储和读取。

示例代码：

// 存储数据
wx.setStorageSync('key', 'value');
// 读取数据
const value = wx.getStorageSync('key');
console.log(value); // 'value'

1、2 临时存储

临时存储是指将数据存储在内存中，当小程序被关闭或手机重启时，数据会被清除，可以使用wx.setStorage()和wx.getStorage()方法进行数据的存储和读取。

示例代码：

// 存储数据
wx.setStorage({
  key: 'key',
  data: 'value',
  duration: 1000 // 有效期为1秒（单位：毫秒）
});
// 读取数据
const value = wx.getStorage({
  key: 'key',
  success: function (res) {
    console.log(res.data); // 'value'
  }
});

2、Web缓存

Web缓存是指将数据存储在浏览器的缓存中，以提高页面加载速度，可以使用wx.clearStorageSync()和wx.clearStorage()方法清除本地缓存。

示例代码：

// 清除本地缓存（同步）
wx.clearStorageSync();
// 清除本地缓存（异步）
wx.clearStorage({
  success: function () {
    console.log('清除成功');
  }
});

3、数据库缓存

数据库缓存是指将数据存储在小程序的云数据库中，以实现数据的持久化存储，可以使用wx.cloud.database()方法获取数据库实例，然后调用相应的API进行数据的增删改查。

示例代码：

const db = wx.cloud.database();
const todosCollection = db.collection('todos');
// 添加一条记录到集合中（异步）
todosCollection.add({
  data: { text: 'Hello, World!' },
  success: function (res) {
    console.log('添加成功', res);
  }
});

4、文件缓存

文件缓存是指将文件存储在小程序的文件系统中，以实现文件的持久化存储，可以使用wx.saveFile()和wx.readFile()方法进行文件的保存和读取。

示例代码：

// 保存文件（异步）
wx.saveFile({
  tempFilePath: 'tempFilePath', // 临时文件路径，用于获取文件信息（如大小、创建时间等）的字段值，必填参数，该路径不能为空；否则会报错（ENOSPCNOSPACE），tempFilePath可以是本地文件路径、临时文件路径、网络图片地址、云文件ID等，建议使用云文件ID，可通过wx.cloud.uploadFile()方法获取，最大不超过1MB，不支持打开文档选择文件，仅支持从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，filePath为空的情况下，返回的是临时文件路径，isNewFile为true表示本次保存的是新文件，若已存在同名文件，将会覆盖旧文件；isNewFile为false表示本次保存的是更新已有的文件，如果isNewFile为false且同名文件不存在时，会生成一个与当前时间戳相同的随机字符串作为文件名，saveSuccess回调函数会在保存成功后执行，参数为文件信息对象，error回调函数会在保存失败后执行，参数为错误信息对象，success回调函数会在保存成功后执行，参数为文件ID（由底层生成），如果isNewFile为false且同名文件已经存在，则返回原文件ID，fail回调函数会在保存失败后执行，参数为错误信息对象，complete回调函数会在保存完成时执行，无论成功或失败都会执行，可以通过complete回调函数获取到文件的保存路径（如无权限或保存失败时），注意：该回调函数的参数是一个Promise对象，该Promise对象成功时resolve的参数是文件的完整路径（如无权限或保存失败时则为空）；失败时reject的参数是错误信息对象，saveFile方法不会检查文件夹是否存在，如果需要检查文件夹是否存在，请在调用saveFile方法前先使用mkdir接口创建文件夹，同时需要注意，saveFile方法不支持跨域访问图片资源，请确保图片资源在小程序所在域名下，因此在使用saveFile方法保存图片时，请确保图片资源的URL是合法的跨域URL或者同源URL，另外需要注意的是，由于小程序的安全机制限制，无法直接访问用户手机中的本地资源（如相册、相机等），因此在使用saveFile方法保存图片时，请确保图片资源的URL是合法的跨域URL或者同源URL，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照后向服务器上传的方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取图片链接，请使用chooseImage接口，如果需要从本地相册选取图片或拍照中方式获取