reflection

README

Reflection

Package reflection implements server reflection service.

The service implemented is defined in: https://github.com/grpc/grpc/blob/master/src/proto/grpc/reflection/v1alpha/reflection.proto.

To register server reflection on a gRPC server:

import "google.golang.org/grpc/reflection"

s := grpc.NewServer()
pb.RegisterYourOwnServer(s, &server{})

// Register reflection service on gRPC server.
reflection.Register(s)

s.Serve(lis)

Documentation

Overview

Package reflection implements server reflection service.

The service implemented is defined in: https://github.com/grpc/grpc/blob/master/src/proto/grpc/reflection/v1alpha/reflection.proto.

To register server reflection on a gRPC server:

import "google.golang.org/grpc/reflection"

s := grpc.NewServer()
pb.RegisterYourOwnServer(s, &server{})

// Register reflection service on gRPC server.
reflection.Register(s)

s.Serve(lis)

Index

• func NewServer(opts ServerOptions) v1alphagrpc.ServerReflectionServer
• func NewServerV1(opts ServerOptions) v1grpc.ServerReflectionServer
• func Register(s GRPCServer)
• func RegisterV1(s GRPCServer)
• type ExtensionResolver
• type GRPCServer
• type ServerOptions
• type ServiceInfoProvider

Functions

func NewServer

func NewServer(opts ServerOptions) v1alphagrpc.ServerReflectionServer

NewServer returns a reflection server implementation using the given options. This can be used to customize behavior of the reflection service. Most usages should prefer to use Register instead. For backwards compatibility reasons, this returns the v1alpha version of the reflection server. For a v1 version of the reflection server, see NewServerV1.

Experimental

Notice: This function is EXPERIMENTAL and may be changed or removed in a later release.

func NewServerV1

func NewServerV1(opts ServerOptions) v1grpc.ServerReflectionServer

NewServerV1 returns a reflection server implementation using the given options. This can be used to customize behavior of the reflection service. Most usages should prefer to use Register instead.

Experimental

Notice: This function is EXPERIMENTAL and may be changed or removed in a later release.

func Register

func Register(s GRPCServer)

Register registers the server reflection service on the given gRPC server. Both the v1 and v1alpha versions are registered.

func RegisterV1

func RegisterV1(s GRPCServer)

RegisterV1 registers only the v1 version of the server reflection service on the given gRPC server. Many clients may only support v1alpha so most users should use Register instead, at least until clients have upgraded.

Types

type ExtensionResolver

type ExtensionResolver interface {
	protoregistry.ExtensionTypeResolver
	RangeExtensionsByMessage(message protoreflect.FullName, f func(protoreflect.ExtensionType) bool)
}

ExtensionResolver is the interface used to query details about extensions. This interface is satisfied by protoregistry.GlobalTypes.

Experimental

Notice: This type is EXPERIMENTAL and may be changed or removed in a later release.

type GRPCServer

type GRPCServer interface {
	grpc.ServiceRegistrar
	ServiceInfoProvider
}

GRPCServer is the interface provided by a gRPC server. It is implemented by *grpc.Server, but could also be implemented by other concrete types. It acts as a registry, for accumulating the services exposed by the server.

type ServerOptions

type ServerOptions struct {
	// The source of advertised RPC services. If not specified, the reflection
	// server will report an empty list when asked to list services.
	//
	// This value will typically be a *grpc.Server. But the set of advertised
	// services can be customized by wrapping a *grpc.Server or using an
	// alternate implementation that returns a custom set of service names.
	Services ServiceInfoProvider
	// Optional resolver used to load descriptors. If not specified,
	// protoregistry.GlobalFiles will be used.
	DescriptorResolver protodesc.Resolver
	// Optional resolver used to query for known extensions. If not specified,
	// protoregistry.GlobalTypes will be used.
	ExtensionResolver ExtensionResolver
}

ServerOptions represents the options used to construct a reflection server.

Experimental

Notice: This type is EXPERIMENTAL and may be changed or removed in a later release.

type ServiceInfoProvider

type ServiceInfoProvider interface {
	GetServiceInfo() map[string]grpc.ServiceInfo
}

ServiceInfoProvider is an interface used to retrieve metadata about the services to expose.

The reflection service is only interested in the service names, but the signature is this way so that *grpc.Server implements it. So it is okay for a custom implementation to return zero values for the grpc.ServiceInfo values in the map.

Experimental

Notice: This type is EXPERIMENTAL and may be changed or removed in a later release.