数据存储

在某些应用场景中需要永久存储一些信息(掉电保存数据),如账号、密码或其他配置的一些信息,这些数据的特点是:总量少,但需要灵活存取。像这类情况,就不必使用数据库。我们提供了一套简单的数据存储接口,以键-值对的方式存储。

  • 所需头文件

      #include "storage/StoragePreferences.h"
    
  • 主要接口

      // 存储接口
      static bool putString(const std::string &key, const std::string &val);
      static bool putInt(const std::string &key, int val);
      static bool putBool(const std::string &key, bool val);
      static bool putFloat(const std::string &key, float val);
    
      // 删除指定键
      static bool remove(const std::string &key);
      // 清空存储数据
      static bool clear();
    
      // 获取接口,获取不到对应键值,返回defVal默认值
      static std::string getString(const std::string &key, const std::string &defVal);
      static int getInt(const std::string &key, int defVal);
      static bool getBool(const std::string &key, bool defVal);
      static float getFloat(const std::string &key, float defVal);
    

[!Warning]

  1. 该接口是将数据以文件的形式保存在flash中, 所以请勿频繁写入,造成flash损坏。
  2. 该分区大小有限制,屏的型号不同,分区大小也不同。尽量将数据大小控制在512KB以内。

使用示例

  • 保存

    //保存字符串,以“username”为别名,值为name字符串
    const char* name = "zhang san";
    StoragePreferences::putString("username", name);
    
    //保存布尔变量,以“power”为别名,值为true
    StoragePreferences::putBool("power", true);
    
    //保存浮点数,以“temperature”为别名, 值为30.12
    StoragePreferences::putFloat("temperature", 30.12);
    
    //保存整型,以“age”为别名,值为20
    StoragePreferences::putInt("age", 20);
    
  • 读取

    //读取“username”这个键的值,如果没有值,返回空字符串
    std::string name = StoragePreferences::getString("username", "");
    //日志打印读取到的字符串
    LOGD("username %s\n", username.c_str());
    
    //读取布尔变量,如果没有值,则指定返回false
    bool power = StoragePreferences::getBool("power", false);
    
    //读取浮点数,如果没有值,则指定返回0
    float temperature = StoragePreferences::getFloat("temperature", 0);
    
    //读取整型,如果没有值,则指定返回18
    int age = StoragePreferences::getInt("age", 18);
    
  • 删除
    //单独清空某一个值
    StoragePreferences::remove("username");
    StoragePreferences::remove("power");
    StoragePreferences::remove("temperature");
    StoragePreferences::remove("age");
    //清空所有值
    StoragePreferences::clear();
    
  • 修改
    如果需要修改某个值,只需要按键值重复保存即可,将自动覆盖旧的值
powered by Gitbooklast modified: 2021-05-28 12:00:31

results matching ""

    No results matching ""