2015-12-23 22:07:26 +03:00
|
|
|
package broker
|
|
|
|
|
2016-01-06 19:25:12 +03:00
|
|
|
import (
|
2018-03-03 14:53:52 +03:00
|
|
|
"context"
|
2016-01-17 02:39:47 +03:00
|
|
|
"crypto/tls"
|
|
|
|
|
2020-08-19 17:47:17 +03:00
|
|
|
"github.com/unistack-org/micro/v3/codec"
|
|
|
|
"github.com/unistack-org/micro/v3/registry"
|
2016-01-06 19:25:12 +03:00
|
|
|
)
|
|
|
|
|
2015-12-31 21:11:46 +03:00
|
|
|
type Options struct {
|
2020-08-25 13:44:41 +03:00
|
|
|
AutoAck bool
|
|
|
|
|
2020-03-07 00:25:16 +03:00
|
|
|
Addrs []string
|
|
|
|
Secure bool
|
|
|
|
Codec codec.Marshaler
|
|
|
|
|
2020-08-25 13:44:41 +03:00
|
|
|
// Handler executed when errors occur processing messages
|
|
|
|
ErrorHandler Handler
|
|
|
|
|
2016-01-17 02:39:47 +03:00
|
|
|
TLSConfig *tls.Config
|
2020-01-14 16:23:16 +03:00
|
|
|
// Registry used for clustering
|
|
|
|
Registry registry.Registry
|
2016-01-06 19:25:12 +03:00
|
|
|
// Other options for implementations of the interface
|
|
|
|
// can be stored in a context
|
|
|
|
Context context.Context
|
2015-12-31 21:11:46 +03:00
|
|
|
}
|
2015-12-23 22:07:26 +03:00
|
|
|
|
2015-12-31 21:14:40 +03:00
|
|
|
type PublishOptions struct {
|
2016-01-06 19:25:12 +03:00
|
|
|
// Other options for implementations of the interface
|
|
|
|
// can be stored in a context
|
|
|
|
Context context.Context
|
2015-12-31 21:14:40 +03:00
|
|
|
}
|
2015-12-23 22:07:26 +03:00
|
|
|
|
|
|
|
type SubscribeOptions struct {
|
2020-08-25 13:44:41 +03:00
|
|
|
// AutoAck ack messages if handler returns nil err
|
|
|
|
AutoAck bool
|
|
|
|
|
2020-08-18 16:00:51 +03:00
|
|
|
// Handler executed when errors occur processing messages
|
2020-08-25 13:44:41 +03:00
|
|
|
ErrorHandler Handler
|
2020-08-18 16:00:51 +03:00
|
|
|
|
2020-08-25 13:44:41 +03:00
|
|
|
// Subscribers with the same group name
|
2015-12-23 23:05:47 +03:00
|
|
|
// will create a shared subscription where each
|
|
|
|
// receives a subset of messages.
|
2020-08-25 13:44:41 +03:00
|
|
|
Group string
|
2015-12-31 21:14:40 +03:00
|
|
|
|
2016-01-06 19:25:12 +03:00
|
|
|
// Other options for implementations of the interface
|
|
|
|
// can be stored in a context
|
|
|
|
Context context.Context
|
2015-12-23 22:07:26 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
type Option func(*Options)
|
|
|
|
|
|
|
|
type PublishOption func(*PublishOptions)
|
|
|
|
|
2020-04-28 19:29:00 +03:00
|
|
|
// PublishContext set context
|
|
|
|
func PublishContext(ctx context.Context) PublishOption {
|
|
|
|
return func(o *PublishOptions) {
|
|
|
|
o.Context = ctx
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-23 22:07:26 +03:00
|
|
|
type SubscribeOption func(*SubscribeOptions)
|
|
|
|
|
2018-11-30 20:32:48 +03:00
|
|
|
func NewSubscribeOptions(opts ...SubscribeOption) SubscribeOptions {
|
2020-08-18 16:00:51 +03:00
|
|
|
opt := SubscribeOptions{}
|
2016-01-17 01:13:02 +03:00
|
|
|
|
|
|
|
for _, o := range opts {
|
|
|
|
o(&opt)
|
|
|
|
}
|
|
|
|
|
|
|
|
return opt
|
|
|
|
}
|
|
|
|
|
2016-03-16 01:12:28 +03:00
|
|
|
// Addrs sets the host addresses to be used by the broker
|
|
|
|
func Addrs(addrs ...string) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.Addrs = addrs
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-12-06 21:59:41 +03:00
|
|
|
// Codec sets the codec used for encoding/decoding used where
|
|
|
|
// a broker does not support headers
|
2019-01-10 12:42:02 +03:00
|
|
|
func Codec(c codec.Marshaler) Option {
|
2016-12-06 21:59:41 +03:00
|
|
|
return func(o *Options) {
|
|
|
|
o.Codec = c
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-03-07 00:25:16 +03:00
|
|
|
// ErrorHandler will catch all broker errors that cant be handled
|
|
|
|
// in normal way, for example Codec errors
|
2020-08-25 13:44:41 +03:00
|
|
|
func ErrorHandler(h Handler) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.ErrorHandler = h
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// SubscribeErrorHandler will catch all broker errors that cant be handled
|
|
|
|
// in normal way, for example Codec errors
|
|
|
|
func SubscribeErrorHandler(h Handler) SubscribeOption {
|
2020-08-18 16:00:51 +03:00
|
|
|
return func(o *SubscribeOptions) {
|
2020-03-07 00:25:16 +03:00
|
|
|
o.ErrorHandler = h
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-08-25 13:44:41 +03:00
|
|
|
// SubscribeGroup sets the name of the queue to share messages on
|
|
|
|
func SubscribeGroup(name string) SubscribeOption {
|
2015-12-23 23:05:47 +03:00
|
|
|
return func(o *SubscribeOptions) {
|
2020-08-25 13:44:41 +03:00
|
|
|
o.Group = name
|
2015-12-23 23:05:47 +03:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-01-20 18:22:44 +03:00
|
|
|
func Registry(r registry.Registry) Option {
|
|
|
|
return func(o *Options) {
|
2020-01-14 16:23:16 +03:00
|
|
|
o.Registry = r
|
2016-01-20 18:22:44 +03:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-01-17 01:13:02 +03:00
|
|
|
// Secure communication with the broker
|
|
|
|
func Secure(b bool) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.Secure = b
|
2015-12-23 22:07:26 +03:00
|
|
|
}
|
|
|
|
}
|
2016-01-17 02:39:47 +03:00
|
|
|
|
|
|
|
// Specify TLS Config
|
|
|
|
func TLSConfig(t *tls.Config) Option {
|
|
|
|
return func(o *Options) {
|
|
|
|
o.TLSConfig = t
|
|
|
|
}
|
|
|
|
}
|
2019-01-24 00:46:26 +03:00
|
|
|
|
|
|
|
// SubscribeContext set context
|
|
|
|
func SubscribeContext(ctx context.Context) SubscribeOption {
|
|
|
|
return func(o *SubscribeOptions) {
|
|
|
|
o.Context = ctx
|
|
|
|
}
|
|
|
|
}
|