目录

调用函数

查询触发器标识

当您在创建的函数或函数别名中创建了一个HTTP类型的触发器后,在应用客户端调用函数时需要传入HTTP触发器的标识,查询方法如下:

在函数的触发器页面点击“HTTP触发器”,查看“触发URL”的后缀,获取触发器的标识,格式为“函数名-版本号”。如下图所示,“myhandlerxxxx-$latest”即为HTTP触发器标识。

调用函数

应用集成了云函数SDK后,可以在应用内直接通过SDK API调用HarmonyOS 开发者中心的云函数,云函数SDK与HarmonyOS 开发者中心的函数调用基于HTTPS的安全访问。

  1. 在调用函数前,需要调用AGConnectFunction.getInstance初始化AGConnectFunction实例。
    private AGConnectFunction function;
    function = AGConnectFunction.getInstance();
  1. 调用AGConnectFunction.wrap设置函数,在方法中传入触发器标识。
  2. 根据函数入参情况,调用相关方法来调用函数。
    • 如果函数没有入参,可以调用FunctionCallable.call()来调用函数。
      function.wrap("myhandlerxxxx-$latest").call();
    • 如果函数有入参,可以调用FunctionCallable.call(T object)来调用函数,多个入参添加到object对象中。

      其中HTTP触发器传递给函数的数据格式,请参见event对象说明。

      function.wrap("myhandlerxxxx-$latest").call(map);
  3. 如果您需要关注函数的返回值,可以在接口返回的Task中设置一个addOnCompleteListener回调监听,在回调方法中获取包含函数执行结果的FunctionResult对象,调用FunctionResult.getValue可以获取函数执行后的返回值或返回对象。
    private void getWeek(String date) {
         HashMap<String, String> map = new HashMap();
         map.put("time", date);
         function.wrap("myhandlerxxxx-$latest").call(map)
                 .addOnCompleteListener(new OnHarmonyCompleteListener<FunctionResult>() {
                     @Override
                     public void onComplete(HarmonyTask<FunctionResult> task) {
                         if (task.isSuccessful()) {
                             String value = task.getResult().getValue();
                             
                         } else {
                             Exception e = task.getException();
                             if (e instanceof AGCFunctionException) {
                                 AGCFunctionException functionException = (AGCFunctionException) e;
                                 int errCode = functionException.getCode();
                                 String message = functionException.getMessage();
                             }
                             // ...
                         }
                     }
                 });
     }