集成
本节详细介绍与 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。请尽量优先使用其他方法。