超媒体工作流:多种实现方式解析
立即解锁
发布时间: 2025-08-26 01:55:04 阅读量: 3 订阅数: 12 

### 超媒体工作流:多种实现方式解析
在构建和管理服务工作流时,我们常常会面临多种选择。不同的场景和需求需要不同的解决方案,下面将详细介绍几种常见的工作流描述和实现方式。
#### 共享状态文档的使用
在很多情况下,我们需要使用共享状态文档来填充另一个服务的数据输入表单。最简单的方法是编写一个映射函数,将表单和共享状态数据作为输入,并自动将共享状态属性应用到表单中。示例代码如下:
```javascript
var sharedState = httpRead("http://api.example.org/state/q1w2e3r4t5");
var inputForm = httpRead("http://api.example.org/users/onboardingform");
var completedForm = propertyMap(sharedState, inputForm);
var results = httpExecute(completedForm);
```
共享状态文档的优势在于,随着时间的推移,我们可以向文档中添加新的状态数据,而无需更新依赖该资源的现有服务。每个服务都可以根据自身需求使用状态资源的内容,这降低了服务与状态之间的耦合度,实现了更基于配置的实现方式。
#### 以代码描述工作流
当我们需要使用多个服务接口来构建一个解决方案时,需要一种方法来描述服务列表以及它们之间的交互方式。一种简单的方法是使用源代码来描述工作流。
##### 问题与解决方案
问题是如何使用服务组件源代码以最简单的方式组合多个现有独立服务接口的解决方案,以及何时使用源代码而不是其他更抽象和灵活的方法。当工作流解决方案比较简单,且不会随时间变化,也不需要定制时,使用单个服务接口内的源代码来描述工作流解决方案是有意义的。我们可以创建一个具有所需解决方案所有功能的接口,然后在接口背后使用源代码来调用和执行其他远程服务以完成工作。这样可以为消费应用提供一个稳定、直接的 API,并在该稳定接口背后实现最大的设计和构建灵活性。
##### 示例
以一个需要支持新员工入职工作流的组织为例。假设组织的多个部门都有支持其团队职责的在线服务,我们可以使用源代码来组合这些服务接口。示例代码如下:
```javascript
// provide input screens to gather important data
var stateData = collectInputs(personalData, backgroundCheck,
healthInsurance, salaryDetails);
// execute work in parallel
Promise.all([apiPersonalData(stateData), apiBackgroundCheck(stateData),
apiHealthInsurance(stateData), apiSalaryDetails(stateData)])
.then((results) => {
emitSuccessResponse(results);
}).catch(error => {
emitFailedResponse(results);
});
```
在这个示例中,首先收集所需的输入,然后并行调用外部服务接口来处理工作流中的每个任务。成功结果将通过 `emitSuccessResponse(results)` 方法返回,若出现处理或网络问题,则通过 `emitFailedResponse(results)` 方法返回。
内部代码可以通过 HTTP 暴露,以下是 HTTP 交换的示例:
```plaintext
*** REQUEST ***
GET /onboarding/jobs/
Accept: text/html
Link: <http://webapicookbook.com/profiles/jobs>;rel=profile
...
*** RESPONSE ***
200 OK
Content-Type: text/html
Link: <http://webapicookbook.com/profiles/jobs>;rel=profile
...
<html>
...
<h1>Onboard New Employee</h1>
<form name="submit-job" action="/onboarding/q1w2e3r4" method="put">
...
</form>
</html>
*** REQUEST ***
PUT /onboarding/jobs/q1w2e3r4
Content-Type: application/x-www-form-urlencoded
Accept: text/html
Link: <http://webapicookbook.com/profiles/jobs>;rel=profile
jobID=q1w2e3r4&...
*** RESPONSE ***
202 Accepted
Content-Type: text/html
Link: <http://webapicookbook.com/profiles/jobs>;rel=profile
<html>
...
<h1>Job q1w2e3r4</h1>
<div name="progress">
<span id="jobStatus">pending</span>
...i
<a href="..." rel="refresh">Check Job Status</a>
</div>
</html>
```
在这个 HTTP 交换中,API 消费者请求提供入职工作描述的 FORM 输入的资源。填写 FORM 后,将其提交到表单中提供的 URL 以执行工作。工作流引擎在工作进行时返回 202 Accepted。API 消费者可以使用刷新 URL 监控工作状态,最终响应将是 200 OK 或 4xx/5xx 状态码,表示工作运行完成。
##### 讨论
上述示例使用了 JavaScript 的 `Promise.
0
0
复制全文
相关推荐









