Swagger和HATEOAS之间的区别

Question

谁能解释Swagger和HATEOAS之间的区别。我可以搜索很多次，但是没有朋友可以解释这两个方面的正确详细答案。

Answer 1

Swagger和HATEOAS IMO之间的主要区别（未包含在接受的答案中）是Swagger仅用于RPC'sque API。但是，此类API实际上与REST无关。

还有一个更广泛的误解，即通过HTTP交换的任何东西都是自动RESTful的（〜符合REST建筑风格），事实并非如此。REST只是定义了一组约束，这些约束不是选择或选项，而是强制性的。从开始到结束。没有RESTful并没有什么错，但是称这样的架构REST是错误的。

Swagger描述了可以在端点上执行的操作以及需要发送到服务的有效负载（包括标头和预期的表示格式），还描述了客户端可能期望作为响应。这使得Swagger既可以用作API的文档，也可以用作测试框架。由于Swagger与API紧密耦合，因此其行为非常类似于典型的RPC服务描述，即类似于SOAP中的WSDL文件或RMI或CORBA中的存根或骨架类。如果端点发生更改或有效负载中的某些内容发生更改，则根据Swagger文档实施的客户端可能会随着时间的推移而中断，只是重新引入了典型RPC实现所具有的相同问题。

另一方面，REST和HATEOAS则是为进行灾难转移和进一步开发而设计的。REST不是协议，而是一种架构风格，它描述了分布式系统中客户端和服务器之间的交互流。它基本上采用了使Web如此成功的概念并将其转换到应用程序层。因此，适用于可浏览Web的相同概念也适用于REST。因此，HATEOAS（链接的使用和支持，链接关系和链接名称）的行为类似于Web也不是奇迹。

在设计REST体系结构时，考虑一种状态机是有益的，服务器在该状态机中提供了客户端需要采取进一步行动的所有信息。AsbjørnUlsberg在2016年进行了一次精彩的演讲，他在演讲中解释了可负担性以及如何通过HATEOAS实现状态机。除了常见或标准化的媒体类型和关系名称外，无需带外知识即可与服务进一步交互。在烤面包机例子阿斯比约恩给他谈话的情况下，一个烤面包机可以有状态off，on，heating并idle在那里把一个烤面包机上会导致状态转变，从off以on后面一个转变heating，直到一定的温度达到其状态过渡到idle并在idle和之间切换，heating直到烤面包机关闭。

HATOAS将为客户提供有关当前状态的信息，并包括客户可以调用以链接到下一个状态（即再次关闭烤面包机）的链接。在这里需要强调的是，服务器为客户端提供了客户端可能执行的每个操作。客户端实现者无需查阅任何专有的API文档即可使客户端能够与REST服务进行交互。此外，由于客户端将通过链接关系名称确定调用该URI是否有意义，因此URI不必具有有意义的含义或设计为传达语义表达结构。此类关系名称由IANA通过通用方法（例如Dublin Core或schema.org）指定。或通过绝对URI充当扩展属性，这些扩展属性可能指向人类可读的描述，并且可能还会通过鼠标悬停的工具提示等将其传播给用户。

我希望您能自己看到，仅需要Swagger即可描述RPC Web-API，而无需遵循REST体系结构设计的应用程序。通过REST API交换的消息应包括客户端在下一次状态转换时做出明智选择所需的所有信息。这样，将这样的消息流和交互设计为状态机是有益的。