第 2 部分展示了如何构建一个整合流程(orchestration),该整合流程可调用 ">Salesforce.com 公开的基于 JSON 的 REST API 来创建一个账户。第 3 部分展示如何设计一个作为基于 JSON 的 API 公开的整合流程。
WebSphere Cast Iron(后面简称为 Cast Iron)被广泛用于遍及内部和外部应用程序的集成和迁移。过去,JSON 被普遍用作 REST API 的传输类型,因为与 XML 相比,它的格式是轻量级的。
在 Cast Iron 中,您可以创建和公开一个基于 JSON 的 API,这是一个以 JSON 格式接受请求并发送响应的整合流程。Cast Iron 使用了 XML 和XML 模式。Cast Iron 引入了两个用来处理 JSON 数据的新活动:Read JSON 和 Write JSON。这些活动在整合流程的创建过程中非常有用,该整合流程代表 Cast Iron 中基于 JSON 的 API。本文将介绍如何创建一个作为 API 公开的整合流程,此 API 可接收和发出 JSON 数据。
构建一个基于 JSON 的 API 在 Cast Iron 中添加两个数字
在此场景中,您将学习如何公开一个 REST API,它通过使用 Read JSON 和 Write JSON 活动接收带有两个数字的请求,并在 JSON 消息中发送输入数字的总和作为响应。样例请求和响应 JSON 消息如表 1 所示。
表 1. 添加两个 API 样例请求和响应 JSON 消息数字。
请求 JSON 响应 JSON {
"number1":100"number2":120
} {
"result":220
}
您必须构建整合流程来完成上述场景。该整合流程充当了一个基于 JSON 的 REST API,以便将两个数字添加到外部世界,如图 1 所示。
图 1. 添加两个数字 - API 整合流程设计
图 1. 添加两个数字 - API 整合流程设计
Receive Input Numbers(Receive 请求)接收包含两个需要添加的数字的 JSON 请求。表 2 展示了完成 Receive Input Numbers 活动的检查清单的步骤。
表 2. Receive Input Numbers 活动
检查清单项 描述 Pick Endpoint 选择 HTTP 端点。 Configure 将输入 add 添加到 URL (路径在
主机名后)并选择 POST 作为 HTTP 方法。 Map Output 根据活动的输出参数创建一个新变量(主体)。该变量用于配置整合流程的其他活动。 Convert to XML 活动 (Read JSON) 将 JSON 格式
数据转换成 XML: 通过完成下列步骤来配置 Read JSON。您必须使用 JSON 消息来配置 JSON 活动。从 Configure 窗口中选择 Use JSON or XML Message 选项作为消息类型,如图 2 所示。
图 2. 配置 Convert to XML 活动
将请求 JSON 消息复制到文本区,如表 1 所示,然后单击 Generate Output Map。这会生成 Read JSON 输出参数,可在 Map Outputs 窗口查看这些参数,如图 3 所示。在图 3 中,对于给定的请求 JSON 消息,已经生成了各自的 XML 模式并根据 Map Output 进行填充,这使得数据(将要添加的)的映射和处理变得非常容易。
图 3. Convert to XML Activity Map Input
从
Checklist 面板中选择 Map Inputs。单击 Select Inputs 按钮,然后选择 body 作为输入变量,如图 4 所示。单击 Ok。
图 4. Convert to XML Map Input - 选择输入
在选择输入变量之后,将输入变量映射到 jsonText,如图 5 所示。
图 5. Convert to XML Map Inputs - 映射