Akka 2.5.11 Cluster Client 集群客户端

ClusterClient是一个集群客户端,主要用于集群外部系统与集群通信,只需要知道一个集群中的节点作为初始的联络点。就可将这个节点注册为该集群的接待员(receptionist  actor),通过这个接待员我们就可以在外部系统建立通信了。ClusterClient会监视与接待员的连接,如果连接故障了,它会建立一条新的连接。当查找一个新的接待员时,它会从之前的建立的节点中获取新的联络点,或者周期性的刷新联络点。所以联络点不一定是初始联络点。

当你使用集群客户端时,必须要更改akka.actor.provider,将local改为remotecluster。

    接待员在集群中所有的节点上启动。接待员可以是 ClusterReceptionist 扩展的也可以是一个普通的actor 。

集群中的actor需要在mediator中注册,然后Cluster Client就可以通过 集群中的接待员 来访问mediator的注册表中的任何actor。

在Cluster Client中也有一个集群客户端接待员ClusterClientReceptionist  将客户端能访问到的节点注册到列表中。就像mediator一样 ClusterClient 和 ClusterClientReceptionist 之间发送的事件可以订阅。    订阅发送消息的类型有三种

①.ClusterClient.Send 

将消息发送至任意一节点

②.ClusterClient.SendToAll

消息将会发给集群中的所有匹配path的节点

③.ClusterClient.Publish

将消息发送给订阅了某个主题的所有actor


接待员打开专门的通道让目标actor的响应消息发送到客户端。可以避免其他集群中的节点干扰

因为客户端通常应该通过ClusterClient发送后续消息。如果客户端直接联系集群中的actor,那actor的回复可以发送到原始发送方。

消息缓冲:当向新接待员建立连接时,ClusterClient会缓冲消息,等连接建立完成后再发送消息。如果缓存满了ClusterClient会将旧的消息抛弃。可以通过配置来改变缓冲区的大小,0代表禁用。(具体配置见下文- 配置)

防止消息丢失:为了防止消息丢失客户端actor和目标actor之间也要保证 at-least-once message delivery(至少一次通信)。

一个集群客户端示例:

 首先在集群中的节点启动接待员,配置扩展属性。

akka.extensions = ["akka.cluster.client.ClusterClientReceptionist"]

ClusterClientReceptionist 使用 DistributedPubSub扩展)

然后在ClusterClientReceptionist中注册客户端可用的actor

在客户端,创建ClusterClient actor 并向集群中的某个地方发送识别消息。

上面代码中initialContacts参数是Set[ActorPath],可以这样配置


事件

上文说道ClusterClient 和 ClusterClientReceptionist 之间发送的事件可以订阅,因此有一个actor来接收(contact points)可用接待员的地址。

同样地,我们还要创建一个actor来接收与ClusterClientReceptionist连接的cluster client

依赖

使用Cluster Client要添加以下依赖

"com.typesafe.akka" %% "akka-cluster-tools" % "2.5.11"

配置

配置 ClusterClientReceptionist扩展


配置ClusterClient

配置中看到当集群客户端启动时,必须提供一个初始联系列表,该列表是接待员正在运行的集群节点。然后,它会重复地尝试联系那些直到它与其中一个的联系成功。(上文配置中establishing-get-contacts-interval)。 在运行时,通过来自Receptionist的数据联系列表会不断地更新。(上文配置中 refresh-contacts-interval )

当客户端正在运行时,它会检测到与receptionist 的连接失败,如果超过了可配置的心跳次数,客户将尝试重新连接到它已知的联系列表,以找到它可以访问的接待员。

reconnect-timeout配置时间间隔,在超过规定时间间隔中客户端找到一个receptionist 连接到集群时,cluster client将被停止。在新地址上重新启动,然后通过访问某种服务注册中心来更新一组初始联系人,从而启动一个新的集群客户端。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念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

推荐阅读更多精彩内容