使用 gRPC 状态码并根据客户端构建响应的方法

在使用 gRPC 时，处理状态码和响应的方法至关重要。通常，错误状态码应通过 `status.error` 函数返回，该函数提供错误代码和消息。在返回响应时，如果存在错误，应返回 `nil` 值，否则返回实际响应对象。对于客户端，他们可以通过 `status.fromerror` 函数检查状态代码和消息，该函数将返回一个包含错误信息的 `Status` 对象。此外，在响应对象中包含一个错误属性不是必要的，因为状态码和消息已经提供了足够的信息。

我想知道当我们发送回用户时处理 grpc 状态代码和响应的最佳方法是什么？

func (us *customerservice) fetchresponse(ctx context.context, request *custpbv1.customerrequest) (*custpbv1.customerresponse, error) {
    meta := service.metadatafromcontext(ctx)
    clientid := meta.clientid
    if clientid <= 0 {
        msg := fmt.sprintf("could not retrieve client info for clientid:%d", clientid)
        // is this right way to return it?
        return nil, status.error(codes.notfound, msg)
    }

    resources := request.getresources()
    if len(resources) == 0 {
        // is this right way to return it?
        err := status.error(codes.invalidargument, "value cannot be null. (parameter 'resources')")
        return nil, err
    }

    return us.generatecustomerinfo(clientid, resources)
}

我的原型非常简单 -

service CustomerService {
   rpc FetchResponse(CustomerRequest) returns (CustomerResponse) {};
}

message CustomerRequest {
   string resources = 1;
}

message CustomerResponse {
   string proc = 1;
   string data = 2;
}

generatecustomerinfo 方法将返回 customerresponse 和 error 两者。但如果出现错误，那么状态码会是什么？我试图弄清楚人们在返回 grpc 状态代码和响应给用户时遵循的标准是什么。是否必须将状态码返回给客户端？

在响应对象中也有错误属性是个好主意吗？任何演示如何返回 grpc 状态和响应的最佳实践的示例都将对我有用。

正确答案

这样做完全没问题：

err := status.error(codes.invalidargument, "value cannot be null. (parameter 'resources')")
return nil, err

这将告诉您的客户存在错误，并且了解该信息后，客户可以检查状态代码和状态消息，如下所示：

resp, err = server.fetchresponse(context.background(), req)
s, ok := status.fromerror(err)

if ok { // there is an error
   fmt.printf("code: %d, message: %s\n", s.code(), s.message())
}

generatecustomerinfo 方法将返回 customerresponse 和错误。但如果出现错误，那么状态码会是什么？

对于 generatecustomerinfo，我们没有太多信息可以重现，但在我看来，您应该返回类似以下内容：

return &custpbv1.customerresponse{
    proc: "your_proc",
    data: "your_data",
}, nil

通过在错误中返回 nil，您将向客户端表明没有错误，并且在前面的代码中给出的 ok 将为 false。

在响应对象中也有错误属性是个好主意吗？

为此，您绝对可以添加错误属性，但是有必要这样做吗？您已经可以拥有 statuscode 和 message。它只会不必要地增加您的有效负载的大小。

但是如果generatecustomerinfo返回任何错误，那么我应该返回什么状态代码？我也需要定义它吗？

假设 generatecustomerinfo 的潜在实现如下：

func GenerateCustomerInfo() (*pb.CustomerResponse, error) {
    // some code
    if err {
        st := status.Error(codes.Internal /*or other*/, "a message")
        return nil, err
    }

    return &pb.CustomerResponse{
        Proc: "",
        Data: "",
    }, nil
}

它基本上会返回 customerresponse 或 nil，这完全是父函数所需要的。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。