在 Spring Boot rest 中检索查询参数的正确方法？答案

【问题标题】：right way to retrieve query parameters in Spring Boot rest?在 Spring Boot rest 中检索查询参数的正确方法？
【发布时间】：2018-05-03 17:15:03
【问题描述】：

我正在使用 Spring Boot 开发 REST api。我有一个接受 POST 请求的控制器。

http://localhost:8085/carride/end-ride

在上述请求中，我想访问参数ride_transection_id 以查找特定的横断对象以及其他一些值。所以基本上我有 3 种方法可以做到这一点。

1. 我可以使用@PathVariable

@RequestMapping(value = "/end-ride", method = RequestMethod.POST)
public ResponseEntity<?> endRide(@PathVariable("ride_transection_id") long ride_transection_id,@RequestBody 
SomeDTORequest someDTORequest ) {
//find transaction using path varibale 

}

2.我可以使用@RequestParam

    @RequestMapping(value = "/end-ride", method = RequestMethod.POST
    public @ResponseBody item getitem(@RequestParam("ride_transection_id") 
    long ride_transection_id,@RequestBody SomeDTORequest someDTORequest ){

    //find transaction using RequestParam varibale 

    }

我可以使用 DTO 对象 SomeDTORequest 并接受 ride_transection_id 以及其他值。

@RequestMapping(value = "/end-ride", method = RequestMethod.POST)
public ResponseEntity<?> endRide(@RequestBody SomeDTORequest someDTORequest ) {
//find transaction using path someDTORequest .getID()

}

我有点困惑。只是想问一下访问ride_transection_id 的最安全和正确的方法是什么？

谢谢

【问题讨论】：

没有一个正确的答案。这取决于您的要求。你说的这里最安全到底是什么意思？
我更喜欢使用 @PathVariable("ride_transection_id") ，因为这是通过 id 接收对象的正确方法（我的观点）。 @RequestParams 更多关于配置/附加参数，以便在获取之前/之后使用数据进行操作。
你检查我的答案了吗？

标签： spring rest spring-mvc spring-boot

【解决方案1】：

基本上，这三种方法都可以。但是如果你想开发或设计具有最佳实践的 RESTful 服务，我强烈建议你应该提供 @PathVariable 和 GET 方法的查询服务，例如 GET /tickets/12。否则，使用 @RequestBody 注释消化请求正文以检索 POST 方法的查询条件是第二个建议。

因为 POST 方法通常用于创建某些东西。对于查询某些内容，@PathVariable 和 @RequestParam 注释都适用于 GET 方法。更具体地说，@RequestParam 通常用于过滤、排序和搜索结果。例如：

过滤：GET /tickets?state=open - 这里，state 是一个实现过滤器的查询参数。
排序：GET /tickets?sort=-priority,created_at - 按优先级降序检索工单列表。在特定优先级内，先订购旧票。
正在搜索：GET /tickets?state=closed&sort=-updated_at - 检索最近关闭的票证。

也请参考这篇文章Best Practices for Designing a Pragmatic RESTful API。希望这对你有帮助！ :)

【讨论】：

【解决方案2】：

您可以使用其中任何一种，但每种方式都是为特定用途而设计的。

路径变量：当您需要使用某个字段访问实体时使用，例如我想访问订单并且此订单由 id 定义，因此要访问此订单我需要以下请求 Get /order/{id}

请求参数：当您想为特定方法发送特定变量或标志时例如Get /orders?is_shipped=true，因此这将获得所有已发货的订单，或者您可能需要在特定页面上订购Get /orders?page=1

请求正文：当您需要通过 put 或 patch 请求更新实体时，您将使用可以通过请求正文发送的实体的 json 表示来更新实体例如PUT /orders/{id} 正文：{"title": "order_1"} 那么 ID 为 {id} 的订单将更新为新标题

Spring data rest