REST 客户端实施是否接受 HATEOAS 约束？

Question

有谁知道 REST 客户端的实现包含 超媒体作为应用程序状态的引擎 (HATEOAS)？

从其记录方式来看，Sun Cloud API 似乎是一个不错的候选者，并且 < a href="http://blogs.oracle.com/craigmcc/entry/why_hateoas" rel="noreferrer">作者的声明，大意是 Ruby、Java 和 Python 实现正在开发中。 但到目前为止我还没有发现代码的踪迹。

我正在寻找任何东西 - 即使是部分实现也会有帮助。

Answer 1

Restfulie 是一个 Ruby、Java 和 C# 框架，旨在支持构建采用 HATEOAS 的客户端和服务器。 我没用过，但看起来确实很有趣。

这是来自他们的java项目的一些示例代码：

Order order = new Order();

// place the order
order = service("http://www.caelum.com.br/order").post(order);

// cancels it
resource(order).getTransition("cancel").execute();

同样，我不确定这到底是做什么的，或者说它在实践中效果如何，但它看起来确实很有趣。

Answer 2

REST HTTP 和 HATEOAS 的问题在于，没有通用的方法来指定链接，因此很难跟踪链接，因为它们的结构可能会从一个服务提供商更改为另一个服务提供商。 有些会使用 其他人会使用链接的专有结构。 。 它不像 HTML 或 Atom 那样，链接是定义的标准的一部分。

客户端无法知道您的表示中的链接是什么，因为它不知道您的媒体类型，除非存在链接的标准或常规表示

Answer 3

HATEOAS 设计原则（REST 也是一组设计原则）意味着每个资源最多应该有一个固定的 URL。

其他所有相关内容都应该可以通过“超媒体”链接从该 URL 动态发现。

我刚刚在此处创建了一个维基百科存根

Answer 4

与此同时，还有 Spring HATEOAS 项目。 它还有一个客户端实现：
https://docs.spring.io/spring-hateoas /docs/current/reference/html/#client

Map<String, Object> parameters = new HashMap<>();
parameters.put("user", 27);

Traverson traverson = new Traverson(URI.create("http://localhost:8080/api/"), MediaTypes.HAL_JSON);
String name = traverson
    .follow("movies", "movie", "actor").withTemplateParameters(parameters)
    .toObject("$.name");

Answer 5

您应该首先查看的是常见的网络浏览器。 这是接受 HATEOAS（至少在某种程度上）的客户的标准。

这就是超媒体的工作原理。 它非常简单，几乎令人痛苦：

1. 您将浏览器指向 http://pigs-are-cool.org/，
2. 浏览器会加载 HTML 页面、图像、CSS 等。
   • 此时，应用程序（您的浏览体验）位于特定的 URI。
   • 浏览器正在显示该 URI 的内容
3. 您在应用程序中看到一个链接
4. 您单击该链接
5. 浏览器跟随该链接
   • 此时，应用程序位于不同的 URI
   • 浏览器正在显示新 URI 的内容

现在简要说明这两个术语与 Web 浏览体验的关系：

• 超媒体 = 带有嵌入链接的 HTML 页面
• 应用程序状态 = 您在任何时间点在浏览器中看到的内容。

因此，HATEOAS 实际上描述了当您从一个网页转到另一个网页时，网络浏览器中会发生什么：

带有嵌入链接的 HTML 页面驱动您在任何时间点在浏览器中看到的内容

HATEOAS 一词只是这种浏览体验的抽象。

RESTful 客户端应用程序的其他示例包括：

• RSS 和 Feed 阅读器。 用户提供的链接
• 他们遍历大多数 AtomPub 博客客户端 。 他们只需要服务文档的 URI，然后从那里找到上传图像和博客文章、搜索等的位置。
• 可能是 Google Gadgets（以及类似的），但它们只是不同皮肤的浏览器。
• 网络爬虫也是 RESTful 客户端，但它们是一个利基市场。

RESTful 客户端软件的一些特征：

• 客户端可以与任何服务器一起工作，前提是它使用某些 URI 进行初始化并且服务器以预期结果进行响应（例如，对于 Atom 博客客户端，Atom 服务文档）。
• 除了在运行时可以找到的内容之外，客户端对服务器如何设计其 URI 一无所知
• 客户端知道足够的媒体类型和链接关系以了解服务器所说的内容（例如 Atom 或 RSS）
• 客户端使用嵌入式链接来查找其他内容资源; 有些是自动的（如 ），有些是手动的（如 ）。

它们通常是由用户驱动的，可以正确地称为“用户代理”，但 GoogleBot 除外。