broker

Documentation

Index

• Variables
• func Marshal(codec encoding.Codec, msg Any) ([]byte, error)
• func Unmarshal(codec encoding.Codec, inputData []byte, outValue interface{}) error
• type Any
• type Binder
• type Broker
• type Event
• type Handler
• type Headers
• type Message
  • func (m Message) GetHeader(key string) string
  • func (m Message) GetHeaders() Headers
• type Option
  • func WithAddress(addressList ...string) Option
  • func WithCodec(name string) Option
  • func WithContext(ctx context.Context) Option
  • func WithContextAndValue(k, v interface{}) Option
  • func WithEnableSecure(enable bool) Option
  • func WithErrorHandler(handler Handler) Option
  • func WithGlobalPropagator() Option
  • func WithGlobalTracerProvider() Option
  • func WithPropagator(propagators propagation.TextMapPropagator) Option
  • func WithTLSConfig(config *tls.Config) Option
  • func WithTracerProvider(provider trace.TracerProvider, tracerName string) Option
• type Options
  • func NewOptions() Options
  • func NewOptionsAndApply(opts ...Option) Options
  • func (o *Options) Apply(opts ...Option)
• type PublishOption
  • func WithPublishContext(ctx context.Context) PublishOption
  • func WithPublishContextAndValue(k, v interface{}) PublishOption
• type PublishOptions
  • func NewPublishOptions(opts ...PublishOption) PublishOptions
  • func (o *PublishOptions) Apply(opts ...PublishOption)
• type SubscribeOption
  • func DisableAutoAck() SubscribeOption
  • func WithQueueName(name string) SubscribeOption
  • func WithSubscribeContext(ctx context.Context) SubscribeOption
  • func WithSubscribeContextAndValue(k, v interface{}) SubscribeOption
• type SubscribeOptions
  • func NewSubscribeOptions(opts ...SubscribeOption) SubscribeOptions
  • func (o *SubscribeOptions) Apply(opts ...SubscribeOption)
• type Subscriber
  • func Subscribe[T any](broker Broker, topic string, ...) (Subscriber, error)
• type SubscriberMap
• type SubscriberSyncMap
  • func NewSubscriberSyncMap() *SubscriberSyncMap
  • func (sm *SubscriberSyncMap) Add(topic string, sub Subscriber)
  • func (sm *SubscriberSyncMap) Clear()
  • func (sm *SubscriberSyncMap) ForceClear()
  • func (sm *SubscriberSyncMap) Foreach(fnc func(topic string, sub Subscriber))
  • func (sm *SubscriberSyncMap) Get(topic string) Subscriber
  • func (sm *SubscriberSyncMap) Remove(topic string) error

Variables

var (
	DefaultCodec encoding.Codec = nil
)

Functions

func Marshal

func Marshal(codec encoding.Codec, msg Any) ([]byte, error)

func Unmarshal

func Unmarshal(codec encoding.Codec, inputData []byte, outValue interface{}) error

Types

type Any

type Any interface{}

type Binder

type Binder func() Any

type Broker

type Broker interface {
	Name() string

	Options() Options

	Address() string

	Init(...Option) error

	Connect() error

	Disconnect() error

	Publish(ctx context.Context, topic string, msg Any, opts ...PublishOption) error

	Subscribe(topic string, handler Handler, binder Binder, opts ...SubscribeOption) (Subscriber, error)
}

type Event

type Event interface {
	Topic() string

	Message() *Message
	RawMessage() interface{}

	Ack() error

	Error() error
}

type Handler

type Handler func(ctx context.Context, evt Event) error

type Headers

type Headers map[string]string

type Message

type Message struct {
	Headers Headers
	Body    Any
}

func (Message) GetHeader

func (m Message) GetHeader(key string) string

func (Message) GetHeaders

func (m Message) GetHeaders() Headers

type Option

type Option func(*Options)

func WithAddress

