mirror of https://github.com/grpc/grpc-go.git
365770fcbd
This change introduces some behavior changes that should not impact users that
are following the proper stream protocol. Specifically, one of the following
conditions must be satisfied:
1. The user calls Close on the ClientConn.
2. The user cancels the context provided to NewClientStream, or its deadline
expires. (Note that it if the context is no longer needed before the deadline
expires, it is still recommended to call cancel to prevent bloat.) It is always
recommended to cancel contexts when they are no longer needed, and to
never use the background context directly, so all users should always be
doing this.
3. The user calls RecvMsg (or Recv in generated code) until a non-nil error is
returned.
4. The user receives any error from Header or SendMsg (or Send in generated
code) besides io.EOF. If none of the above happen, this will leak a goroutine
and a context, and grpc will not call the optionally-configured stats handler
with a stats.End message.
Before this change, if a user created a stream and the server ended the stream,
the stats handler would be invoked with a stats.End containing the final status
of the stream. Subsequent calls to RecvMsg would then trigger the stats handler
with InPayloads, which may be unexpected by stats handlers.
|
||
|---|---|---|
| .github | ||
| Documentation | ||
| balancer | ||
| benchmark | ||
| codes | ||
| connectivity | ||
| credentials | ||
| encoding | ||
| examples | ||
| grpclb | ||
| grpclog | ||
| health | ||
| internal | ||
| interop | ||
| keepalive | ||
| metadata | ||
| naming | ||
| peer | ||
| reflection | ||
| resolver | ||
| stats | ||
| status | ||
| stress | ||
| tap | ||
| test | ||
| testdata | ||
| transport | ||
| .travis.yml | ||
| AUTHORS | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| backoff.go | ||
| backoff_test.go | ||
| balancer.go | ||
| balancer_conn_wrappers.go | ||
| balancer_switching_test.go | ||
| balancer_test.go | ||
| balancer_v1_wrapper.go | ||
| call.go | ||
| call_test.go | ||
| clientconn.go | ||
| clientconn_test.go | ||
| codec.go | ||
| codec_test.go | ||
| codegen.sh | ||
| doc.go | ||
| go16.go | ||
| go17.go | ||
| grpclb.go | ||
| grpclb_picker.go | ||
| grpclb_remote_balancer.go | ||
| grpclb_util.go | ||
| interceptor.go | ||
| picker_wrapper.go | ||
| picker_wrapper_test.go | ||
| pickfirst.go | ||
| pickfirst_test.go | ||
| proxy.go | ||
| proxy_test.go | ||
| resolver_conn_wrapper.go | ||
| resolver_conn_wrapper_test.go | ||
| rpc_util.go | ||
| rpc_util_test.go | ||
| server.go | ||
| server_test.go | ||
| service_config.go | ||
| service_config_test.go | ||
| stream.go | ||
| trace.go | ||
| vet.sh | ||
README.md
gRPC-Go
The Go implementation of gRPC: A high performance, open source, general RPC framework that puts mobile and HTTP/2 first. For more information see the gRPC Quick Start: Go guide.
Installation
To install this package, you need to install Go and setup your Go workspace on your computer. The simplest way to install the library is to run:
$ go get -u google.golang.org/grpc
Prerequisites
This requires Go 1.6 or later. Go 1.7 will be required as of the next gRPC-Go release (1.8).
Constraints
The grpc package should only depend on standard Go packages and a small number of exceptions. If your contribution introduces new dependencies which are NOT in the list, you need a discussion with gRPC-Go authors and consultants.
Documentation
See API documentation for package and API descriptions and find examples in the examples directory.
Performance
See the current benchmarks for some of the languages supported in this dashboard.
Status
General Availability Google Cloud Platform Launch Stages.
FAQ
Compiling error, undefined: grpc.SupportPackageIsVersion
Please update proto package, gRPC package and rebuild the proto files:
go get -u github.com/golang/protobuf/{proto,protoc-gen-go}go get -u google.golang.org/grpcprotoc --go_out=plugins=grpc:. *.proto