hub

README

hub

Documentation

Overview

Package hub provides a simple event dispatcher for publish/subscribe pattern.

Example

package main

import (
	"fmt"
)

// Different event kinds
const (
	happenedA = iota
	happenedB
	happenedC
)

// Our custom event type
type EventA struct {
	arg1, arg2 int
}

// Implement hub.Event interface
func (e EventA) Kind() int { return happenedA }

func main() {
	Subscribe(happenedA, func(e Event) {
		a := e.(EventA) // Cast to concrete type
		fmt.Println(a.arg1 + a.arg2)
	})

	Publish(EventA{2, 3})
}

Output:
5

Index

• Variables
• func Publish(e Event)
• func Subscribe(kind int, handler func(Event))
• type Event
• type Hub
  • func New() *Hub
  • func (h *Hub) Publish(e Event)
  • func (h *Hub) Subscribe(kind int, handler func(Event))

Examples

• Package

Variables

var DefaultHub = New()

DefaultHub is the default Hub used by Publish and Subscribe.

Functions

func Publish

func Publish(e Event)

Publish an event to the subscribers in DefaultHub.

func Subscribe

func Subscribe(kind int, handler func(Event))

Subscribe registers the handler for the event of a specific kind in the DefaultHub.

Types

type Event

type Event interface {
	Kind() int
}

Event is an interface for published events.

type Hub

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

Hub is an event dispatcher, publishes events to the subscribers which are subscribed for a specific event type.

func New

func New() *Hub

New returns pointer to a new Hub.

func (*Hub) Publish

func (h *Hub) Publish(e Event)

Publish an event to the subscribers.

func (*Hub) Subscribe

func (h *Hub) Subscribe(kind int, handler func(Event))

Subscribe registers the handler for the event of a specific kind.