“HTTP 接收请求”活动

使用 HTTP 接收请求活动可以对 Integration Appliance 进行配置以使其充当 HTTP 侦听器

下图显示了充当 HTTP 侦听器的 Integration Appliance。
图 1.
HTTP 接收请求活动是一个启动方活动。 在将以 HTTP 接收请求活动开始的编排部署到 Integration Appliance 中之后,Integration Appliance 将充当等待 HTTP 请求的 HTTP 侦听器。当收到 HTTP 请求时,将执行以下操作:
  1. 启动编排作业。
  2. HTTP 接收请求活动处理传入 HTTP 请求并将该 HTTP 请求映射至该活动的输出参数。
  3. 将输出参数映射至指定编排变量。输出参数和编排变量之间的映射将在设计时期间在核对表映射输出任务中进行定义。
  4. 处理编排中的剩余活动。(在以图形形式显示的编排中,剩余活动是指位于 HTTP 接收请求活动右侧的活动)。
缺省情况下,会为 HTTP 接收请求活动启用解压。 有关更多信息,请参阅通过“HTTP 接收请求”活动进行解压

向编排添加“HTTP 接收请求”活动

  1. 创建或打开编排。这样会以图形形式显示编排。
  2. 选择活动选项卡,并展开 HTTP 文件夹。
  3. 接收请求活动拖到编排中。
  4. 选择该活动。这样会显示核对表,而且摘要任务在“属性”窗格中将处于活动状态。在工作空间中,“属性”窗格位于以图形形式显示的编排的下方。

创建、选择或编辑 HTTP 端点

  1. 单击核对表中的选取端点任务,然后选择下列操作之一:
    • 选择现有端点:
      1. 选择浏览。这样会显示 Project Explorer。
      2. 选择现有端点并单击确定。跳至“配置活动”过程。
    • 选择现有端点并编辑该端点:
      1. 选择浏览。这样会显示 Project Explorer。
      2. 选择现有端点并单击确定
      3. 单击编辑。这样会显示“编辑端点”窗格。
    • 创建新端点:选择新建。这样会显示“创建端点”窗格。
  2. 创建或编辑 HTTP 端点(请参阅创建或编辑 HTTP 端点)。

配置活动

  1. 核对表中选择配置任务。这样会显示“配置”窗格。
  2. 配置此窗格中的所有字段和复选框,如下表所述:
    表 1.
    字段 描述
    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 接收请求活动,所指定的路径必须是唯一的。
    注: Integration Appliance 用于侦听入站 HTTP 请求的路径是一个由您指定的资源路径字符串,并且不对应于 Integration Appliance 上的实际目录路径。
    类型 指定 HTTP 请求的期望消息类型 - 文本二进制
    需要答复 指定是否应向请求的发送方发送答复。
    注: 如果选中此复选框,那么您必须在编排中添加并配置 HTTP 发送响应活动。
    使用压缩/解压缩 指定是否在活动级别打开或关闭压缩/解压。缺省情况下,将选中使用压缩/解压复选框。 清除使用压缩/解压复选框可为此活动禁用解压。有关更多信息,请参阅通过“HTTP 发送响应”活动进行压缩

映射活动的输出

  1. 核对表中选择映射输出任务。活动的输出参数会显示在映射输出任务的“源活动”窗格中,如下表所述:
    表 2.
    输出参数 描述
    httpheaders 指定 HTTP 请求的头。
    body 指定 HTTP 请求消息的主体。
    下表定义了可选 httpheaders 输出参数的节点。 
    表 3.
    httpheaders 输出参数的节点 描述
    httpheaders/uri 指定传入请求的资源路径,例如:/myPath
    httpheaders/method 指定 HTTP 请求的类型。对于此活动,POST 的类型为 HTTP 请求。
    httpheaders/otherHeaders/headerItem 指定包含了一组 HTTP 头参数作为名称/值对的元素。可以在 HTTP 请求中指定多个 HTTP 头参数,因此,它是一个重现节点。
    httpheaders/otherHeaders/headerItem/name 指定 HTTP 头参数名称。
    ttpheaders/otherHeaders/headerItem/value 指定 HTTP 头参数值。
  2. 在活动的输出参数和编排变量之间创建映射。请参阅创建映射,以获取有关映射的常规指示信息。
    注: 要测试以 HTTP 接收请求活动开始的编排,您可以使用 Studio 安装随附的 HTTP 发布实用程序以在运行时期间向侦听 Integration Appliance 发送 HTTP 请求。您可以从“开始”菜单中访问 HTTP 发布实用程序:选择程序 > IBM > WebSphere Cast Iron Studio > HTTP 发布实用程序选项。您在“入站连接器的 URL”字段中指定的 URL 必须包含完整 URL,例如:http://myAR:myPort/myPath