西门子Mendix 如何发布 REST API?

460 阅读2分钟

我们知道,目前对于API的服务,我们主要通过 REST 而不是 Web Service,但使用 REST 需要在服务设计上稍作改动。Web Service 是关于调用和提供对远程逻辑的访问,但在 REST 中,您设计了一个可供外部应用程序使用的数据模型。域模型中的对象称为资源,对资源的操作标准化为以下选项:

  • GET – 阅读或查找一个或多个现有资源
  • POST – 创建一个新资源
  • PUT – 更改现有资源
  • DELETE – 删除现有资源

您还将在 Swagger 和 OpenAPI 等 REST 服务中看到这种方法:首先列出资源,然后列出对这些资源的操作。

西门子Mendix REST 发布功能遵循 OpenAPI 使用的方法,您首先定义资源,然后定义对这些资源的操作。您可以完全控制 REST API,因为您定义了资源、交换的消息和实现操作的微流。

或者,您可以让 西门子 Mendix 自动处理所有这些。只需从领域模型中公开您的实体或将实体拖到发布-REST 文档的资源部分,就会为您生成所需的一切,包括安全性。您在实体上定义的所有安全规则都会被您的 REST API 自动使用。

无论您是想要完全控制您实现的 API,还是只想在几分钟内为您的移动应用程序生成一个后端,西门子Mendix 都可以做到。

image.png

然后我们可以查看 REST 操作的实现,您可以使用任何微流作为 REST 操作的实现。西门子Mendix 将自动检测您需要的参数以及需要导入或导出映射的任何对象。

这可以在“ 操作” 对话框中指定。您还可以使用、发送和接收二进制数据或文件文档,例如,如果您想提供检索 PDF 文档的操作。

以下图像使用可选 httpResponse 参数,您可以使用该参数覆盖 HTTP 状态代码或状态消息。如果需要,您还可以指定要访问的 HTTP 请求,例如,确定 HTTP 标头值的值。

image.png