grpc library

Classes

BadRequest
Describes violations in a client request. This error type focuses on the syntactic aspects of the request.
BadRequest_FieldViolation
A message type used to describe a single bad request field.
BaseAuthenticator
CallOptions
Runtime options for an RPC.
ChannelCredentials
Options controlling TLS security settings on a ClientChannel.
ChannelOptions
Options controlling how connections are made on a ClientChannel.
Client
Base class for client stubs.
ClientCall<Q, R>
An active call to a gRPC endpoint.
ClientChannel
A channel to a virtual gRPC endpoint.
ClientInterceptor
ClientInterceptors intercepts client calls before they are executed.
ClientKeepAliveOptions
KeepAlive support for gRPC, see https://github.com/grpc/grpc/blob/master/doc/keepalive.md. Options to configure a gRPC client for sending keepalive signals.
ClientMethod<Q, R>
Description of a gRPC method.
ClientTransportConnector
A transport-specific configuration used by gRPC clients to connect.
ClientTransportConnectorChannel
Code
The canonical error codes for gRPC APIs.
Codec
CodecRegistry
Encloses classes related to the compression and decompression of messages.
ComputeEngineAuthenticator
ConnectionServer
A gRPC server that serves via provided ServerTransportConnections.
DebugInfo
Describes additional debugging info.
ErrorInfo
Describes the cause of the error with structured details.
GrpcData
GrpcHttpDecoder
GrpcHttpEncoder
GrpcMessage
GrpcMetadata
GzipCodec
A gzip compressor and decompressor.
Help
Provides links to documentation or for performing an out of band action.
Describes a URL link.
HttpBasedAuthenticator
IdentityCodec
The "identity", or "none" codec.
JwtServiceAccountAuthenticator
LocalizedMessage
Provides a localized error message that is safe to return to the user which can be attached to an RPC error.
PreconditionFailure
Describes what preconditions have failed.
PreconditionFailure_Violation
A message type used to describe a single precondition failure.
Proxy
Proxy data class with optional authentication.
QuotaFailure
Describes how a quota check failed.
QuotaFailure_Violation
A message type used to describe a single quota violation. For example, a daily quota or a custom quota that was exceeded.
RequestInfo
Contains metadata about the request that clients can attach when filing a bug or providing other forms of feedback.
ResourceInfo
Describes the resource that is being accessed.
Response
A gRPC response.
ResponseFuture<R>
A gRPC response producing a single value.
ResponseStream<R>
A gRPC response producing a stream of values.
RetryInfo
Describes when the clients can retry a failed request. Clients could ignore the recommendation here or retry when this information is missing from error responses.
Server
A gRPC server.
ServerCredentials
Wrapper around grpc_server_credentials, a way to authenticate a server.
ServerKeepAliveOptions
Options to configure a gRPC server for receiving keepalive signals.
ServerLocalCredentials
Set of credentials that only allows local TCP connections.
ServerTlsCredentials
Service
Definition of a gRPC service.
ServiceAccountAuthenticator
ServiceCall
Server-side context for a gRPC call.
ServiceMethod<Q, R>
Definition of a gRPC service method.
StatusCode

Properties

isTimelineLoggingEnabled bool
Enable logging requests and response for clients.
getter/setter pair

Functions

allowBadCertificates(X509Certificate certificate, String host) bool
Bad certificate handler that disables all certificate checks. DO NOT USE IN PRODUCTION! Can be used during development and testing to accept self-signed certificates, etc.
applicationDefaultCredentialsAuthenticator(List<String> scopes) Future<HttpBasedAuthenticator>
Create an HttpBasedAuthenticator using Application Default Credentials.
createSecurityContext(bool isServer) SecurityContext
defaultBackoffStrategy(Duration? lastBackoff) Duration
fromTimeoutString(String? timeout) Duration?
Convert timeout from grpc-timeout header string format to Duration. Returns null if timeout is not correctly formatted.
grpcDecompressor({CodecRegistry? codecRegistry}) StreamTransformer<GrpcMessage, GrpcMessage>
toTimeoutString(Duration duration) String
Convert timeout to grpc-timeout header string format.

Typedefs

BackoffStrategy = Duration Function(Duration? lastBackoff)
BadCertificateHandler = bool Function(X509Certificate certificate, String host)
Handler for checking certificates that fail validation. If this handler returns true, the bad certificate is allowed, and the TLS handshake can continue. If the handler returns false, the TLS handshake fails, and the connection is aborted.
ClientStreamingInvoker<Q, R> = ResponseStream<R> Function(ClientMethod<Q, R> method, Stream<Q> requests, CallOptions options)
ClientUnaryInvoker<Q, R> = ResponseFuture<R> Function(ClientMethod<Q, R> method, Q request, CallOptions options)
Interceptor = FutureOr<GrpcError?> Function(ServiceCall call, ServiceMethod method)
A gRPC Interceptor.
MetadataProvider = FutureOr<void> Function(Map<String, String> metadata, String uri)
Provides per-RPC metadata.

Exceptions / Errors

GrpcError