spring-boot - 用于搜索 API 的 Spring Boot REST 设计

Question

我正在设计一个 SpringBoot RESTful API，用于使用各种属性搜索Product(搜索可以是一个或多个)。很少有标准大于一定数量，也很少有小于一定数量的标准。在@RequestParam中，我们可以采用字符串或类似的值，但不能采用任何条件。

我的问题是，在 GET 搜索 API 调用中获取符合这些条件的用户数据的最佳方式是什么

@GetMapping("/search")
public ResponseEntity<List<OrderView>> searchOrders(...)
{
...
// call to service implementation
...
}

Answer 1

嗯... https://spring.io/guides/tutorials/bookmarks/对 Spring 的 REST 服务有很好的描述。它还描述了 RESTful 原则的不同级别(并且您可以使用 HAL 的 spring-boot 非常简单而巧妙地实现 HATEOAS)。

当您进行搜索时，您没有资源(level1)url，但您想获取它......所以可以(恕我直言)进行简单的查询参数调用。例如，当查看 amazon.com 并在那里输入一些搜索参数时，您会发现他们使用了一种简单的方法:

https://www.amazon.de/s/ref=nb_sb_noss?....&url=search-alias%3Daps&field-keywords=criteria1+criteria2+criteria3

他们只是将关键字添加为连接字符串。

还有来自 apigee 的有趣博客条目: https://apigee.com/about/blog/technology/restful-api-design-tips-search