Documentation
¶
Overview ¶
Package manual defines a resolver that can be used to manually send resolved addresses to ClientConn.
Index ¶
- type Resolver
- func (r *Resolver) Build(target resolver.Target, cc resolver.ClientConn, opts resolver.BuildOptions) (resolver.Resolver, error)
- func (r *Resolver) CC() resolver.ClientConn
- func (r *Resolver) Close()
- func (r *Resolver) InitialState(s resolver.State)
- func (r *Resolver) ResolveNow(o resolver.ResolveNowOptions)
- func (r *Resolver) Scheme() string
- func (r *Resolver) UpdateState(s resolver.State)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Resolver ¶
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()
// contains filtered or unexported fields
}
Resolver is also a resolver builder. It's build() function always returns itself.
func NewBuilderWithScheme ¶
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) CC ¶ added in v1.25.0
func (r *Resolver) CC() resolver.ClientConn
CC returns r's ClientConn when r was last Built. Panics if the resolver has not been Built before.
func (*Resolver) InitialState ¶ added in v1.20.0
InitialState adds initial state to the resolver so that UpdateState doesn't need to be explicitly called after Dial.
func (*Resolver) ResolveNow ¶
func (r *Resolver) ResolveNow(o resolver.ResolveNowOptions)
ResolveNow is a noop for Resolver.
func (*Resolver) UpdateState ¶ added in v1.20.0
UpdateState calls UpdateState(s) on the channel. If the resolver has not been Built before, this instead sets the initial state of the resolver, like InitialState.