我们知道,目前对于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 都可以做到。
然后我们可以查看 REST 操作的实现,您可以使用任何微流作为 REST 操作的实现。西门子Mendix 将自动检测您需要的参数以及需要导入或导出映射的任何对象。
这可以在“ 操作” 对话框中指定。您还可以使用、发送和接收二进制数据或文件文档,例如,如果您想提供检索 PDF 文档的操作。
以下图像使用可选 httpResponse 参数,您可以使用该参数覆盖 HTTP 状态代码或状态消息。如果需要,您还可以指定要访问的 HTTP 请求,例如,确定 HTTP 标头值的值。