使用 HTTP 接收请求活动可将 Integration Appliance 配置为充当 HTTP 侦听器
您不能将两个具有相同端点详细信息、URL 和方法的“HTTP 接收请求”活动部署到同一个设备上。
对于单个“HTTP 接收请求”活动
如果针对一个 URL 仅部署了一个“HTTP 接收请求”活动,那么编排将接受以该基本 URL 开头的那些 URL 的全部请求。例如,如果部署了 /customer,那么它将接受 /customer、/customer/21、/customer/21/dept 等的请求。
如果针对包含路径参数的 URL 部署了一个“HTTP 接收请求”活动,那么编排将仅接受其 URL 与使用路径参数值配置的 URL 匹配的请求。例如,如果部署了 /customer/{custid},那么它将接受 /customer/10、/customer/21、/customer/dept 等的请求。 不接受以下 URL:/customer、/customer/21/dept 等。
对于多个“HTTP 接收请求”活动
如果部署了使用相同基本 URL 配置的两个“HTTP 接收请求”活动,并且其中一个包含路径参数,那么这些活动将接受其 URL 与已配置 URL 严格匹配的请求。 例如,如果部署了 /customer 和 /customer/{path parameter},并且调用了 /customer,那么请求将转至使用 /customer 配置的活动。如果调用了 /customer/007,那么请求将转至使用 /customer/{path parameter} 配置的活动。 此外,如果调用了 URL /customer/dept/1 或 /customer/12/21,那么任何活动都不接受请求。
字段 | 描述 |
---|---|
URL(主机名后的路径) | 指定 Integration Appliance 用于侦听入站 HTTP 请求的资源路径,例如:/mypath。
您在此字段中指定的字符串必须排除字符串 http://、Integration Appliance 的主机名以及端口号。
Integration Appliance 用于侦听入站 HTTP 请求的完整 URL 将由 Integration Appliance 的主机名、HTTP 端点所指定的端口号以及此字段所指定的路径自动构造而成。例如,如果 Integration Appliance 用于侦听 HTTP 请求的完整 URL 为 http://myAR:myPort/myPath,那么您只需在此字段中指定字符串:/myPath。对于在同一时间使用同一端口在同一 Integration Appliance 上部署的 HTTP 接收请求活动,所指定的路径必须唯一。 要使用路径参数和查询参数,请按下列格式输入 URL:url/{path}?name1=value1&name2=value2。 这使您能够将字符串值映射到“{path}”参数并指定查询参数名:该示例中的 name1 和 name2。如果您选择声明多个“{path}”参数,那么建议每个参数都应具有唯一名称。具有相同名称的参数在映射中只会表示为一个节点。 路径参数显示在“映射输出”中的 /httpheaders/pathParameters 下。查询参数显示在“映射输出”中的 /httpheaders/queryParameters 下。 注: 在 URL 中,分配给查询参数的任何值都不会传递到映射器。该值来自于基于实际传入请求的服务器。
注: Integration Appliance 用于侦听入站 HTTP 请求的路径是一个由您指定的资源路径字符串,并且不对应于 Integration Appliance 上的实际目录路径。
|
方法 | 指定侦听服务器所接受的 HTTP 方法。 |
类型 | 指定 HTTP 请求的期望消息类型 - 文本或二进制。 |
需要答复 | 指定是否应向请求的发送方发送答复。 注: 如果选中此复选框,那么必须在编排中添加并配置 HTTP 发送响应活动。
|
使用压缩/解压缩 | 指定是否在活动级别打开或关闭压缩/解压。缺省情况下,将清除使用压缩/解压复选框并为此活动禁用压缩/解压。 选中使用压缩/解压复选框可为此活动启用压缩/解压。有关更多信息,请参阅通过“HTTP 调用/获取/发布/头/放置/删除请求”活动进行压缩/解压 |
输出参数 | 描述 |
---|---|
httpheaders | 指定 HTTP 请求的头。 |
body | 指定 HTTP 请求消息的主体。 |
httpheaders 输出参数的节点 | 描述 |
---|---|
httpheaders/uri | 指定传入请求的资源路径,例如:/myPath。 |
httpheaders/method | 指定 HTTP 请求的类型。 |
httpheaders/host | 指定客户机的 IP 地址或主机名。 |
httpheaders/otherHeaders/headerItem | 指定包含了一组 HTTP 头参数作为名称/值对的元素。可以在 HTTP 请求中指定多个 HTTP 头参数,因此,它是一个重现节点。 |
httpheaders/<configured_header_name> | 如果在“请求头”步骤中配置了至少一个请求头,那么此处会显示所有请求头。<configured_header_name> 将替换为您选择或输入的实际头名称。 |
httpheaders/pathParameters | 如果在“配置”步骤中配置了 URL 中的路径参数,那么此处会显示所有路径参数。如果未指定路径参数,该节点将不显示。 |
httpheaders/queryParameters | 如果在“配置”步骤中配置了 URL 中的查询参数,那么此处会显示所有查询参数。如果未指定查询参数,该节点将不显示。 |
httpheaders/otherHeaders/headerItem/name | 指定 HTTP 头参数名称。 |
httpheaders/otherHeaders/headerItem/value | 指定 HTTP 头参数值。 |