返回插件列表

MMKVMMKVExternal

MMKV:数据本地持久化存储,存储在app内部,应用被卸载,数据则会被删除。

MMKVExternal:数据持久化存储,存储在app外部,应用被卸载,数据不会被删除。

MMKV

注意事项

  1. 支持的数据类型:String.
  2. MMKV 支持 iOS 8 以上.
  3. MMKV 支持 Android 4.2 以上.

目录

  1. 获取mmkv实例对象

  2. 关闭mmkv实例对象

  3. 通过mmkv实例对象存数据

  4. 通过mmkv实例对象取数据

  5. 通过mmkv实例对象删除数据

  6. 通过mmkv实例对象删除多个数据

  7. 通过mmkv实例对象删除所有数据

  8. 通过mmkv实例对象获取所有键值对数据

API

获取mmkv实例对象

MMKV.mmkvWithID(success, error, mmkvId);
参数 类型 必填 说明
mmkvId string 唯一标识,如果此值为空则为默认标识
success function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
var mmkv = MMKV.mmkvWithID(
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  },
  "com.mysoft.appcloud"
);

关闭mmkv实例对象

mmkv.close(success, error);
参数 类型 必填 说明
success function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
mmkv.close(
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  }
);

通过mmkv实例对象存数据

mmkv.setValue(key, value, success, error);
参数 类型 必填 说明
key string key
value string value
success function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
mmkv.setValue(
  "team",
  "appcloud",
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  }
);

通过mmkv实例对象取数据

mmkv.getValueForKey(key, success, error);
参数 类型 必填 说明
key string key
success function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
mmkv.getValueForKey(
  "team",
  function (value) {
    console.log('success', value);
  },
  function (err) {
    console.log('err', err);
  }
);

通过mmkv实例对象删除数据

mmkv.removeValueForKey(key,success, error);
参数 类型 必填 说明
key string key
success function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
mmkv.removeValueForKey(
  "team",
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  }
);

通过mmkv实例对象删除多个数据

mmkv.removeValuesForKeys(keys, success, error);
参数 类型 必填 说明
keys array keys
success function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
mmkv.removeValuesForKeys(
  ["team"],
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  }
);

通过mmkv实例对象删除所有数据

mmkv.clearAll(success, error);
参数 类型 必填 说明
success function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
mmkv.clearAll(
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  }
);

通过mmkv实例对象获取所有键值对数据

mmkv.enumerateAll(success, error);
参数 类型 必填 说明
success(result) function 成功回调,result为json对象,返回mmkv对象下的所有键值对数据
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
mmkv.enumerateAll(
  function (result) {
    console.log('success', result);
  },
  function (err) {
    console.log('err', err);
  }
);

MMKVExternal

注意事项

  1. 建议仅用于存储用户名、密码等简单数据,大数据量建议使用MMKV

  2. iOS:仅且只有当设备刷机时,存储数据会被清空;

  3. Android:仅且只有当设备进行格式化存储空间操作时,那么之前的数据将会被清空。

目录

  1. 存储数据

  2. 查询数据

  3. 删除数据

存储数据

MMKVExternal.setValue(service,key,value,success, error);
参数 类型 必填 说明
service string 服务
key string key
value string value
success(result) function 成功回调
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
MMKVExternal.setValue("appcloud","userName","zhangsan",
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  }
);

查询数据

MMKVExternal.getValueForKey(service, key ,success, error);
参数 类型 必填 说明
service string 服务
key string key
success(result) function 成功回调,result为json对象
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
MMKVExternal.getValueForKey("appcloud","userName",
  function (result) {
    console.log('success', result);
  },
  function (err) {
    console.log('err', err);
  });

删除数据

MMKVExternal.removeValueForKey(service, key ,success, error);
参数 类型 必填 说明
service string 服务
key string key
success(result) function 成功回调,result为json对象,返回mmkv对象下的所有键值对数据
error(err) function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}
// 示例
MMKVExternal.removeValueForKey("appcloud","userName",
  function () {
    console.log('success');
  },
  function (err) {
    console.log('err', err);
  }
);