...

Package manual

import "google.golang.org/grpc/resolver/manual"
Overview
Index

Overview ▾

Package manual defines a resolver that can be used to manually send resolved addresses to ClientConn.

type Resolver

Resolver is also a resolver builder. It's build() function always returns itself.

type Resolver struct {
    // BuildCallback is called when the Build method is called.  Must not be
    // nil.  Must not be changed after the resolver may be built.
    BuildCallback func(resolver.Target, resolver.ClientConn, resolver.BuildOptions)
    // UpdateStateCallback is called when the UpdateState method is called on
    // the resolver.  The value passed as argument to this callback is the value
    // returned by the resolver.ClientConn.  Must not be nil.  Must not be
    // changed after the resolver may be built.
    UpdateStateCallback func(err error)
    // ResolveNowCallback is called when the ResolveNow method is called on the
    // resolver.  Must not be nil.  Must not be changed after the resolver may
    // be built.
    ResolveNowCallback func(resolver.ResolveNowOptions)
    // CloseCallback is called when the Close method is called.  Must not be
    // nil.  Must not be changed after the resolver may be built.
    CloseCallback func()

    CC resolver.ClientConn
    // contains filtered or unexported fields
}

func NewBuilderWithScheme

func NewBuilderWithScheme(scheme string) *Resolver

NewBuilderWithScheme creates a new manual resolver builder with the given scheme. Every instance of the manual resolver may only ever be used with a single grpc.ClientConn. Otherwise, bad things will happen.

func (*Resolver) Build

func (r *Resolver) Build(target resolver.Target, cc resolver.ClientConn, opts resolver.BuildOptions) (resolver.Resolver, error)

Build returns itself for Resolver, because it's both a builder and a resolver.

func (*Resolver) Close

func (r *Resolver) Close()

Close is a noop for Resolver.

func (*Resolver) InitialState

func (r *Resolver) InitialState(s resolver.State)

InitialState adds initial state to the resolver so that UpdateState doesn't need to be explicitly called after Dial.

func (*Resolver) ReportError

func (r *Resolver) ReportError(err error)

ReportError calls CC.ReportError.

func (*Resolver) ResolveNow

func (r *Resolver) ResolveNow(o resolver.ResolveNowOptions)

ResolveNow is a noop for Resolver.

func (*Resolver) Scheme

func (r *Resolver) Scheme() string

Scheme returns the manual resolver's scheme.

func (*Resolver) UpdateState

func (r *Resolver) UpdateState(s resolver.State)

UpdateState calls CC.UpdateState.