设备接入 IOTDA-自定义策略:了解函数接口定义

时间:2024-10-23 17:42:43

了解函数接口定义

函数服务对函数有明确的接口定义。

以java语言为例,接口定义为:作用域 返回参数 函数名(函数参数,Context参数)

  • 作用域:提供给FunctionGraph调用的用户函数必须定义为public。
  • 返回参数:用户定义,FunctionGraph负责转换为字符串,作为HTTP Response返回。对于返回参数对象类型,HTTP Response该类型的JSON字符串。
  • 函数名:用户定义函数名称。
  • 用户定义参数:当前函数只支持一个用户参数。对于复杂参数,建议定义为对象类型,以JSON字符串提供数据。FunctionGraph调用函数时,解析JSON为对象。
  • Context参数:runtime提供函数执行上下文,其接口定义在SDK接口说明。

创建Java函数时,函数入口参数需要提供函数完整的名字空间,参数格式为:包名.类名.函数名。

设备发放在此基础上,要求函数代码满足如下条件:

  • 返回参数:需满足设备发放对返回参数的约束
  • 函数参数:需满足设备发放对函数参数的约束
  • 函数接口实现:从函数参数中的备选接入点中选择一个接入点,调用发放设备接口,根据接口响应拼接参数返回。
support.huaweicloud.com/usermanual-iothub/iot_09_0176.html