详解Go语言中的监视器模式与配置热更新

来自:网络
时间:2024-06-07
阅读:

上篇介绍 GO 的 GUI 库 Fyne 时,提到 Fyne 的数据绑定用到了监听器模式。本文就展开说下我对 Go 中监听器模式的理解和应用吧。

监听器模式简介

监听器模式,或称观察者模式,它主要涉及两个组件:主题(Subject)和监听器(Listener)。

Subject 负责维护一系列的监听器,在所观测主题状态变化,将这个事件通知给所有注册的监听器。我统一将其定义为注册中心 Registry。而监听器 Listener 则是实现了特定接口的对象,用于响应事件消息,执行处理逻辑。

详解Go语言中的监视器模式与配置热更新

对具体应用而言,通常还会分出一个 Watcher 或者 Monitor 用于检测变化并推送给 Registry。从而实现将检测目标从系统解耦,无视监控组件类别。

这个模式在组件之间建立一种松散耦合的关系。将特定事件通知到关心它的其他组件,无需它们直接相互引用。看起来这个不也是发布-订阅模式吗?差不多一个意思。

之前工作中,用它最多的是配置的热更新场景,这篇文章也会简单介绍基于它的 ETCD 配置热更新。

Go 实现监听器模式

如何用 Go 实现监听模式?我将定义两个新类型分别是注册中心(Registry)和监听器接口(Listener)。

首先是 Listener,它是一个接口,用于实现事件的响应逻辑。

type Listener interface {
    OnTrigger()
}

先将其定义为一个接口,它的实现类型要求支持 OnTrigger 方法,会在事件发生时被执行。

type Registry struct {
    listeners []Listener
}

func (r *Registry) Register(l Listener) {
    r.listeners = append(r.listeners, l)
}

func (r *Registry) NotifyAll() {
    for _, listener := range r.listeners {
        listener.OnTrigger(key, value)
    }
}

Registry 是所有监听器的注册地,当特定事件发生,我们通过 Registry.NotifyAll 将事件传递给所有 Listener

我们实现一个简单的案例,当监听到某个事件发生,打印 "A specified event accured"。

为了模拟效果,本案例没有 watcher,直接通过主函数调用 NotifyAll 模拟触发事件。

为了打印事件消息,我们实现 Listener接口,创建新类型 EventPrinter,如下所示:

type EventPrinter struct {
}

func (printer *EventPrinter) OnTrigger() {
  fmt.Println("A specified event accured!")
}

写个主函数触发下事件,测试看看是否符合预期,代码如下所示:

func main() {
  r := &Registry{}
  r.Reigster(&EventPrinter{})

  // 模拟接收到消息,触发事件通知
  r.NotifyAll()
}

执行测试,内容如下所示:

$ go run main.go
A specified event occurred

如果希望自定义处理函数,只需让 Listener 支持自定义事件回调函数即可。

修改代码如下所示:

type EventHandler struct {
  callback func()
}

func NewEventHandler(callback func()) *EventHandler {
  return &EventHandler{callback: callback}
}
func (e *EventHandler) OnTrigger() {
  e.callback()
}

我们注册一个 EventHandler 到 Registry,主函数代码:

func main() {
  r := &Registry{}
  r.Reigster(&EventPrinter{})
  r.Reigster(NewEventHandler(func() {
    fmt.Println("Custom Print: a specified event occurred!")  
  }))
  r.NotifyAll()
}

测试执行:

$ go run main.go
A specified event occurred!
Custom Print: a specified event occurred!

基于 Go Channel 实现并发处理

前面的示例中 NotifyAll 是通过 for 循环依次调用 listener.OnTrigger 将消息发送给 Listener,处理效率低下。

如何加速呢?

最直接的方法是通过 goroutine 运行 listener.OnTrigger 方法。

func (r *Registry) NotifyAll() {
  for _, listener := range r.listeners {
      go listener.OnTrigger()
  }
}

还有一种方法,通过 Channel 传递事件消息,这样每个 Listener 有独立的 goroutine 监听和处理。

如下是 Listener 的实现代码:

type Listener struct {
    EventChannel chan struct{}
    Callback     func()
}

func NewListener(callback func()) *Listener {
    return &Listener{
        EventChannel: make(chan struct{}, 1), // 带缓冲的 channel,防止阻塞
        Callback:     callback,
    }
}

func (l *Listener) Start() {
    go func() {
        for range l.EventChannel {
            l.Callback()
        }
    }()
}

这里 Listener 的事件处理函数在单独的 goroutine 中运行。而相应的 Registry 实现也需要修改,代码变更如下所示:

type Registry struct {
    listeners []*Listener
}

func (r *Registry) Register(listener *Listener) {
    r.listeners = append(r.listeners, listener)
    listener.Start() // 启动监听器的 goroutine
}

func (r *Registry) NotifyAll(message string) {
    for _, listener := range r.listeners {
        listener.EventChannel <- struct{}{} // 发送事件到监听器
    }
}

