Spring HATEOAS 构建指向分页资源的链接

Question

我有一个带有方法的控制器，它返回PagedResource，它看起来像这样：

@RequestMapping(value = "search/within", method = RequestMethod.POST)
public @ResponseBody PagedResources within(@RequestBody GeoJsonBody body,
                                           Pageable pageable, PersistentEntityResourceAssembler asm) {

    //  GET PAGE

    return pagedResourcesAssembler.toResource(page, asm);
}

现在，我想将该方法添加为根资源的链接，因此我执行以下操作：

public RepositoryLinksResource process(RepositoryLinksResource repositoryLinksResource) {
    repositoryLinksResource.add(linkTo(methodOn(ShipController.class).within(null, null, null)).withRel("within"));

    return repositoryLinksResource;
}

哪个有效，我得到了我的链接，但是它添加了没有分页参数的链接。所以它看起来像这样：

    "within": {
        "href": "http://127.0.0.1:5000/search/within"
    },

我想把它变成：

    "within": {
        "href": "http://127.0.0.1:5000/search/within{?page, size}"
    },

This 上一个关于 stackoverflow 的问题表明，在修复 corresponding issue on GitHub 后，它应该默认工作，但是它没有。

我做错了什么？

Answer 1

使用 PagedResourcesAssembler 自动创建分页链接

我成功使用了PagedResourcesAssembler。假设您的实体被称为 MyEntity。你的within 方法应该返回HttpEntity<PagedResources<MyEntity>>。

您的within 方法应该类似于下面显示的示例。

@RequestMapping(value = "search/within", method = RequestMethod.POST)
@ResponseBody 
public HttpEntity<PagedResources<MyEntity>> 
    within(@RequestBody GeoJsonBody body,Pageable pageable, 
           PagedResourcesAssembler assembler) {
    //  GET PAGE
    Page<MyEntity> page = callToSomeMethod(pageable);

    return new ResponseEntity<>(assembler.toResource(page), HttpStatus.OK);
}

Here 是一个简单的例子。在此示例中，响应如下所示，

{
    "_embedded": {
    "bookList": [
      {
        "id": "df3372ef-a0a2-4569-982a-78c708d1f609",
        "title": "Tales of Terror",
        "author": "Edgar Allan Poe"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "http://localhost:8080/books?page=0&size=20"
    }
  },
  "page": {
    "size": 20,
    "totalElements": 1,
    "totalPages": 1,
    "number": 0
  }
}

手动创建分页自链接

如果您有兴趣手动创建分页链接，这里是您可以使用的代码 sn-p，

Page<MyEntity> page = callToSomeMethod(pageable);

ControllerLinkBuilder ctrlBldr =
    linkTo(methodOn(ShipController.class).within(body, pageable, asm));
UriComponentsBuilder builder = ctrlBldr.toUriComponentsBuilder();

int pageNumber = page.getPageable().getPageNumber();
int pageSize = page.getPageable().getPageSize();
int maxPageSize = 2000;

builder.replaceQueryParam("page", pageNumber);
builder.replaceQueryParam("size", pageSize <= maxPageSize ? 
    page.getPageable().getPageSize() : maxPageSize);

Link selfLink =
    new Link(new UriTemplate(builder.build().toString()), "self");