Spring Boot：我可以将多个对象作为多个@RequestParams 发布到 REST 服务吗？

Question

使用 Spring Boot，我使用单个资源构建了一个玩具 REST 服务，如下所示：

@RestController
@RequestMapping("/checkout")
public class CheckoutRestController {

    @PostMapping("/book")
    public boolean buyBook(@RequestParam CreditCard creditCard, @RequestParam ShippingAddress shippingAddress) {
        return true;
    }
}

CreditCard和ShippingAddress都是我编写的 POJO（普通旧 Java 对象））。

我尝试使用此有效负载发布到此端点：

{
    "creditCard" : {
        "nameOnCard":"foo",
        "number":12345678,
        "expiryMonth":12,
        "expiryYear":2018,
        "ccv":100
    },
    "shippingAddress" : {
        "steert":"foor",
        "houseNumber":"1a",
        "city":"bar",
        "state":"bazz",
        "country":"buzz",
        "zipCode":"booz"
    },
}

但我得到一个错误：

{
    "timestamp": "2018-03-13T11:36:52.745+0000",
    "status": 400,
    "error": "Bad Request",
    "message": "Required CreditCard parameter 'creditCard' is not present",
    "path": "/checkout/book"
}

我知道一个解决方法是将两个 POJO 包装在一个请求包装器中，但我宁愿不这样做，除非我真的必须这样做。

是否可以发布两个@RequestParam 注释对象？ 如果是这样，JSON 会是什么样子？

Answer 1

@RequestParam参数是查询参数，不是正文参数。

这意味着您的方法：

@PostMapping("/book")
public boolean buyBook(@RequestParam CreditCard creditCard, @RequestParam 
    ShippingAddress shippingAddress) {

        return true;
}

期望以下请求：

POST /checkout/book?creditCard=<...>&shippingAddress=<...>

但是，Spring 不知道如何将String查询参数转换为CreditCard或ShippingAddress 。

您可以通过实施Converter来解决此问题，如下所示：

public class StringToCreditCardConverter implements Converter<String, CreditCard> {

    @Override
    public CreditCard convert(String source) {
         <...>
    }
}

但是，我不推荐这样做，因为它不是请求主体的标准，并且会导致很多混乱和可维护性问题。

相反，推荐的方法如下：

@PostMapping("/book")
public boolean buyBook(@RequestBody BookCreationRequest bookCreationRequest) {
        CreditCard creditCard = bookCreationRequest.getCreditCard();
        ShippingAddress shippingAddress = bookCreationRequest.getShippingAddress();
        ...
}

使用包含CreditCard和ShippingAddress字段的bookCreationRequest （注意：您可以使用例如lombok来减少样板代码）：

public class BookCreationRequest {
    private ShippingAddress shippingAddress;
    private CreditCredit creditCard;

    public ShippingAddress  getShippingAddress() {...}
    public CreditCard       getCreditCard() {...}

    public BookCreationRequest(ShippingAddress shippingAddress, CreditCard creditCard) {
        this.creditCard = creditCard;
        this.shippingAddress = shippingAddress;
}

然后期望请求 JSON 如下：

POST /checkout/book
Payload:
{
    "creditCard": {
        ... 
    },
    "shippingAddress": {
        ...
    }
}

请注意，请求中只能有一个@RequestBody参数。

Answer 2

是 - 创建一个包装器 Request 对象。 这不是解决方法 - 实际上是推荐的方法。

你在你的 json 中看到你有：

{ //wrapper
 {}, //first complex data object / mapped to pojo
 {} //second complex data object / mapped to pojo
}

1）您可以使用@Valid轻松地将验证应用于您的 Request 对象，从而验证两个 POJO。

2) 您不必担心负载中的顺序。

3) 你错误地使用了@RequestParam 。 @RequestBody映射整个 POST 负载。 您必须删除@RequestParam注释并改用@RequestBody 。