Spring MVC、REST 和 HATEOAS

Question

我正在努力寻找使用 HATEOAS 实现 Spring MVC 3.x RESTful 服务的正确方法。考虑以下限制：

• 我不希望我的域实体被 web/rest 结构污染。
• 我不希望我的控制器被视图构造污染。
• 我想支持多种观点。

目前我有一个很好地组合在一起的 MVC 应用程序，没有 HATEOAS。域实体是纯 POJO，没有嵌入任何视图或 Web/REST 概念。例如：

class User {
   public String getName() {...}
   public String setName(String name) {...}
   ...
}

我的控制器也很简单。它们提供路由和状态，并委托给 Spring 的视图解析框架。请注意，我的应用程序支持 JSON、XML 和 HTML，但没有域实体或控制器嵌入视图信息：

@Controller
@RequestMapping("/users")
class UserController {

  @RequestMapping
  public ModelAndView getAllUsers() {
    List<User> users = userRepository.findAll();
    return new ModelAndView("users/index", "users", users);
  }

  @RequestMapping("/{id}")
  public ModelAndView getUser(@PathVariable Long id) {
    User user = userRepository.findById(id);
    return new ModelAndView("users/show", "user", user);
  }
}

所以，现在我的问题是 - 我不确定支持 HATEOAS 的干净方法。这是一个例子。假设当客户端请求 JSON 格式的用户时，结果如下：

{
  firstName: "John",
  lastName: "Smith"
}

假设当我支持 HATEOAS 时，我希望 JSON 包含一个简单的“self”链接，客户端可以使用该链接来刷新对象，删除它，或者其他什么。它还可能有一个“朋友”链接，指示如何获取用户的朋友列表：

{
  firstName: "John",
  lastName: "Smith",
  links: [
    {
      rel: "self",
      ref: "http://myserver/users/1"
    },
    {
      rel: "friends",
      ref: "http://myserver/users/1/friends"
    }
  ]
}

不知何故，我想将链接附加到我的对象。我认为执行此操作的正确位置是在控制器层中，因为控制器都知道正确的 URL。此外，由于我支持多个视图，我觉得正确的做法是以某种方式装饰控制器中的域实体，然后再将它们转换为 JSON/XML/Spring 视图解析框架中的任何内容。实现此目的的一种方法可能是使用包含链接列表的通用 Resource 类来包装有问题的 POJO。需要进行一些视图调整才能将其压缩为我想要的格式，但它是可行的。不幸的是，嵌套资源无法以这种方式包装。想到的其他事情包括添加到 ModelAndView 的链接，然后自定义每个 Spring 的开箱即用视图解析器以将链接填充到生成的 JSON/XML/等中。我不想要的是不断地手工制作 JSON/XML/等等。以适应开发过程中出现和消失的各种链接。

想法？

Answer 1

GitHub 上有一个名为 Spring HATEOAS 的有用项目，其描述如下：

“该项目提供了一些 API 来简化创建 REST 表示形式
使用 Spring 时遵循 HATEOAS 原则
特别是 Spring MVC”

如果您返回的资源类扩展了“ResourceSupport”，您可以轻松地向其添加链接，并且可以使用“ControllerLinkBuilder”构建链接，例如添加自链接：

import static org.sfw.hateoas.mvc.ControllerLinkBuilder.*;

Link link = linkTo(YourController.class).slash(resource.getName()).withSelfRel();
resource.add(link);

这是一个相当新的项目，但它是如果需要，可从公共 Maven 存储库获取：

<dependency>
    <groupId>org.springframework.hateoas</groupId>
    <artifactId>spring-hateoas</artifactId>
    <version>0.3.0.RELEASE</version>
</dependency>

如果您使用 Maven 工件：

org.sfw.hateoas.mvc.ControllerLinkBuilder

则变为：

org.springframework.hateoas.mvc.ControllerLinkBuilder

Answer 2

我的想法：

• 使用某种命名约定，例如可以根据对象的类名构造自引用 url。
• 我不认为添加链接的东西应该由控制器添加（顺便说一句，你自己写的“我不希望我的控制器被视图构造污染”。我会尝试寻找一种方法来扩展 JSON 序列化，以便它自动添加额外的东西。您可能需要向实体添加一些注释，即使这会稍微污染它们。

Answer 3

只是在寻找其他内容时偶然发现了这一点，并认为您应该考虑使用 Link 标头而不是 JSON 正文中的内容，这实际上只会污染资源的表示形式。

查看关于网络链接的 IETF 备忘录以及链接关系的 IANA 注册表。

Answer 4

要在您的 REST api 中创建链接，您可以使用 Spring 框架的 HAETOAS 项目。

org.springframework.hateoas.mvc.ControllerLinkBuilder 类有一组方法，您可以使用它们来构建链接，例如 -

Link link=linkTo(PersonControllerImpl.class).slash(null).withSelfRel();

另外，如果您有一个具有 @RequestMapping 注释的控制器方法一些 URI 值 -

@RequestMapping(value = "/customer", method = RequestMethod.GET, produces = {MediaType.APPLICATION_JSON_VALUE})
    public ResponseEntity<?> getCustomer() {

//...
}

那么您可以使用方法 URI 值创建链接 -

linkTo(methodOn(PersonControllerImpl.class).getCustomer()).toUri().toString()

它将返回 String 值 (http://www.urhost.com/customer)，您可以设置在你的实体 对象。