eventstream

Documentation

Overview

Package eventstream implements a publisher / subscriber.

Index

• func Publish(event interface{})
• func PublishUnsafe(evt interface{})
• func Unsubscribe(sub *Subscription)
• type EventStream
  • func (es *EventStream) Publish(evt interface{})
  • func (es *EventStream) PublishUnsafe(evt interface{})
  • func (es *EventStream) Subscribe(fn func(evt interface{})) *Subscription
  • func (es *EventStream) Unsubscribe(sub *Subscription)
• type Predicate
• type Subscription
  • func Subscribe(fn func(evt interface{})) *Subscription
  • func (s *Subscription) WithPredicate(p Predicate) *Subscription

Examples

• Subscribe

Functions

func Publish

func Publish(event interface{})

func PublishUnsafe

func PublishUnsafe(evt interface{})

func Unsubscribe

func Unsubscribe(sub *Subscription)

Types

type EventStream

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

func (*EventStream) Publish

func (es *EventStream) Publish(evt interface{})

func (*EventStream) PublishUnsafe

func (es *EventStream) PublishUnsafe(evt interface{})

func (*EventStream) Subscribe

func (es *EventStream) Subscribe(fn func(evt interface{})) *Subscription

func (*EventStream) Unsubscribe

func (es *EventStream) Unsubscribe(sub *Subscription)

type Predicate

type Predicate func(evt interface{}) bool

Predicate is a function used to filter messages before being forwarded to a subscriber

type Subscription

type Subscription struct {
	// contains filtered or unexported fields
}

Subscription is returned from the Subscribe function.

This value and can be passed to Unsubscribe when the observer is no longer interested in receiving messages

func Subscribe

func Subscribe(fn func(evt interface{})) *Subscription

Example

Subscribe subscribes to events

package main

import (
	"fmt"

	"github.com/ChaokunChang/protoactor-go/eventstream"
)

func main() {
	sub := eventstream.Subscribe(func(event interface{}) {
		fmt.Println(event)
	})

	// only allow strings
	sub.WithPredicate(func(evt interface{}) bool {
		_, ok := evt.(string)
		return ok
	})

	eventstream.Publish("Hello World")
	eventstream.Publish(1)

	eventstream.Unsubscribe(sub)

}

Output:

Hello World

func (*Subscription) WithPredicate

func (s *Subscription) WithPredicate(p Predicate) *Subscription

WithPredicate sets a predicate to filter messages passed to the subscriber