func WithAddress(addressList ...string) Option

WithAddress set broker address

func WithCodec

func WithCodec(name string) Option

WithCodec set codec, support: json, proto.

func WithContext

func WithContext(ctx context.Context) Option

func WithContextAndValue

func WithContextAndValue(k, v interface{}) Option

func WithEnableSecure

func WithEnableSecure(enable bool) Option

func WithErrorHandler

func WithErrorHandler(handler Handler) Option

func WithGlobalPropagator

func WithGlobalPropagator() Option

func WithGlobalTracerProvider

func WithGlobalTracerProvider() Option

func WithPropagator

func WithPropagator(propagators propagation.TextMapPropagator) Option

func WithTLSConfig

func WithTLSConfig(config *tls.Config) Option

func WithTracerProvider

func WithTracerProvider(provider trace.TracerProvider, tracerName string) Option

type Options

type Options struct {
	Addrs []string

	Codec encoding.Codec

	ErrorHandler Handler

	Secure    bool
	TLSConfig *tls.Config

	Context context.Context

	Tracings []tracing.Option
}

func NewOptions

func NewOptions() Options

func NewOptionsAndApply

func NewOptionsAndApply(opts ...Option) Options

func (*Options) Apply

func (o *Options) Apply(opts ...Option)

type PublishOption

type PublishOption func(*PublishOptions)

func WithPublishContext

func WithPublishContext(ctx context.Context) PublishOption

func WithPublishContextAndValue

func WithPublishContextAndValue(k, v interface{}) PublishOption

type PublishOptions

type PublishOptions struct {
	Context context.Context
}

func NewPublishOptions

func NewPublishOptions(opts ...PublishOption) PublishOptions

func (*PublishOptions) Apply

func (o *PublishOptions) Apply(opts ...PublishOption)

type SubscribeOption

type SubscribeOption func(*SubscribeOptions)

func DisableAutoAck

func DisableAutoAck() SubscribeOption

func WithQueueName

func WithQueueName(name string) SubscribeOption

func WithSubscribeContext

func WithSubscribeContext(ctx context.Context) SubscribeOption

func WithSubscribeContextAndValue

func WithSubscribeContextAndValue(k, v interface{}) SubscribeOption

type SubscribeOptions

type SubscribeOptions struct {
	AutoAck bool
	Queue   string
	Context context.Context
}

func NewSubscribeOptions

func NewSubscribeOptions(opts ...SubscribeOption) SubscribeOptions

func (*SubscribeOptions) Apply

func (o *SubscribeOptions) Apply(opts ...SubscribeOption)

type Subscriber

type Subscriber interface {
	Options() SubscribeOptions
	Topic() string
	Unsubscribe() error
}

func Subscribe

func Subscribe[T any](broker Broker, topic string, handler func(context.Context, string, Headers, *T) error, opts ...SubscribeOption) (Subscriber, error)

type SubscriberMap

type SubscriberMap map[string]Subscriber

type SubscriberSyncMap

type SubscriberSyncMap struct {
	sync.RWMutex
	// contains filtered or unexported fields
}

func NewSubscriberSyncMap

func NewSubscriberSyncMap() *SubscriberSyncMap

func (*SubscriberSyncMap) Add

func (sm *SubscriberSyncMap) Add(topic string, sub Subscriber)

func (*SubscriberSyncMap) Clear

func (sm *SubscriberSyncMap) Clear()

func (*SubscriberSyncMap) ForceClear

func (sm *SubscriberSyncMap) ForceClear()

func (*SubscriberSyncMap) Foreach

func (sm *SubscriberSyncMap) Foreach(fnc func(topic string, sub Subscriber))

func (*SubscriberSyncMap) Get

func (sm *SubscriberSyncMap) Get(topic string) Subscriber

func (*SubscriberSyncMap) Remove

func (sm *SubscriberSyncMap) Remove(topic string) error