func (r *Registry) Close() {
    for _, listener := range r.listeners {
        close(listener.EventChannel) // 关闭 channel,停止监听器 goroutine
    }
}

整体上的变化不大,在 listner.Register 方法中启动 Listener 事件处理 goroutine 等待事件消息。

实际案例:ETCD 配置热更新

让我们实践一个具体的应用场景:实现配置的动态更新以及组件的自动重连机制。

我们将针对包括 MySQL、Redis 在内的各种组件,实现它们在配置变更时能够自动重连。这些组件的配置信息将以 JSON 格式存储于 ETCD 的多个键(Key)中。

假设,配置结构如下所示:

type MySQLConfig struct {
  Host     string
  Port     int
  User     string
  Password string
}

type RedisConfig struct {
  Host     string
  Port     int
}

这些配置被保存在 ETCD 中,我们要实时监控配置的变化并据此更新配置和执行重连操作。

示例用法如下所示:

registry.Register("/config/mysql", func(data) {
  // unmarshal data
  // reconnect mysql
})

让我们基于监听器模式简单设计一个模块,实现 ETCD 热更新:

  • 每个监听器可以订阅特定的 key 或 key 前缀的更新事件。
  • 使用 channel 通知配置变更,触发对应的监听回调。

这个示例,函数回调和轮询其实已经满足需求,此处只是为了演示,而是否使用 channel 要具体分析。

我们这个设计要涉及到三个部分。分别是 Watcher、Listener 和 Registry。

  • Watcher 责监听 ETCD 中的 key 变更事件。
  • Listener 定义了当特定 key 发生变化时需要执行的回调逻辑。
  • Registry 管理所有 Listener,将 ETCD 变更事件分发给对应 Listener。

先定义 Event 类型,一个简单的结构体,表示 ETCD 中 key 的变更事件:

type Event struct {
  Key   string
  Value string
}

Listener

Listener 实现如下所示:

type Listener struct {
    EventChannel chan *Event
    Callback     func(*Event)
}

func NewListner(callback func(*Event)) *Listener {
    l := &Listener{
        EventChannel: make(chan *Event),
        Callback:     callback,
    }
    return l
}

func (l *Listener) Start() {
    go func() {
        for event := range l.EventChannel {
            l.Callback(event)
        }
    }()
}

基本之前的没太大差别,从 EventChannel 中拿到事件消息,调用回调函数。

实现 Registry

Registry 负责维护 Listener 的注册,并在接收到 key 变更事件时通知相关的 Listener

type Registry struct {
    listeners map[string][]*Listener
}

func NewRegistry() *Registry {
    return &Registry{
        listeners: make(map[string][]*Listener),
    }
}

func (r *Registry) Register(key string, listener *Listener) {
    r.listeners[key] = append(r.listeners[key], listener)
    listener.Start()
}

func (r *Registry) Notify(event *Event) {
    if listeners, ok := r.listeners[event.Key]; ok {
        for _, listener := range listeners {
            listener.EventChannel <- event
        }
    }
}

注册 Listener 到 Registry 中,通过 map 将 key 与 Listener 关联起来。

实现 Watcher

Watcher 负责从 ETCD 订阅 key 的变更事件,并将这些事件发送到 Registry 的 eventChannel 上:

func WatchEtcdKeys(client *clientv3.Client, registry *Registry, watchKeys ...string) {
  for _, key := range watchKeys {
    go func(key string) {
      watchChan := client.Watch(context.Background(), key, clientv3.WithPrefix())
      for wresp := range watchChan {
        for _, ev := range wresp.Events {
          event := &Event{
            Key:   string(ev.Kv.Key),
            Value: string(ev.Kv.Value),
          }
          registry.Notify(event)
        }
      }
    }(key)
  }
}

使用示例

让我们实际在 main 函数上使用一下,观察行为是否正常。

func main() {
  client, err := clientv3.New(clientv3.Config{
      Endpoints:   []string{"localhost:2379"},
  })
  if err != nil {
      log.Fatal(err)
  }
  defer client.Close()

  registry := NewRegistry()
  // 注册监听器
  registry.Register("/config/mysql", NewListener(func(event * Event) {
    fmt.Println(event)
    // 执行数据重连之类的操作
  }))

  // 开始监听 ETCD key 变更
  WatchEtcdKeys(client, registry, "/config/")
  time.Sleep(10 * time.Minute)
}

这个示例创建了一个 ETCD 客户端,初始化了一个 Registry,并为特定的 key 注册了一个 Listener。然后,通过 WatchEtcdKeys 函数开始监听 /config/ 前缀下的所有 key 的变更。

这种设计支持对特定 key 或 key 前缀的监听。当相关 key 变更时,通过 channel 通知 Listener,而收到更新事件后的具体操作。视场景而定,这里是执行重连操作。

特别说明,示例仅作为概念验证,实际应用中需要更多的错误处理和优化。

返回顶部
顶部