跳到主要内容
版本:5.1.1

集成

Doubao 中英对照 Integration

本节详细介绍与 Spring Data REST 组件集成的各种方式,无论是从使用 Spring Data REST 的 Spring 应用集成,还是通过其他方式集成。

有时您需要在自己定制的 Spring MVC 控制器中,为已导出的资源添加链接。链接共有三个基本层级:

  • 手动组装链接。

  • 使用 Spring HATEOAS 的 LinkBuilder,配合 linkTo()、slash() 等方法。

  • 使用 Spring Data REST 对 RepositoryEntityLinks 的实现。

第一种做法很糟糕,应当不惜一切代价避免。它会让代码变得脆弱且高风险。第二种做法在创建指向其他手写 Spring MVC 控制器的链接时很方便。最后一种做法(本节后续将探讨)适合查找由 Spring Data REST 导出的资源链接。

请看下面这个类,它使用了 Spring 的自动装配:

public class MyWebApp {

private RepositoryEntityLinks entityLinks;

@Autowired
public MyWebApp(RepositoryEntityLinks entityLinks) {
this.entityLinks = entityLinks;
}
}

借助上例中的类,您可以使用以下操作:

表 1. 链接到已导出资源的方式

方法描述
entityLinks.linkToCollectionResource(Person.class)提供指向指定类型(本例为 Person)集合资源的链接。
entityLinks.linkToItemResource(Person.class, 1)提供指向单个资源的链接。
entityLinks.linkToPagedResource(Person.class, new PageRequest(…​))提供指向分页资源的链接。
entityLinks.linksToSearchResources(Person.class)提供对应仓库所暴露的所有查找方法的链接列表。
entityLinks.linkToSearchResource(Person.class, "findByLastName")按 rel(即查找方法的名称)提供查找链接。
备注

所有基于搜索的链接都支持用于分页与排序的额外参数。详情请参阅 RepositoryEntityLinks。还有一个 linkFor(Class<?> type),但它返回的是 Spring HATEOAS LinkBuilder,会让您回到更低层级的 API。请尽量优先使用其他方法。