2015-05-26 22:39:48 +01:00
|
|
|
package server
|
|
|
|
|
|
|
|
import (
|
2018-03-03 11:53:52 +00:00
|
|
|
"context"
|
2020-02-15 15:10:26 +00:00
|
|
|
"crypto/tls"
|
2019-05-27 21:17:57 +08:00
|
|
|
"sync"
|
2016-01-26 23:32:27 +00:00
|
|
|
"time"
|
|
|
|
|
2020-08-19 17:47:17 +03:00
|
|
|
"github.com/unistack-org/micro/v3/auth"
|
|
|
|
"github.com/unistack-org/micro/v3/broker"
|
|
|
|
"github.com/unistack-org/micro/v3/codec"
|
|
|
|
"github.com/unistack-org/micro/v3/debug/trace"
|
|
|
|
"github.com/unistack-org/micro/v3/registry"
|
|
|
|
"github.com/unistack-org/micro/v3/transport"
|
2015-05-26 22:39:48 +01:00
|
|
|
)
|
|
|
|
|
2015-12-31 18:11:46 +00:00
|
|
|
type Options struct {
|
|
|
|
Codecs map[string]codec.NewCodec
|
|
|
|
Broker broker.Broker
|
|
|
|
Registry registry.Registry
|
2020-01-29 15:45:11 +00:00
|
|
|
Tracer trace.Tracer
|
2020-02-03 08:16:02 +00:00
|
|
|
Auth auth.Auth
|
2015-12-31 18:11:46 +00:00
|
|
|
Transport transport.Transport
|
|
|
|
Metadata map[string]string
|
|
|
|
Name string
|
|
|
|
Address string
|
|
|
|
Advertise string
|
|
|
|
Id string
|
2020-06-19 09:24:32 +01:00
|
|
|
Namespace string
|
2015-12-31 18:11:46 +00:00
|
|
|
Version string
|
|
|
|
HdlrWrappers []HandlerWrapper
|
|
|
|
SubWrappers []SubscriberWrapper
|
|
|
|
|
2019-05-13 01:39:42 +03:00
|
|
|
// RegisterCheck runs a check function before registering the service
|
|
|
|
RegisterCheck func(context.Context) error
|
2019-01-08 20:32:47 +00:00
|
|
|
// The register expiry time
|
2016-01-27 12:23:18 +00:00
|
|
|
RegisterTTL time.Duration
|
2019-01-24 13:22:17 +00:00
|
|
|
// The interval on which to register
|
|
|
|
RegisterInterval time.Duration
|
2016-01-27 12:23:18 +00:00
|
|
|
|
2019-01-08 20:32:47 +00:00
|
|
|
// The router for requests
|
|
|
|
Router Router
|
|
|
|
|
2020-02-15 15:10:26 +00:00
|
|
|
// TLSConfig specifies tls.Config for secure serving
|
|
|
|
TLSConfig *tls.Config
|
|
|
|
|
2016-01-06 16:25:12 +00:00
|
|
|
// Other options for implementations of the interface
|
|
|
|
// can be stored in a context
|
|
|
|
Context context.Context
|
2015-12-31 18:11:46 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
func newOptions(opt ...Option) Options {
|
|
|
|
opts := Options{
|
2019-09-23 17:59:34 +01:00
|
|
|
Codecs: make(map[string]codec.NewCodec),
|
|
|
|
Metadata: map[string]string{},
|
|
|
|
RegisterInterval: DefaultRegisterInterval,
|
|
|
|
RegisterTTL: DefaultRegisterTTL,
|
2015-11-25 19:50:05 +00:00
|
|
|
}
|
2015-05-26 22:39:48 +01:00
|
|
|
|
|
|
|
for _, o := range opt {
|
|
|
|
o(&opts)
|
|
|
|
}
|
|
|
|
|
2019-05-13 01:39:42 +03:00
|
|
|
if opts.RegisterCheck == nil {
|
|
|
|
opts.RegisterCheck = DefaultRegisterCheck
|
|
|
|
}
|
|
|
|
|
2015-12-31 18:11:46 +00:00
|
|
|
if len(opts.Address) == 0 {
|
|
|
|
opts.Address = DefaultAddress
|
2015-05-26 22:39:48 +01:00
|
|
|
}
|
|
|
|
|
2015-12-31 18:11:46 +00:00
|
|
|
if len(opts.Name) == 0 {
|
|
|
|
opts.Name = DefaultName
|
2015-05-26 22:39:48 +01:00
|
|
|
}
|
|
|
|
|
2015-12-31 18:11:46 +00:00
|
|
|
if len(opts.Id) == 0 {
|
|
|
|
opts.Id = DefaultId
|
2015-05-26 22:39:48 +01:00
|
|
|
}
|
|
|
|
|
2015-12-31 18:11:46 +00:00
|
|
|
if len(opts.Version) == 0 {
|
|
|
|
opts.Version = DefaultVersion
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
|
2015-05-26 22:39:48 +01:00
|
|
|
return opts
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Server name
|
2015-06-03 01:25:37 +01:00
|
|
|
func Name(n string) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Name = n
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-06-19 09:24:32 +01:00
|
|
|
// Namespace to register handlers in
|
|
|
|
func Namespace(n string) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.Namespace = n
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Unique server id
|
2015-06-03 01:25:37 +01:00
|
|
|
func Id(id string) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Id = id
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Version of the service
|
2015-06-03 01:25:37 +01:00
|
|
|
func Version(v string) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Version = v
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Address to bind to - host:port
|
2015-06-03 01:25:37 +01:00
|
|
|
func Address(a string) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Address = a
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// The address to advertise for discovery - host:port
|
2015-11-11 18:22:04 +00:00
|
|
|
func Advertise(a string) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Advertise = a
|
2015-11-11 18:22:04 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Broker to use for pub/sub
|
2015-06-12 19:52:27 +01:00
|
|
|
func Broker(b broker.Broker) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Broker = b
|
2015-06-12 19:52:27 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Codec to use to encode/decode requests for a given content type
|
2015-11-28 11:22:29 +00:00
|
|
|
func Codec(contentType string, c codec.NewCodec) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Codecs[contentType] = c
|
2015-11-25 19:50:05 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-12-05 19:37:03 +03:00
|
|
|
// Context specifies a context for the service.
|
|
|
|
// Can be used to signal shutdown of the service
|
|
|
|
// Can be used for extra option values.
|
|
|
|
func Context(ctx context.Context) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.Context = ctx
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Registry used for discovery
|
2015-06-03 01:25:37 +01:00
|
|
|
func Registry(r registry.Registry) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Registry = r
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-01-29 15:45:11 +00:00
|
|
|
// Tracer mechanism for distributed tracking
|
|
|
|
func Tracer(t trace.Tracer) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.Tracer = t
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-02-03 08:16:02 +00:00
|
|
|
// Auth mechanism for role based access control
|
|
|
|
func Auth(a auth.Auth) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.Auth = a
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Transport mechanism for communication e.g http, rabbitmq, etc
|
2015-06-03 01:25:37 +01:00
|
|
|
func Transport(t transport.Transport) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Transport = t
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-26 00:23:36 +00:00
|
|
|
// Metadata associated with the server
|
2015-06-03 01:25:37 +01:00
|
|
|
func Metadata(md map[string]string) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Metadata = md
|
2015-06-03 01:25:37 +01:00
|
|
|
}
|
|
|
|
}
|
2015-12-02 00:47:52 +00:00
|
|
|
|
2019-05-13 01:39:42 +03:00
|
|
|
// RegisterCheck run func before registry service
|
|
|
|
func RegisterCheck(fn func(context.Context) error) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.RegisterCheck = fn
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-01-27 12:23:18 +00:00
|
|
|
// Register the service with a TTL
|
|
|
|
func RegisterTTL(t time.Duration) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.RegisterTTL = t
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-01-24 13:22:17 +00:00
|
|
|
// Register the service with at interval
|
|
|
|
func RegisterInterval(t time.Duration) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.RegisterInterval = t
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-02-15 15:10:26 +00:00
|
|
|
// TLSConfig specifies a *tls.Config
|
|
|
|
func TLSConfig(t *tls.Config) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
// set the internal tls
|
|
|
|
o.TLSConfig = t
|
2020-02-17 09:28:48 +00:00
|
|
|
|
|
|
|
// set the default transport if one is not
|
|
|
|
// already set. Required for Init call below.
|
|
|
|
|
2020-02-15 15:10:26 +00:00
|
|
|
// set the transport tls
|
|
|
|
o.Transport.Init(
|
|
|
|
transport.Secure(true),
|
|
|
|
transport.TLSConfig(t),
|
|
|
|
)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-01-08 20:32:47 +00:00
|
|
|
// WithRouter sets the request router
|
|
|
|
func WithRouter(r Router) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.Router = r
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-05-31 19:47:50 +01:00
|
|
|
// Wait tells the server to wait for requests to finish before exiting
|
2019-05-27 21:17:57 +08:00
|
|
|
// If `wg` is nil, server only wait for completion of rpc handler.
|
|
|
|
// For user need finer grained control, pass a concrete `wg` here, server will
|
|
|
|
// wait against it on stop.
|
|
|
|
func Wait(wg *sync.WaitGroup) Option {
|
2017-05-31 19:47:50 +01:00
|
|
|
return func(o *Options) {
|
|
|
|
if o.Context == nil {
|
|
|
|
o.Context = context.Background()
|
|
|
|
}
|
2019-05-27 21:17:57 +08:00
|
|
|
if wg == nil {
|
|
|
|
wg = new(sync.WaitGroup)
|
|
|
|
}
|
|
|
|
o.Context = context.WithValue(o.Context, "wait", wg)
|
2017-05-31 19:47:50 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-02 00:47:52 +00:00
|
|
|
// Adds a handler Wrapper to a list of options passed into the server
|
2015-12-02 11:54:36 +00:00
|
|
|
func WrapHandler(w HandlerWrapper) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.HdlrWrappers = append(o.HdlrWrappers, w)
|
2015-12-02 00:47:52 +00:00
|
|
|
}
|
|
|
|
}
|
2015-12-02 11:54:36 +00:00
|
|
|
|
|
|
|
// Adds a subscriber Wrapper to a list of options passed into the server
|
|
|
|
func WrapSubscriber(w SubscriberWrapper) Option {
|
2015-12-31 18:11:46 +00:00
|
|
|
return func(o *Options) {
|
|
|
|
o.SubWrappers = append(o.SubWrappers, w)
|
2015-12-02 11:54:36 +00:00
|
|
|
}
|
|
|
|
}
|