LightSDK.native.readData

功能描述

通过js接口查询存储在native的属性

支持格式

Json

请求参数:

字段 可选 类型及范围 说明
key string native存储数据的key(key和multi_param必须传一个)
keepType bool 传true:value可以支持string、object、Array、bool、number等类型的数据。默认false,即只支持string或object类型的数据
scope string native存储域
component_scope string 组件域,如不传此字段默认读取存储在当前组件域下的数据,防止数据被跨域读取、修改。如果想跨域共享数据,传值global即可
domain string file表示存储在存储器中,应用退出后数据仍然保存。memory表示缓存在内存中,应用退出后即被销毁。默认是file
multi_param json对象数组 支持一次性读取多个值如[{key:key1,scope:scope1},{key:key2,scope:scope2}]

注:

  • 若LightSDK.native.writeData存储时传了keepType=true,调用LightSDK.native.readData读取数据时此字段也必须传值true。

请求调用示例1

params={
"key":"test",
"scope":"scope1"
}
LightSDK.native.readData(params,cb);

返回字段示例1

{
"info": {
"error_code": "0",
"error_message": "success"
},
"data":
{"result":"testValue"}
}

请求调用示例2-多个成功的

params={
"multi_param":[{key:"test1",scope:"scope1"},{key:"test2",scope:"scope2"}]
}
LightSDK.native.readData(params,cb);

返回结果示例2

{
"info": {
"error_code": "0",
"error_message": "success"
},
"data":[{"data":{"result":"testValue1"}},{"data":{"result":"testValue2"}}]
}

请求调用示例3-多个包括异常的

params={
"multi_param":[{key:"test1",scope:"scope1"},{scope:"scope2"}]
}
LightSDK.native.readData(params,cb);

返回结果示例3

{
"info": {
"error_code": "0",
"error_message": "success"
},
"data":[{"data":{"result":"testValue1"}},{"info":{"error_info":"缺少必要的参数","error_extinfo":"缺少必要的参数[key]","error_no":"10001","error_code":"10001"}}]
}

返回值说明

字段名 字段类型 说明
result string或object 查询到的json格式数据
info json 返回的异常信息格式,请参考错误信息说明

注意事项

效果