Azure Functions 触发器和绑定概念

• 03/04/2019
• 作者
  • 
  • 

本文概要介绍有关函数触发器和绑定的概念。

触发器是导致函数运行的因素。 触发器定义函数的调用方式，一个函数必须刚好有一个触发器。 触发器具有关联的数据，这些数据通常作为函数的有效负载提供。

绑定到函数是以声明方式将另一个资源连接到该函数的一种方式；绑定可以输入绑定和/或输出绑定的形式进行连接。 绑定中的数据作为参数提供给函数。

可根据需要，混合搭配不同的绑定。 绑定是可选的，一个函数可以有一个或多个输入绑定和/或输出绑定。

使用触发器和绑定可以避免对其他服务进行硬编码访问。 函数接收函数参数中的数据（例如，队列消息内容）。 使用函数的返回值发送数据（例如，用于创建队列消息）。

以下示例演示如何实现不同的函数。

^* 表示不同的队列

这些示例并不详尽，旨在演示如何同时使用触发器和绑定。

触发器和绑定的定义

触发器和绑定的定义根据开发方法的不同而异。

门户为此配置提供了一个 UI，但你可以通过函数的“集成”选项卡打开“高级编辑器”，来直接编辑文件。

在 .NET 中，参数类型定义了输入数据的数据类型。 例如，使用 string 绑定到队列触发器的文本、一个要读取为二进制内容的字节数组，以及一个要反序列化为对象的自定义类型。

对于动态键入的语言（如 JavaScript），请在 function.json 文件中使用 dataType 属性。 例如，若要以二进制格式读取 HTTP 请求的内容，将 dataType 设置为 binary：

{
    "dataType": "binary",
    "type": "httpTrigger",
    "name": "req",
    "direction": "in"
}

dataType 的其他选项是 stream 和 string。

绑定方向

所有触发器和绑定在 function.json 文件中都有一个 direction 属性：

• 对于触发器，方向始终为 in
• 输入和输出绑定使用 in 和 out
• 某些绑定支持特殊方向 inout。 如果使用 inout，则只能通过门户中的“集成”选项卡使用“高级编辑器”。

使用类库中的特性来配置触发器和绑定时，方向在特性构造函数中提供或推断自参数类型。

支持的绑定

下表显示了 Azure Functions 运行时的两个主要版本支持的绑定。

¹ 在 2.x 中，除了 HTTP 和 Timer 以外，所有绑定都必须注册。 请参阅注册绑定扩展。

有关哪些绑定处于预览状态或已批准在生产环境中使用的信息，请参阅支持的语言。

资源

• 绑定表达式和模式
• 使用 Azure 函数返回值
• 如何注册绑定表达式
• 测试：
  • 在 Azure Functions 中测试代码的策略
  • 手动运行非 HTTP 触发的函数
• 处理绑定错误

后续步骤