交换数据 exchange 1050+

接口声明

提供了一个不同快应用间数据交互的方式。快应用可以利用它发布数据，或从其他快应用获取数据

数据交互有三个数据空间，分别是应用空间（application）、应用开发商空间（vendor，1080+）和全局空间（global）

application：数据发布在应用空间，读取、修改(1080+)、删除(1080+)时需同时指定发布方的包名和签名，并且需要发布方授权

vendor(1080+)：数据发布在应用开发商空间，同签名的多个应用的写操作会相互覆盖，读取时不能指定发布方的包名和签名，不需要发布方授权

global：数据发布在全局空间，多个应用的写操作会相互覆盖，读取时不能指定发布方的包名和签名，不需要发布方授权

注意：

set、get 操作支持在 application、vendor(1080+) 和global 空间上操作数据

remove、clear、grantPermission、revokePermission 只支持在 application 空间上操作数据

{ "name": "service.exchange" }

导入模块

import exchange from '@service.exchange' 或 const exchange = require('@service.exchange')

接口定义

exchange.get (OBJECT)

读取快应用平台数据，可获取到应用空间（application）、应用开发商空间（vendor，1080+）或全局空间（global）的数据

参数

返回值:

fail 返回错误代码：

示例

exchange.get({
  package: 'com.example',
  sign: '7a12ec1d66233f20a20141035b1f7937',
  key: 'token',
  success: function(ret) {
    console.log(`handling success, value = ${ret.value}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

exchange.set (OBJECT)

发布数据到快应用平台，可发布到应用空间（application）、应用开发商空间（vendor，1080+）或全局空间（global）

注意：从 1080 开始，修改方可以通过set来修改非本快应用的数据

在修改非本快应用的应用空间数据前，必须确保数据发布方已为数据修改方授予修改权限，使用exchange.grantPermission接口授权即可

参数

fail 返回错误代码：

示例

exchange.set({
  key: 'token',
  value: '12347979',
  success: function() {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

exchange.remove (OBJECT)

从快应用平台删除发布到应用空间（application）的数据

注意：从 1080 开始，修改方可以通过remove来删除非本快应用的数据

在删除非本快应用的应用空间数据前，必须确保数据发布方已为数据修改方授予删除权限，使用exchange.grantPermission接口授权即可

参数

fail 返回错误代码：

示例

exchange.remove({
  key: 'token',
  success: function() {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

exchange.clear (OBJECT)

从快应用平台清除当前快应用的应用空间的数据

参数

示例

exchange.clear({
  success: function() {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

exchange.grantPermission (OBJECT)

授予指定快应用读取 get、修改 set(1080+)、删除 remove(1080+)数据的权限。

同签名的快应用不用授权，默认有读取 get、修改 set(1080+)、删除 remove(1080+)权限

参数

应用的签名的 SHA-256 可通过 快应用调试器 进行获取。

fail 返回错误代码：

示例

exchange.grantPermission({
  sign: '7a12ec1d66233f20a20141035b1f7937',
  package: 'com.example',
  success: function() {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

exchange.revokePermission (OBJECT)

取消授予指定快应用应用读取 get、修改 set(1080+)、删除 remove(1080+)数据的权限

不能取消同签名应用的读取 get、修改 set(1080+)、删除 remove(1080+)授权

参数

fail 返回错误代码：

示例

exchange.revokePermission({
  package: 'com.example',
  success: function() {
    console.log(`handling success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后台运行限制

无限制。
后台运行详细用法参见后台运行 脚本。