调用云函数

该模块允许用户创建、编写运行于知晓云云引擎上的代码。适用于一些对安全性有要求,功能复杂、需求个性化的业务场景。配合触发器可以帮助开发者实现功能复杂的小程序。

BaaS.invokeCloudFunc(funcName, data, sync, callback)

调用云函数,需要先在控制台创建云函数 控制台 - 云函数新建云函数

参数说明

参数类型必填说明
functionNameString云函数名
dataString传递给云函数的参数(这里输入 json 字符串,sdk 会把 json 字符串序列化为 json 类型)
syncBool是否等待返回函数执行结果,默认为 true。同步与异步云函数有不同的超时时间,同步云函数为 5 秒,而异步云函数为 5 分钟(300 秒)

返回参数说明

参数类型描述
codeIntegercode 为 0 表示正常返回,1 表示异常返回
data由云函数返回的数据类型决定(sdk 序列化为 JsonElement)函数通过 callback 返回的数据
errorJosnElement返回的错误信息,正常返回则返回空对象

请求示例

假设已经创建了一个云函数 helloWorld,其接受一个 name 作为参数,返回 hello ${name}。云函数代码如下:

  1. exports.main = function helloWorld(event, callback) {
  2. console.log(event)
  3. callback(null, `hello ${event.data.name}`)
  4. }

可在小程序中通过以下方式进行调用云函数:

  1. String funcName = "helloWorld";
  2. String data = "{\"name\":\"allen\"}";
  3. BaaS.invokeCloudFunc(funcName, data, null, new BaseCallback<CloudFuncResp>() {
  4. @Override
  5. public void onSuccess(CloudFuncResp cloudFuncResp) {
  6. if (cloudFuncResp.getCode() == 0) {
  7. // 调用成功
  8. }
  9. }
  10. @Override
  11. public void onFailure(Throwable e) {
  12. // 调用失败
  13. }
  14. });

返回参数

  1. {
  2. "error": {},
  3. "code": 0,
  4. "data": "hello allen"
  5. }

异常请参考异常