broker

Documentation

Index

• Constants
• func EncodeSessionToken(signKey string, session sessions.Session) (string, error)
• func Serve(port int, handler broker) net.Listener
• type Broker
  • func New(id string, logger *zap.Logger, mesh cluster.Mesh, config Config) *Broker
  • func (b *Broker) Authenticate(transport transport.Metadata, sessionID []byte, username string, ...) (tenant string, err error)
  • func (b *Broker) CloseSession(ctx context.Context, token string) error
  • func (b *Broker) Connect(ctx context.Context, metadata transport.Metadata, p *packet.Connect) (string, string, *packet.ConnAck, error)
  • func (b *Broker) Disconnect(ctx context.Context, token string, p *packet.Disconnect) error
  • func (b *Broker) DistributeMessage(message *pb.MessagePublished) error
  • func (b *Broker) Health() string
  • func (b *Broker) JoinServiceLayer(layer types.ServiceLayer)
  • func (b *Broker) ListRetainedMessages() (topics.RetainedMessageSet, error)
  • func (b *Broker) ListSessions() (sessions.SessionSet, error)
  • func (b *Broker) ListSubscriptions() (subscriptions.SubscriptionSet, error)
  • func (b *Broker) PingReq(ctx context.Context, id string, _ *packet.PingReq) (*packet.PingResp, error)
  • func (b *Broker) Publish(ctx context.Context, token string, p *packet.Publish) (*packet.PubAck, error)
  • func (b *Broker) RemoteRPCProvider(id, peer string) sessions.Transport
  • func (b *Broker) Serve(port int) net.Listener
  • func (b *Broker) Shutdown()
  • func (b *Broker) SigningKey() string
  • func (broker *Broker) Start(layer types.ServiceLayer)
  • func (b *Broker) Stop()
  • func (b *Broker) Subscribe(ctx context.Context, token string, p *packet.Subscribe) (*packet.SubAck, error)
  • func (b *Broker) Unsubscribe(ctx context.Context, token string, p *packet.Unsubscribe) (*packet.UnsubAck, error)
• type Config
  • func DefaultConfig() Config
• type PeerStore
• type Queue
• type SessionConfig
• type SessionStore
• type SubscriptionStore
• type Token
  • func DecodeSessionToken(signKey string, signedToken string) (Token, error)
• type TopicStore

Constants

const (
	EVENT_MESSAGE_PUBLISHED = "message_published"
	EVENT_STATE_UPDATED     = "state_updated"
)

Functions

func EncodeSessionToken

func EncodeSessionToken(signKey string, session sessions.Session) (string, error)

func Serve

func Serve(port int, handler broker) net.Listener

Types

type Broker

type Broker struct {
	ID string

	Subscriptions SubscriptionStore
	Sessions      SessionStore
	Topics        TopicStore
	Peers         PeerStore
	// contains filtered or unexported fields
}

func New

func New(id string, logger *zap.Logger, mesh cluster.Mesh, config Config) *Broker

func (*Broker) Authenticate

func (b *Broker) Authenticate(transport transport.Metadata, sessionID []byte, username string, password string) (tenant string, err error)

func (*Broker) CloseSession

func (b *Broker) CloseSession(ctx context.Context, token string) error

func (*Broker) Connect

func (b *Broker) Connect(ctx context.Context, metadata transport.Metadata, p *packet.Connect) (string, string, *packet.ConnAck, error)

func (*Broker) Disconnect

func (b *Broker) Disconnect(ctx context.Context, token string, p *packet.Disconnect) error

func (*Broker) DistributeMessage

func (b *Broker) DistributeMessage(message *pb.MessagePublished) error

func (*Broker) Health

func (b *Broker) Health() string

func (*Broker) JoinServiceLayer

func (b *Broker) JoinServiceLayer(layer types.ServiceLayer)

func (*Broker) ListRetainedMessages

func (b *Broker) ListRetainedMessages() (topics.RetainedMessageSet, error)

func (*Broker) ListSessions

func (b *Broker) ListSessions() (sessions.SessionSet, error)

func (*Broker) ListSubscriptions

func (b *Broker) ListSubscriptions() (subscriptions.SubscriptionSet, error)

func (*Broker) PingReq

func (b *Broker) PingReq(ctx context.Context, id string, _ *packet.PingReq) (*packet.PingResp, error)

func (*Broker) Publish

func (b *Broker) Publish(ctx context.Context, token string, p *packet.Publish) (*packet.PubAck, error)

func (*Broker) RemoteRPCProvider

func (b *Broker) RemoteRPCProvider(id, peer string) sessions.Transport

func (*Broker) Serve

func (b *Broker) Serve(port int) net.Listener

func (*Broker) Shutdown

func (b *Broker) Shutdown()

func (*Broker) SigningKey

func (b *Broker) SigningKey() string

func (*Broker) Start

func (broker *Broker) Start(layer types.ServiceLayer)

func (*Broker) Stop

func (b *Broker) Stop()

func (*Broker) Subscribe

func (b *Broker) Subscribe(ctx context.Context, token string, p *packet.Subscribe) (*packet.SubAck, error)

func (*Broker) Unsubscribe

func (b *Broker) Unsubscribe(ctx context.Context, token string, p *packet.Unsubscribe) (*packet.UnsubAck, error)

type Config

type Config struct {
	AuthHelper func(transport transport.Metadata, sessionID []byte, username string, password string) (tenant string, err error)
	Session    SessionConfig
}

func DefaultConfig

func DefaultConfig() Config

type PeerStore

type PeerStore interface {
	ByID(id string) (peers.Peer, error)
	All() (peers.SubscriptionSet, error)
	Delete(id string) error
	On(event string, handler func(peers.Peer)) func()
}

type Queue

type Queue interface {
	Enqueue(p *publishQueue.Message)
	Consume(f func(*publishQueue.Message))
	Close() error
}

type SessionConfig

type SessionConfig struct {
	MaxInflightSize int
}

type SessionStore

type SessionStore interface {
	ByID(id string) (sessions.Session, error)
	ByClientID(id string) (sessions.SessionSet, error)
	ByPeer(peer string) (sessions.SessionSet, error)
	All() (sessions.SessionSet, error)
	Exists(id string) bool
	Upsert(sess sessions.Session, transport sessions.Transport) error
	Delete(id, reason string) error
}

type SubscriptionStore

type SubscriptionStore interface {
	ByTopic(tenant string, pattern []byte) (subscriptions.SubscriptionSet, error)
	ByID(id string) (subscriptions.Subscription, error)
	All() (subscriptions.SubscriptionSet, error)
	ByPeer(peer string) (subscriptions.SubscriptionSet, error)
	BySession(id string) (subscriptions.SubscriptionSet, error)
	Sessions() ([]string, error)
	Create(message subscriptions.Subscription, sender func(context.Context, packet.Publish) error) error
	Delete(id string) error
}

type Token

type Token struct {
	SessionID     string `json:"session_id"`
	PeerID        string `json:"peer_id"`
	SessionTenant string `json:"session_tenant"`
	jwt.StandardClaims
}

func DecodeSessionToken

func DecodeSessionToken(signKey string, signedToken string) (Token, error)

type TopicStore

type TopicStore interface {
	Create(message topics.RetainedMessage) error
	ByTopicPattern(tenant string, pattern []byte) (topics.RetainedMessageSet, error)
	All() (topics.RetainedMessageSet, error)
}