142 lines
3.2 KiB
Go
142 lines
3.2 KiB
Go
package gubgub
|
|
|
|
import (
|
|
"fmt"
|
|
"sync"
|
|
)
|
|
|
|
// AsyncTopic allows any message T to be broadcast to subscribers. Publishing as well as
|
|
// subscribing happens asynchronously.
|
|
// This guarantees that every published message will be delivered but does NOT guarantee delivery
|
|
// order.
|
|
// In the unlikely scenario where subscribers are being queued very aggressively it is possible
|
|
// that some might never actually receive any message. Subscriber registration order is also not
|
|
// guaranteed.
|
|
type AsyncTopic[T any] struct {
|
|
options TopicOptions
|
|
|
|
mu sync.RWMutex
|
|
closing bool
|
|
closed chan struct{}
|
|
|
|
publishCh chan T
|
|
subscribeCh chan Subscriber[T]
|
|
}
|
|
|
|
// NewAsyncTopic creates an AsyncTopic that will be closed when the given context is cancelled.
|
|
// After closed calls to Publish or Subscribe will return an error.
|
|
func NewAsyncTopic[T any](opts ...TopicOption) *AsyncTopic[T] {
|
|
options := TopicOptions{
|
|
onClose: func() {}, // Called after the Topic is closed and all messages have been delivered.
|
|
onSubscribe: func(count int) {}, // Called everytime a new subscriber is added
|
|
}
|
|
|
|
for _, opt := range opts {
|
|
opt(&options)
|
|
}
|
|
|
|
t := AsyncTopic[T]{
|
|
options: options,
|
|
closed: make(chan struct{}),
|
|
publishCh: make(chan T, 1),
|
|
subscribeCh: make(chan Subscriber[T], 1),
|
|
}
|
|
|
|
go t.run()
|
|
|
|
return &t
|
|
}
|
|
|
|
// Close terminates background go routines and prevents further publishing and subscribing. All
|
|
// published messages are garanteed to be delivered once Close returns. This is idempotent.
|
|
func (t *AsyncTopic[T]) Close() {
|
|
t.mu.RLock()
|
|
closing := t.closing
|
|
t.mu.RUnlock()
|
|
|
|
if closing {
|
|
// It's either already closed or it's closing.
|
|
return
|
|
}
|
|
|
|
t.mu.Lock()
|
|
t.closing = true // no more subscribing or publishing
|
|
t.mu.Unlock()
|
|
|
|
close(t.publishCh)
|
|
close(t.subscribeCh)
|
|
|
|
<-t.closed
|
|
}
|
|
|
|
func (t *AsyncTopic[T]) run() {
|
|
defer close(t.closed)
|
|
defer t.options.onClose()
|
|
|
|
var subscribers []Subscriber[T]
|
|
|
|
defer func() {
|
|
// There is only one way to get here: the topic is now closing!
|
|
// Because both `subscribeCh` and `publishCh` channels are closed when the topic is closed
|
|
// this will always eventually return.
|
|
// This will deliver any potential queued message thus fulfilling the message delivery
|
|
// promise.
|
|
for msg := range t.publishCh {
|
|
subscribers = sequentialDelivery(msg, subscribers)
|
|
}
|
|
}()
|
|
|
|
for {
|
|
select {
|
|
case newCallback, more := <-t.subscribeCh:
|
|
if !more {
|
|
return
|
|
}
|
|
|
|
subscribers = append(subscribers, newCallback)
|
|
t.options.onSubscribe(len(subscribers))
|
|
|
|
case msg, more := <-t.publishCh:
|
|
if !more {
|
|
return
|
|
}
|
|
|
|
subscribers = sequentialDelivery(msg, subscribers)
|
|
}
|
|
}
|
|
}
|
|
|
|
// Publish broadcasts a msg to all subscribers.
|
|
func (t *AsyncTopic[T]) Publish(msg T) error {
|
|
t.mu.RLock()
|
|
|
|
if t.closing {
|
|
t.mu.RUnlock()
|
|
return fmt.Errorf("async topic publish: %w", ErrTopicClosed)
|
|
}
|
|
|
|
go func() {
|
|
t.publishCh <- msg
|
|
t.mu.RUnlock()
|
|
}()
|
|
|
|
return nil
|
|
}
|
|
|
|
// Subscribe adds a Subscriber func that will consume future published messages.
|
|
func (t *AsyncTopic[T]) Subscribe(fn Subscriber[T]) error {
|
|
t.mu.RLock()
|
|
|
|
if t.closing {
|
|
t.mu.RUnlock()
|
|
return fmt.Errorf("async topic subscribe: %w", ErrTopicClosed)
|
|
}
|
|
|
|
go func() {
|
|
t.subscribeCh <- fn
|
|
t.mu.RUnlock()
|
|
}()
|
|
|
|
return nil
|
|
}
|