283 lines
5.9 KiB
Go
283 lines
5.9 KiB
Go
package client
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/micro/go-micro/broker"
|
|
"github.com/micro/go-micro/codec"
|
|
"github.com/micro/go-micro/registry"
|
|
"github.com/micro/go-micro/selector"
|
|
"github.com/micro/go-micro/transport"
|
|
|
|
"golang.org/x/net/context"
|
|
)
|
|
|
|
type Options struct {
|
|
// Used to select codec
|
|
ContentType string
|
|
|
|
// Plugged interfaces
|
|
Broker broker.Broker
|
|
Codecs map[string]codec.NewCodec
|
|
Registry registry.Registry
|
|
Selector selector.Selector
|
|
Transport transport.Transport
|
|
|
|
// Connection Pool
|
|
PoolSize int
|
|
PoolTTL time.Duration
|
|
|
|
// Middleware for client
|
|
Wrappers []Wrapper
|
|
|
|
// Default Call Options
|
|
CallOptions CallOptions
|
|
|
|
// Other options for implementations of the interface
|
|
// can be stored in a context
|
|
Context context.Context
|
|
}
|
|
|
|
type CallOptions struct {
|
|
SelectOptions []selector.SelectOption
|
|
|
|
// Backoff func
|
|
Backoff BackoffFunc
|
|
// Check if retriable func
|
|
Retry RetryFunc
|
|
// Transport Dial Timeout
|
|
DialTimeout time.Duration
|
|
// Number of Call attempts
|
|
Retries int
|
|
// Request/Response timeout
|
|
RequestTimeout time.Duration
|
|
|
|
// Middleware for low level call func
|
|
CallFuncWrappers []CallFuncWrapper
|
|
|
|
// Other options for implementations of the interface
|
|
// can be stored in a context
|
|
Context context.Context
|
|
}
|
|
|
|
type PublishOptions struct {
|
|
// Other options for implementations of the interface
|
|
// can be stored in a context
|
|
Context context.Context
|
|
}
|
|
|
|
type RequestOptions struct {
|
|
Stream bool
|
|
|
|
// Other options for implementations of the interface
|
|
// can be stored in a context
|
|
Context context.Context
|
|
}
|
|
|
|
func newOptions(options ...Option) Options {
|
|
opts := Options{
|
|
Codecs: make(map[string]codec.NewCodec),
|
|
CallOptions: CallOptions{
|
|
Backoff: DefaultBackoff,
|
|
Retry: DefaultRetry,
|
|
Retries: DefaultRetries,
|
|
RequestTimeout: DefaultRequestTimeout,
|
|
DialTimeout: transport.DefaultDialTimeout,
|
|
},
|
|
PoolSize: DefaultPoolSize,
|
|
PoolTTL: DefaultPoolTTL,
|
|
}
|
|
|
|
for _, o := range options {
|
|
o(&opts)
|
|
}
|
|
|
|
if len(opts.ContentType) == 0 {
|
|
opts.ContentType = defaultContentType
|
|
}
|
|
|
|
if opts.Broker == nil {
|
|
opts.Broker = broker.DefaultBroker
|
|
}
|
|
|
|
if opts.Registry == nil {
|
|
opts.Registry = registry.DefaultRegistry
|
|
}
|
|
|
|
if opts.Selector == nil {
|
|
opts.Selector = selector.NewSelector(
|
|
selector.Registry(opts.Registry),
|
|
)
|
|
}
|
|
|
|
if opts.Transport == nil {
|
|
opts.Transport = transport.DefaultTransport
|
|
}
|
|
|
|
return opts
|
|
}
|
|
|
|
// Broker to be used for pub/sub
|
|
func Broker(b broker.Broker) Option {
|
|
return func(o *Options) {
|
|
o.Broker = b
|
|
}
|
|
}
|
|
|
|
// Codec to be used to encode/decode requests for a given content type
|
|
func Codec(contentType string, c codec.NewCodec) Option {
|
|
return func(o *Options) {
|
|
o.Codecs[contentType] = c
|
|
}
|
|
}
|
|
|
|
// Default content type of the client
|
|
func ContentType(ct string) Option {
|
|
return func(o *Options) {
|
|
o.ContentType = ct
|
|
}
|
|
}
|
|
|
|
// PoolSize sets the connection pool size
|
|
func PoolSize(d int) Option {
|
|
return func(o *Options) {
|
|
o.PoolSize = d
|
|
}
|
|
}
|
|
|
|
// PoolSize sets the connection pool size
|
|
func PoolTTL(d time.Duration) Option {
|
|
return func(o *Options) {
|
|
o.PoolTTL = d
|
|
}
|
|
}
|
|
|
|
// Registry to find nodes for a given service
|
|
func Registry(r registry.Registry) Option {
|
|
return func(o *Options) {
|
|
o.Registry = r
|
|
}
|
|
}
|
|
|
|
// Transport to use for communication e.g http, rabbitmq, etc
|
|
func Transport(t transport.Transport) Option {
|
|
return func(o *Options) {
|
|
o.Transport = t
|
|
}
|
|
}
|
|
|
|
// Select is used to select a node to route a request to
|
|
func Selector(s selector.Selector) Option {
|
|
return func(o *Options) {
|
|
o.Selector = s
|
|
}
|
|
}
|
|
|
|
// Adds a Wrapper to a list of options passed into the client
|
|
func Wrap(w Wrapper) Option {
|
|
return func(o *Options) {
|
|
o.Wrappers = append(o.Wrappers, w)
|
|
}
|
|
}
|
|
|
|
// Adds a Wrapper to the list of CallFunc wrappers
|
|
func WrapCallFunc(cw ...CallFuncWrapper) Option {
|
|
return func(o *Options) {
|
|
o.CallOptions.CallFuncWrappers = append(o.CallOptions.CallFuncWrappers, cw...)
|
|
}
|
|
}
|
|
|
|
// Backoff is used to set the backoff function used
|
|
// when retrying Calls
|
|
func Backoff(fn BackoffFunc) Option {
|
|
return func(o *Options) {
|
|
o.CallOptions.Backoff = fn
|
|
}
|
|
}
|
|
|
|
// Number of retries when making the request.
|
|
// Should this be a Call Option?
|
|
func Retries(i int) Option {
|
|
return func(o *Options) {
|
|
o.CallOptions.Retries = i
|
|
}
|
|
}
|
|
|
|
// The request timeout.
|
|
// Should this be a Call Option?
|
|
func RequestTimeout(d time.Duration) Option {
|
|
return func(o *Options) {
|
|
o.CallOptions.RequestTimeout = d
|
|
}
|
|
}
|
|
|
|
// Transport dial timeout
|
|
func DialTimeout(d time.Duration) Option {
|
|
return func(o *Options) {
|
|
o.CallOptions.DialTimeout = d
|
|
}
|
|
}
|
|
|
|
// Call Options
|
|
|
|
func WithSelectOption(so ...selector.SelectOption) CallOption {
|
|
return func(o *CallOptions) {
|
|
o.SelectOptions = append(o.SelectOptions, so...)
|
|
}
|
|
}
|
|
|
|
// WithCallFuncWrapper is a CallOption which adds to the existing CallFunc wrappers
|
|
func WithCallFuncWrapper(cw ...CallFuncWrapper) CallOption {
|
|
return func(o *CallOptions) {
|
|
o.CallFuncWrappers = append(o.CallFuncWrappers, cw...)
|
|
}
|
|
}
|
|
|
|
// WithBackoff is a CallOption which overrides that which
|
|
// set in Options.CallOptions
|
|
func WithBackoff(fn BackoffFunc) CallOption {
|
|
return func(o *CallOptions) {
|
|
o.Backoff = fn
|
|
}
|
|
}
|
|
|
|
// WithRetry is a CallOption which overrides that which
|
|
// set in Options.CallOptions
|
|
func WithRetry(fn RetryFunc) CallOption {
|
|
return func(o *CallOptions) {
|
|
o.Retry = fn
|
|
}
|
|
}
|
|
|
|
// WithRetries is a CallOption which overrides that which
|
|
// set in Options.CallOptions
|
|
func WithRetries(i int) CallOption {
|
|
return func(o *CallOptions) {
|
|
o.Retries = i
|
|
}
|
|
}
|
|
|
|
// WithRequestTimeout is a CallOption which overrides that which
|
|
// set in Options.CallOptions
|
|
func WithRequestTimeout(d time.Duration) CallOption {
|
|
return func(o *CallOptions) {
|
|
o.RequestTimeout = d
|
|
}
|
|
}
|
|
|
|
// WithDialTimeout is a CallOption which overrides that which
|
|
// set in Options.CallOptions
|
|
func WithDialTimeout(d time.Duration) CallOption {
|
|
return func(o *CallOptions) {
|
|
o.DialTimeout = d
|
|
}
|
|
}
|
|
|
|
// Request Options
|
|
|
|
func StreamingRequest() RequestOption {
|
|
return func(o *RequestOptions) {
|
|
o.Stream = true
|
|
}
|
|
}
|