交换数据 1050+

接口声明

提供了一个不同快应用间数据交互的方式。快应用可以利用它发布数据，或从其他快应用获取数据。 数据交互有两个数据空间，分别是应用空间（application）和全局空间（global）。 application：数据发布在应用空间，读取时需同时指定发布方的包名和签名，并且需要发布方授权。 global：数据发布在全局空间，多个应用的写操作会相互覆盖，读取时不能指定发布方的包名和签名，不需要发布方授权。 备注：global 数据仅支持 set、get 操作，remove、clear、grantPermission、revokePermission 等操作均不支持

{ "name": "service.exchange" }

导入模块

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

接口定义

exchange.get (OBJECT)

读取数据

参数

返回值:

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)

发布数据到快应用平台

参数

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)

从快应用平台删除数据

参数

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)

授权应用获取数据。同签名的应用不用授权，默认有读取权限

参数

应用的签名的 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)

取消授权应用获取数据。不能取消同签名应用的读取授权

参数

fail 返回错误代码：

示例

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

后台运行限制

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