HTTP Spring 启动时部分创建资源时返回的状态 - rest api？

Question

我有一个场景，来自第一个微服务的发布请求创建新用户并为来自不同微服务的新创建用户创建钱包。

创建用户和钱包时，我将返回 HTTP 状态 201。 如果创建了用户但没有创建钱包，我应该返回什么状态我有点困惑。

我遇到了一些文章，发现有两篇与我的困惑相关，但由于其与 WebDAV 相关的限制，在返回 HTTP 状态 207 时相互矛盾。

1. Http response 207 MULTI-STATUS 适合多任务操作吗？
2. REST API 响应部分成功

参考我的代码 -

    @PostMapping("/register")
public ResponseEntity<User> saveUser(@RequestBody User user) {
    user.setUserId(sequenceGeneratorService.generateSequence(User.SEQUENCE_NAME));
    user.getRoles().forEach(role -> role.setRoleId(sequenceGeneratorService.generateSequence(Role.SEQUENCE_NAME)));

    User savedUser = userService.saveUser(user);
    ResponseEntity<Wallet> createdWallet = createUserWallet(savedUser);
    if (createdWallet.getStatusCode().is2xxSuccessful()) {
        savedUser.setWallet(createdWallet.getBody());
        return new ResponseEntity<User>(savedUser, HttpStatus.CREATED);
    } else {// here is the confusion

        return new ResponseEntity<User>(savedUser, HttpStatus.MULTI_STATUS);
    }
}

private ResponseEntity<Wallet> createUserWallet(User savedUser) {
    Wallet userWallet = Wallet.builder()
            .walletId(sequenceGeneratorService.generateSequence(Wallet.SEQUENCE_NAME))
            .userId(savedUser.getUserId())
            .balance(BigDecimal.ZERO).build();
    return walletServiceProxy.createWallet(userWallet);
}

我可以知道我应该在这里返回哪种状态吗？

Answer 1

创建用户和钱包时，我将返回 HTTP 状态 201。 如果创建了用户但没有创建钱包，我应该返回什么状态我有点困惑。

HTTP 状态代码是 transfer-of-documents-over-a.network 域的元数据（参见Webber 2011 ）； 它们在那里，以便通用 HTTP 组件可以正确解释响应，并做一些智能的事情（比如在适当的时候使以前缓存的响应无效）。

您的 HTTP API 是一个外观：您的实现所穿的服装使其看起来像一个 HTTP 感知文档存储。 （你的实现没有“文档”的事实是一个实现细节，隐藏在这个外观之后。）

您发送的响应应该以同样的方式理解 - 您告诉 HTTP 客户端（以及任何可以读取响应元数据的中间组件）您的（假想的）web 页面如何对发送的请求做出反应。

消息处理成功了吗？ 它是否创建了一个新的（假想的）web 页面，它有自己的标识符，客户端可以向其发送消息？ 那么您通常应该发回201 Created ，即使实现没有通过“快乐路径”实现该结果。

另一方面，如果您希望通用组件了解请求处理失败，您可以根据需要发送 4XX 客户端错误或 5XX 服务器错误。

（你可能不应该使用 207 MultiStatus 除非你故意做WebDav的事情并且期望来自 WebDav 感知组件的请求;它不会实现任何有用的除非客户端实现知道如何处理多状态 XML 文档）。

---

提醒：HTTP 响应中您详细描述发生了什么以及最终消费者如何响应的部分是 HTTP 响应的主体。

201 Created
Location: /users/12345
Content-Type: text/plain

Hey, we created the new user you asked us to.  Isn't that great?
You can review the details of the user at: /users/12345

But, we weren't able to create a wallet for the user.  If that's
kind of important to you, could you fill in this form and send it
to us: /lost-wallets#form ?

Thanks, and have a great day