GRPC Programming Model: Difference between revisions
Jump to navigation
Jump to search
| (8 intermediate revisions by the same user not shown) | |||
| Line 12: | Line 12: | ||
<syntaxhighlight lang='go'> | <syntaxhighlight lang='go'> | ||
cc.Invoke(ctx, "/blue.service.quota.v1.QuotaService/SomeMethod", in, out, opts) | cc.Invoke(ctx, "/blue.service.quota.v1.QuotaService/SomeMethod", in, out, opts) | ||
</syntaxhighlight> | |||
[[GRPC_Concepts#Dial_Options|Dial Options]]. | |||
=Error Handling= | |||
https://grpc.io/docs/guides/error/ | |||
https://cloud.google.com/apis/design/errors#error_model | |||
https://grpc.io/docs/guides/status-codes/ | |||
Use https://pkg.go.dev/google.golang.org/grpc/internal/status | |||
gRPC service handlers should return error created by the <code>status</code> package, and gRPC clients should expect a corresponding error to be returned from the RPC call. | |||
<syntaxhighlight lang='go'> | |||
status.Errorf(codes.InvalidArgument, "request missing required field: Name") | |||
</syntaxhighlight> | |||
https://grpc.github.io/grpc/core/md_doc_statuscodes.html?ref=apisyouwonthate.com | |||
Converting a general error to a known status, if possible: | |||
<syntaxhighlight lang='go'> | |||
status.FromError() | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Latest revision as of 20:53, 20 August 2024
Internal
Instantiate a GRPC Client
A Client Invocation
The generated typed client contains a cc reference to google.golang.org/grpc ClientConn instance, which implements ClientConnInterface.
When a typed invocation is made, cc is invoked as such:
cc.Invoke(ctx, "/blue.service.quota.v1.QuotaService/SomeMethod", in, out, opts)
Error Handling
https://grpc.io/docs/guides/error/
https://cloud.google.com/apis/design/errors#error_model
https://grpc.io/docs/guides/status-codes/
Use https://pkg.go.dev/google.golang.org/grpc/internal/status
gRPC service handlers should return error created by the status package, and gRPC clients should expect a corresponding error to be returned from the RPC call.
status.Errorf(codes.InvalidArgument, "request missing required field: Name")
https://grpc.github.io/grpc/core/md_doc_statuscodes.html?ref=apisyouwonthate.com
Converting a general error to a known status, if possible:
status.FromError()