响应消息：复合消息或可选字段

Question

我们正在使用一组 Web 服务，并且正在寻找向 Web 服务的使用者返回错误的最佳选择。这是当前的响应：

响应

• 有关服务器的一些数据
• 有关用户的一些数据
• 执行事务的一些结果数据

因此，我们也需要返回错误。这些是我们的选项：

复合消息

我们将返回两种响应，具体取决于交易是否获得批准或有错误：

第一个：

• 类型标识符（此消息已序列化。所以我需要知道我正在处理哪种消息，反序列化最后一部分）
• 关于服务器的一些数据
• 关于用户的一些数据
• 执行事务的一些结果数据

第二：

• 类型标识符（这个消息是序列化的。所以我需要知道哪种消息我正在处理，反序列化最后一部分）
• 有关服务器的一些数据
• 有关用户的一些数据
• 错误

可选字段

交易数据和错误字段将是可选的。如果没有错误，我就会知道它已获得批准。

• 有关服务器的一些数据
• 有关用户的一些数据
• 执行事务的一些结果数据
• 错误

哪个选项更合适？

Answer 1

这是有争议的，更多的是个人意见而不是最佳实践。

我个人喜欢使用可选字段，因为错误代码可能是操作的结果。我希望客户端在解析结果之前始终首先检查返回结果的（可选）错误属性。这还允许同时返回非致命错误和部分结果。独一无二，让它如此……独一无二。可选性更加灵活。