[翻译]squbs官网之19 资源解析

鉴于现实生活中极少的应用不使用外部资源,因此环境感知的资源解析称为应用程序基础结构的关键部分。squbs 通过 ResolverRegistry 提供资源解析, 并允许任何类型的资源通过名称和环境来解决。后者允许在生产、qa 和开发环境之间区分资源。

资源解析的示例是 HTTP 端点、消息传递端点和数据库。所有这些都由一个单一的注册中心处理。

依赖

解析器位于squbs-ext。添加如下依赖:

"org.squbs" %% "squbs-ext" % squbsVersion

用法

Resolver 基本用法是查找资源。需要提供一个类型, 因为注册表可以持有多种类型的资源, 如 HTTP 端点、消息端点或数据库连接。本文档中的示例中使用了类型 URI。查找调用,如下所示:

// To resolve a resource for a specific environment.
val resource: Option[URI] = ResolverRegistry(system).resolve[URI]("myservice", QA)

ResolverRegistry

ResolverRegistry是一个Akka扩展,遵循Akka扩展使用模式。它可以托管各种类型的资源解析器,因此必须提供资源类型(在注册时,将资源类型传递给注册器调用)。可以注册相同类型或多个类型的多个解析器。

注册解析器

有两种风格的API用于解析器的注册。一个是快捷 API,允许传入闭包或 lambda 作为解析器。闭包或者lambda的返回类型必须是Option[T]。另一个完整的API使用Resolver [T],T是资源类型。如下所示:

// To register a new resolver for type URI using a closure. Note the return
// type of the closure must be `Option[T]` or in this case `Option[URI]`
ResolverRegistry(system).register[URI]("MyResolver") { (svc, env) =>
  (svc, env) match {
    case ("myservice", QA) => Some(URI.create("http://myservice.qa.mydomain.com"))
    case ("myservice", Default) => Some(URI.create("http://myservice.mydomain.com"))
    case ("myservice2", QA) => Some(URI.create("http://myservice2.qa.mydomain.com"))
    case ("myservice2", Default) => Some(URI.create("http://myservice2.mydomain.com"))
    case _ => None
  }
}

// To register a new resolver for type URI by extending the `Resolver` trait
class MyResolver extends Resolver[URI] {
  def name: String = "MyResolver"

  def resolve(svc: String, env: Environment = Default): Option[URI] = {
    (svc, env) match {
      case ("myservice", QA) => Some(URI.create("http://myservice.qa.mydomain.com"))
      case ("myservice", Default) => Some(URI.create("http://myservice.mydomain.com"))
      case ("myservice2", QA) => Some(URI.create("http://myservice2.qa.mydomain.com"))
      case ("myservice2", Default) => Some(URI.create("http://myservice2.mydomain.com"))
      case _ => None
    }
  }
}

// Then just register the instance
ResolverRegistry(system).register[URI](new MyResolver)

发现链

资源发现遵循后进先出模型。最近注册的解析器优先于以前注册的解析器。ResolverRegistry 沿着链一个一个地遍历,直到有一个解析器与资源所给的类型兼容或者链已搜索到尽头(这种情况下,返回None)。

类型兼容

ResolverRegistry 在解析调用时检查请求的类型。如果注册的解析器的类型是请求类型的同一类型或子类型, 则该解析器将尝试按名称解析资源。

由于JVM类型擦除,注册的类型的类型参数或者请求的类型的类型参数无法考虑。例如,一个注册类型java.util.List<String>会与解析调用的类型java.util.List<Int>相匹配,因为类型参数String或Int运行时擦除了。由于这个限制,非常不推荐含有类型参数的类型用于注册和查找。结果未定义——可能只是由于使用了错误的资源。

为了简单起见,强烈建议不要使用类型层次结构。 所有注册的类型应该是不同的类型。

资源解析

与注册类似, 解析要求类型与注册类型兼容;已注册的类型必须是解析类型的相同或子类型。
// To resolve a resource with Default environment.
val resource: Option[URI] = ResolverRegistry(system).resolveURI

// To resolve a resource for a specific environment.
val resource: Option[URI] = ResolverRegistry(system).resolve[URI]("myservice", QA)

注销解析器

使用下面的API,通过名称注销。

ResolverRegistry(system).unregister("MyResolver")

并发注意事项

解析器注册和注销调用应当在初始化时以非并发的方式。对于并发注册没有任何保障, 因此并发注册的结果是未定义的。在并发下注册或注销,你的解析器可能是注册的,也可能不是。

但是, 解析调用是线程安全的, 可以同时访问, 而不受 ResolverRegistry 级别的限制。每个已注册的解析器都需要线程安全。

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,563评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,713评论 6 342
  • 一说到REST,我想大家的第一反应就是“啊,就是那种前后台通信方式。”但是在要求详细讲述它所提出的各个约束,以及如...
    时待吾阅读 3,400评论 0 19
  • 从三月份找实习到现在,面了一些公司,挂了不少,但最终还是拿到小米、百度、阿里、京东、新浪、CVTE、乐视家的研发岗...
    时芥蓝阅读 42,159评论 11 349
  • 1. 网络基础TCP/IP HTTP基于TCP/IP协议族,HTTP属于它内部的一个子集。 把互联网相关联的协议集...
    yozosann阅读 3,433评论 0 20