grpc

Documentation

Index

• Variables
• func NewClient(ctx context.Context, host string, opts ...ClientOption) (*grpc.ClientConn, error)
• func NewDialOptions(opts ...ClientOption) ([]grpc.DialOption, error)
• func StreamServerInterceptor() []grpc.StreamServerInterceptor
• func UnaryClientInterceptors(opts ...ClientOption) ([]grpc.UnaryClientInterceptor, error)
• func UnaryServerInterceptor() []grpc.UnaryServerInterceptor
• type ClientOption
  • func WithClientBreaker() ClientOption
  • func WithClientDialOption(opts ...grpc.DialOption) ClientOption
  • func WithClientLogger(logger *zap.Logger) ClientOption
  • func WithClientMetrics(meter metric.Meter) ClientOption
  • func WithClientRetry(cfg *retry.Config) ClientOption
  • func WithClientSecure(sec security.Config) (ClientOption, error)
  • func WithClientStreamInterceptors(stream ...grpc.StreamClientInterceptor) ClientOption
  • func WithClientTracer(tracer gtracer.Tracer) ClientOption
  • func WithClientUnaryInterceptors(unary ...grpc.UnaryClientInterceptor) ClientOption
  • func WithClientUserAgent(userAgent string) ClientOption
• type Config
• type Server
  • func NewServer(params ServerParams) (*Server, error)
  • func (s *Server) Start() error
  • func (s *Server) Stop(_ context.Context) error
• type ServerParams

Variables

var ErrInvalidPort = errors.New("invalid port")

ErrInvalidPort for gRPC.

Functions

func NewClient

func NewClient(ctx context.Context, host string, opts ...ClientOption) (*grpc.ClientConn, error)

NewClient to host for gRPC.

func NewDialOptions

func NewDialOptions(opts ...ClientOption) ([]grpc.DialOption, error)

NewDialOptions for gRPC.

func StreamServerInterceptor

func StreamServerInterceptor() []grpc.StreamServerInterceptor

StreamServerInterceptor for gRPC.

func UnaryClientInterceptors

func UnaryClientInterceptors(opts ...ClientOption) ([]grpc.UnaryClientInterceptor, error)

UnaryClientInterceptors for gRPC.

func UnaryServerInterceptor

func UnaryServerInterceptor() []grpc.UnaryServerInterceptor

UnaryServerInterceptor for gRPC.

Types

type ClientOption

type ClientOption interface {
	// contains filtered or unexported methods
}

ClientOption for HTTP.

func WithClientBreaker

func WithClientBreaker() ClientOption

WithClientBreaker for gRPC.

func WithClientDialOption

func WithClientDialOption(opts ...grpc.DialOption) ClientOption

WithClientDialOption for gRPC.

func WithClientLogger

func WithClientLogger(logger *zap.Logger) ClientOption

WithClientLogger for gRPC.

func WithClientMetrics

func WithClientMetrics(meter metric.Meter) ClientOption

WithClientMetrics for gRPC.

func WithClientRetry

func WithClientRetry(cfg *retry.Config) ClientOption

WithClientRetry for gRPC.

func WithClientSecure

func WithClientSecure(sec security.Config) (ClientOption, error)

WithClientSecure for gRPC.

func WithClientStreamInterceptors

func WithClientStreamInterceptors(stream ...grpc.StreamClientInterceptor) ClientOption

WithClientUnaryInterceptors for gRPC.

func WithClientTracer

func WithClientTracer(tracer gtracer.Tracer) ClientOption

WithClientTracer for gRPC.

func WithClientUnaryInterceptors

func WithClientUnaryInterceptors(unary ...grpc.UnaryClientInterceptor) ClientOption

WithClientUnaryInterceptors for gRPC.

func WithClientUserAgent

func WithClientUserAgent(userAgent string) ClientOption

WithUserAgent for gRPC.

type Config

type Config struct {
	Enabled   bool            `yaml:"enabled" json:"enabled" toml:"enabled"`
	Security  security.Config `yaml:"security" json:"security" toml:"security"`
	Port      string          `yaml:"port" json:"port" toml:"port"`
	Retry     retry.Config    `yaml:"retry" json:"retry" toml:"retry"`
	UserAgent string          `yaml:"user_agent" json:"user_agent" toml:"user_agent"`
}

Config for gRPC.

type Server

type Server struct {
	Server *grpc.Server
	// contains filtered or unexported fields
}

Server for gRPC.

func NewServer

func NewServer(params ServerParams) (*Server, error)

NewServer for gRPC.

func (*Server) Start

func (s *Server) Start() error

Start the server.

func (*Server) Stop

func (s *Server) Stop(_ context.Context) error

Stop the server.

type ServerParams

type ServerParams struct {
	fx.In

	Shutdowner fx.Shutdowner
	Config     *Config
	Logger     *zap.Logger
	Tracer     tracer.Tracer
	Meter      metric.Meter
	Unary      []grpc.UnaryServerInterceptor
	Stream     []grpc.StreamServerInterceptor
}

ServerParams for gRPC.