Apollo 4 — 客户端 SDK 设计

前言

之前聊了客户端的一些功能,例如融入 Spring, @value 注解的自动刷新实现,长轮询等,这次从客户端的整体设计来聊聊。

设计

上图是 client 项目的包结构。

其中,核心包就是 internals 包,包含了客户端的主要功能逻辑。主要有以下功能:

  1. 获取 ConfigService 服务的远程配置。
  2. 长轮询/定时轮询 ConfigService。
  3. 监听机制——更新后,立即通知应用程序。
  4. 兼容 Spring 各个版本(这个是在 spring 包中,但我认为也算重要功能 ^_^)。
首先说第一个功能:获取 ConfigService 服务的远程配置

实现此功能的类为:RemoteConfigRepository。该类有以下几个重要的方法:


  1. 构造方法:该方法里包含了很多初始化的过程,虽然我觉得应该放在 init 之类的方法中
  2. getConfig() 根据 namespace 获取配置
  3. onLongPollNotified() 当收到长连接通知时触发响应
  4. addChangeListener() 添加监听器
  5. removeChangeListener() 删除监听器

注意:setUpstreamRepository 是空的。看注释,是个 fallback 设计。

其中,getConfig 方法是获取这个 namespace 的配置,返回的是 Properties 对象(就是个 Map)。然后,从这个对象中取出对应的值,就 ok 了。

第二个功能:长轮询/定时轮询 ConfigService。

这个功能的主要实现类是:RemoteConfigLongPollService。

该类主要的方法有 2 个,构造方法和 submit 方法。注意,这个类是单例的(由 google 的 inject 实现)。
构造方法中,做了很多的初始化工作。而 submit 方法则是开启长轮询,轮询的方式是:携带 AppId 去请求 ConfigServcie,得到所有的 namespace 更新通知,然后通知对应的 RemoteConfigRepository 去请求真正的数据。大概的设计如下图:

image.png

每一个 namespace 在一个应用中,都对应一个 RemoteConfigRepository,所有的 RemoteConfigRepository 都归属 RemoteConfigLongPollService 长轮询服务管理,当长轮询得到通知,便通知对应的 RemoteConfigRepository 进行服务请求以便执行更新本地缓存和通知监听器操作。

通知,作为 fallback 方案—— 定时轮询也充当了长轮询失效的最后屏障。

第三个功能:监听机制——更新后,立即通知应用程序。

从上图可以看出,轮询之后,如果有更新响应,则立即通知 RemoteConfigRepository,然后,RemoteConfigRepository 再次从配置中心拉取配置,从而更新本地 Config 对象的内容。

更新完毕后,则通知 Config 的“配置变化监听器”。也就是 ConfigChangeListener 的 onChange 方法。这个监听器是监听 Config 对象的。

实际上,每个 Config 对象在初始化的时候,都会往 RemoteConfigRepository 对象里添加一个监听器,实际上就是添加自己。

当 RemoteConfigRepository 发生变化的时候,触发 onRepositoryChange 方法,onRepositoryChange 又会触发 onChange 方法。大概的设计图就是下面这个样子:

上图中,紫色的 DefaultConfig 是核心,他依赖了 RemoteConfigRepository, 而 RemoteConfigRepository 反过来组合了他,同时 DefaultConfig 也聚合了用户实现的监听器 ConfigChangeListener 的子类。

那么,当远程 Repository 变化的时候,就可以通知 Client 的缓存 Config 对象,而 Config 缓存对象变化的时候,就可以通知用户的程序(监听器)。实现整体的监听机制。

总的来说,就是通过两层监听机制来实现的。其中 DefaultConfig 实现了两个角色,既是观察者,也是被观察者。

第四个功能:兼容 Spring 各个版本

首先,如果没有这个功能,Apollo 也会能够正常运行的,不过,你只能使用 API 的方式,不能使用注解,标签等 Spring 应用熟悉的方式。

如果想用 Spring 的方式使用 Apollo ,那么就得遵守 Spring 的约定,实现 Spring 的接口,将自己融入到 Spring 中。

其中,主要解决的问题就是,如何在 Spring 初始化的时候,Apollo 也初始化?这点我们在之前的文章中说了,也就是 Spring 的 3 个入口。在这些入口里初始化。

另外,将配置放置到 Spring 的环境中,也是一个工作,因为,如果不放到环境中,Spring 初始时需要的那些参数就无法取到了。

所以,要将 Config 对象包装成 Spring 熟悉的 ConfigPropertySource 对象,算是一个适配器模式吧。

在初始化配置的时候,会从远程配置中心拿到配置,包装成 ConfigPropertySource 对象,再利用 CompositePropertySource 组合属性配置(多个 namespace)聚合所有 Config 对象。

CompositePropertySource 最后会添加到 ConfigurableEnvironment 环境对象中,spring 就可以从这个对象 中取出配置进行初始化。

并且,在 SpringBoot 环境下,Apollo 可以优先加载指定的配置,这些配置在 SpringContext 容器初始化的时候就开始被注入到环境中,这样就可以将一些系统初始化的配置也放到配置中心了,尽量让本地少一点配置。这个功能的启用需要参数:apollo.bootstrap.enabled=true,配置的namespace 则是 apollo.bootstrap.namespaces = XXX

并且,该配置的优先级是最高的,Apollo 将这个配置放在了 Spring 环境对象中的第一个位置,当循环获取配置的时候,优先获取这个配置。

总结

好了,关于 Apollo 客户端的设计,大概就是这些,总体来讲比较简单, 4 个功能:

  1. 获取远程配置
  2. 长轮询/定时轮询
  3. 配置更新监听机制。
  4. 兼容 Spring。

抛出一个问题:

Apollo 似乎没有给用户留扩展接口?如果能像 Spring,Mybatis 一样,留一个或者多个切面给用户,让用户能够在加载配置的时候,做一些事情啥的,或许更好。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,163评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,301评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,089评论 0 352
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,093评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,110评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,079评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,005评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,840评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,278评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,497评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,667评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,394评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,980评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,628评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,796评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,649评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,548评论 2 352

推荐阅读更多精彩内容