精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )

 

  • 只更新在笔者的知识星球,欢迎加入一起讨论 Dubbo 源码与实现
  • ↓↓↓ 长按下方二维码加入 ↓↓↓
    精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
    • ↑↑↑ 长按上方二维码加入
    • 目前已经有 1300+ 位球友加入…
    • 进度:已经完成 69+ 篇,预计总共 75+ 篇,完成度 92% 。
    • 对了,现在还有 40+ 篇 Netty 源码解析。
  • 对应 Dubbo 版本号:2.6.X

1.1 目录

  • 调试环境搭建
    • 《精尽 Dubbo 源码分析 —— 调试环境搭建》
  • 项目结构一览
    • 《精尽 Dubbo 源码分析 —— 项目结构一览》
  • 配置 Configuration
    • 《精尽 Dubbo 源码解析 —— API 配置(一)之应用》
    • 《精尽 Dubbo 源码解析 —— API 配置(二)之服务提供者》
    • 《精尽 Dubbo 源码解析 —— API 配置(三)之服务消费者》
    • 《精尽 Dubbo 源码分析 —— 属性配置》
    • 《精近 Dubbo 源码解析 —— XML 配置》
  • 核心流程一览
    • 《精近 Dubbo 源码解析 —— 核心流程一览》
  • 拓展机制 SPI
    • 《精尽 Dubbo 源码分析 —— 拓展机制 SPI》
  • 线程池
    • 《精尽 Dubbo 源码分析 —— 线程池》
  • 服务暴露 Export
    • 《精尽 Dubbo 源码分析 —— 服务暴露(一)之本地暴露(Injvm)》
    • 《精尽 Dubbo 源码分析 —— 服务暴露(二)之远程暴露(Dubbo)》
  • 服务引用 Refer
    • 《精尽 Dubbo 源码分析 —— 服务引用(一)之本地引用(Injvm)》
    • 《精尽 Dubbo 源码分析 —— 服务引用(二)之远程引用(Dubbo)》
  • 注册中心 Registry
    • 《精尽 Dubbo 源码分析 —— Zookeeper 客户端》
    • 《精尽 Dubbo 源码分析 —— 注册中心(一)之抽象 API》
    • 《精尽 Dubbo 源码分析 —— 注册中心(二)之 Zookeeper》
    • 《精尽 Dubbo 源码分析 —— 注册中心(三)之 Redis》
    • 《精尽 Dubbo 源码分析 —— 注册中心(四)之 Simple 》
    • 《精尽 Dubbo 源码分析 —— 注册中心(五)之 Multicast 》
  • 动态编译 Compile
    • 《精尽 Dubbo 源码分析 —— 动态编译(一)之 Javassist》
    • 《精尽 Dubbo 源码分析 —— 动态编译(二)之 JDK》
  • 动态代理 Proxy
    • 《精尽 Dubbo 源码分析 —— 动态代理(一)之 Javassist》
    • 《精尽 Dubbo 源码分析 —— 动态代理(二)之 JDK》
    • 《精尽 Dubbo 源码分析 —— 动态代理(三)之本地存根 Stub》
  • 服务调用 Invoke
    • 《精尽 Dubbo 源码分析 —— 服务调用(一)之本地调用(Injvm)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【1】通信实现》
    • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【2】同步调用》
    • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【3】异步调用》
    • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【4】参数回调》
    • 《精尽 Dubbo 源码解析 —— 服务调用(三)之远程调用(HTTP)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(四)之远程调用(Hessian)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(五)之远程调用(Webservice)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(六)之远程调用(REST)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(七)之远程调用(RMI)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(八)之远程调用(Redis)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(九)之远程调用(Memcached)》
    • 《精尽 Dubbo 源码解析 —— 服务调用(十)之远程调用(Thrift)》
  • 调用特性
    • 《精尽 Dubbo 源码解析 —— 调用特性(一)之回音测试》
    • 《精尽 Dubbo 源码解析 —— 调用特性(二)之泛化引用》
    • 《精尽 Dubbo 源码解析 —— 调用特性(三)之泛化实现》
  • 过滤器 Filter
    • 《精尽 Dubbo 源码解析 —— 过滤器(一)之 ClassLoaderFilter》
    • 《精尽 Dubbo 源码解析 —— 过滤器(二)之 ContextFilter》
    • 《精尽 Dubbo 源码解析 —— 过滤器(三)之 AccessLogFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(四)之 ActiveLimitFilter && ExecuteLimitFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(五)之 TimeoutFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(六)之 DeprecatedFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(七)之 ExceptionFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(八)之 TokenFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(九)之 TpsLimitFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(十)之 CacheFilter》
    • 《精尽 Dubbo 源码分析 —— 过滤器(十一)之 ValidationFilter》
  • NIO 服务器
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(一)之抽象 API》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(二)之 Transport 层》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(三)之 Telnet 层》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(四)之 Exchange 层》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(五)之 Buffer 层》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(六)之 Netty4 实现》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(七)之 Netty3 实现》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(八)之 Mina1 实现》
    • 《精尽 Dubbo 源码分析 —— NIO 服务器(九)之 Grizzly 实现》
  • P2P 服务器
    • 《精尽 Dubbo 源码分析 —— P2P 服务器》
  • HTTP 服务器
    • 《精尽 Dubbo 源码分析 —— HTTP 服务器》
  • 序列化 Serialization
    • 《精尽 Dubbo 源码分析 —— 序列化(一)之 总体实现》
    • 《精尽 Dubbo 源码分析 —— 序列化(二)之 Dubbo 实现》
    • 《精尽 Dubbo 源码分析 —— 序列化(三)之 Kryo 实现》
  • 服务容器 Container
    • 《精尽 Dubbo 源码解析 —— 服务容器》
  • 集群容错 Cluster
    • 《精尽 Dubbo 源码解析 —— 集群容错(一)之抽象 API》
    • 《精尽 Dubbo 源码解析 —— 集群容错(二)之 Cluster 实现》
    • 《精尽 Dubbo 源码解析 —— 集群容错(三)之 Directory 实现》
    • 《精尽 Dubbo 源码解析 —— 集群容错(四)之 Loadbalance 实现》
    • 《精尽 Dubbo 源码解析 —— 集群容错(五)之 Merger 实现》
    • 《精尽 Dubbo 源码解析 —— 集群容错(六)之 Configurator 实现》
    • 《精尽 Dubbo 源码解析 —— 集群容错(七)之 Router 实现》
    • 《精尽 Dubbo 源码解析 —— 集群容错(八)之 Mock 实现》
  • 优雅停机
    • 《精尽 Dubbo 源码解析 —— 优雅停机》
  • 日志适配
    • 《精尽 Dubbo 源码解析 —— 日志适配》
  • 状态检查
    • 《精尽 Dubbo 源码解析 —— 状态检查》
  • 监控中心 Monitor
    • TODO 等待新版本
  • 管理中心 Admin
    • TODO 等待新版本
  • 运维命令 QOS
    • TODO 比较简单,未来写一下
  • 链路追踪 Tracing
    • 《SkyWalking 源码分析 —— Agent 插件(二)之 Dubbo》

ps:

  • 小圆点代表已完成;
  • 小方块代表未来计划完成
  • 钟华贤代表不考虑写

1.2 Dubbo 用户指南

本小节,我们将 《精尽 Dubbo 源码解析》 和 《Dubbo 用户指南》 做一次映射,方便大家直接找到感兴趣的功能的具体源码实现。当然,如果有整理不到位的地方,欢迎大家给我留言斧正。

【<2> 快速启动】

Dubbo 采用全 Spring 配置方式,透明化接入应用,对应用没有任何 API 侵入,只需用 Spring 加载 Dubbo 的配置即可,Dubbo 基于 Spring 的 Schema 扩展进行加载。

如果不想使用 Spring 配置,可以通过 API 的方式 进行调用。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 调试环境搭建》

【<5.1> XML 配置】

有关 XML 的详细配置项,请参见:配置参考手册。如果不想使用 Spring 配置,而希望通过 API 的方式进行调用,请参见:API配置。想知道如何使用配置,请参见:快速启动。

对应源码解析文章:

  • 《精近 Dubbo 源码解析 —— XML 配置》

【<5.2> 属性配置】

如果公共配置很简单,没有多注册中心,多协议等情况,或者想多个 Spring 容器想共享配置,可以使用 dubbo.properties 作为缺省配置。

Dubbo 将自动加载 classpath 根目录下的 dubbo.properties,可以通过JVM启动参数 -Ddubbo.properties.file=xxx.properties 改变缺省配置位置。1

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 属性配置》

【<5.3> API 配置】

API 属性与配置项一对一,各属性含义,请参见:配置参考手册,比如:ApplicationConfig.setName("xxx")对应 <dubbo:application name="xxx" /> 1

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— API 配置(一)之应用》
  • 《精尽 Dubbo 源码解析 —— API 配置(二)之服务提供者》
  • 《精尽 Dubbo 源码解析 —— API 配置(三)之服务消费者》

【<5.4> 注解配置】

需要 2.5.7 及以上版本支持

对应源码解析文章:

《精尽 Dubbo 源码解析 —— 注解配置》

【<6.1> 启动时检查】

Dubbo 缺省会在启动时检查依赖的服务是否可用,不可用时会抛出异常,阻止 Spring 初始化完成,以便上线时,能及早发现问题,默认 check="true"

可以通过 check="false" 关闭检查,比如,测试时,有些服务不关心,或者出现了循环依赖,必须有一方先启动。

另外,如果你的 Spring 容器是懒加载的,或者通过 API 编程延迟引用服务,请关闭 check,否则服务临时不可用时,会抛出异常,拿到 null 引用,如果 check="false",总是会返回引用,当服务恢复时,能自动连上。

  • 注意,服务提供者注册失败,是没有启动检查功能的。这一点,笔者一直理解错了。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 注册中心(一)之抽象 API》

【<6.2> 集群容错】

在集群调用失败时,Dubbo 提供了多种容错方案,缺省为 failover 重试。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
cluster

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(一)之抽象 API》
  • 《精尽 Dubbo 源码解析 —— 集群容错(二)之 Cluster 实现》
  • 《精尽 Dubbo 源码解析 —— 集群容错(三)之 Directory 实现》

【<6.3> 负载均衡】

在集群负载均衡时,Dubbo 提供了多种均衡策略,缺省为 random 随机调用。

可以自行扩展负载均衡策略,参见:负载均衡扩展

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(四)之 Loadbalance 实现》

【<6.4> 线程模型】

如果事件处理的逻辑能迅速完成,并且不会发起新的 IO 请求,比如只是在内存中记个标识,则直接在 IO 线程上处理更快,因为减少了线程池调度。

但如果事件处理逻辑较慢,或者需要发起新的 IO 请求,比如需要查询数据库,则必须派发到线程池,否则 IO 线程阻塞,将导致不能接收其它请求。

如果用 IO 线程处理事件,又在事件处理过程中发起新的 IO 请求,比如在连接事件中发起登录请求,会报“可能引发死锁”异常,但不会真死锁。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
dubbo-protocol

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 线程池》

【<6.5> 直连提供者】

在开发及测试环境下,经常需要绕过注册中心,只测试指定服务提供者,这时候可能需要点对点直连,点对点直联方式,将以服务接口为单位,忽略注册中心的提供者列表,A 接口配置点对点,不影响 B 接口从注册中心获取列表。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/dubbo-directly.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务引用(二)之远程引用(Dubbo)》

【<6.6> 只订阅】

为方便开发测试,经常会在线下共用一个所有服务可用的注册中心,这时,如果一个正在开发中的服务提供者注册,可能会影响消费者不能正常运行。

可以让服务提供者开发方,只订阅服务(开发的服务可能依赖其它服务),而不注册正在开发的服务,通过直连测试正在开发的服务。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/subscribe-only.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务引用(一)之本地暴露(Injvm)》

【<6.7> 只注册】

如果有两个镜像环境,两个注册中心,有一个服务只在其中一个注册中心有部署,另一个注册中心还没来得及部署,而两个注册中心的其它应用都需要依赖此服务。这个时候,可以让服务提供者方只注册服务到另一注册中心,而不从另一注册中心订阅服务。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务引用(一)之本地暴露(Injvm)》

【<6.8> 静态服务】

有时候希望人工管理服务提供者的上线和下线,此时需将注册中心标识为非动态管理模式。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 注册中心(二)之 Zookeeper》
  • 《精尽 Dubbo 源码分析 —— 注册中心(三)之 Redis》

【<6.9> 多协议】

Dubbo 允许配置多协议,在不同服务上支持不同协议或者同一服务上同时支持多种协议。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务暴露(一)之本地暴露(Injvm)》
  • 《精尽 Dubbo 源码分析 —— 服务暴露(二)之远程暴露(Dubbo)》

【<6.10> 多注册中心】

Dubbo 支持同一服务向多注册中心同时注册,或者不同服务分别注册到不同的注册中心上去,甚至可以同时引用注册在不同注册中心上的同名服务。另外,注册中心是支持自定义扩展的。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务暴露(一)之本地暴露(Injvm)》
  • 《精尽 Dubbo 源码分析 —— 服务暴露(二)之远程暴露(Dubbo)》
  • 《精尽 Dubbo 源码分析 —— 服务引用(一)之本地引用(Injvm)》
  • 《精尽 Dubbo 源码分析 —— 服务引用(二)之远程引用(Dubbo)》

【<6.11> 服务分组】

当一个接口有多种实现时,可以用 group 区分。

  • 《精尽 Dubbo 源码分析 —— 服务暴露(二)之远程暴露(Dubbo)》
  • 《精尽 Dubbo 源码分析 —— 服务引用(二)之远程引用(Dubbo)》

【<6.12> 多版本】

当一个接口实现,出现不兼容升级时,可以用版本号过渡,版本号不同的服务相互间不引用。

可以按照以下的步骤进行版本迁移:

  1. 在低压力时间段,先升级一半提供者为新版本
  2. 再将所有消费者升级为新版本
  3. 然后将剩下的一半提供者升级为新版本

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务暴露(二)之远程暴露(Dubbo)》
  • 《精尽 Dubbo 源码分析 —— 服务引用(二)之远程引用(Dubbo)》
  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【2】同步调用》

【<6.13> 分组聚合】

按组合并返回结果 1,比如菜单服务,接口一样,但有多种实现,用group区分,现在消费方需从每种group中调用一次返回结果,合并结果返回,这样就可以实现聚合菜单项。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(五)之 Merger 实现》

【<6.14> 参数验证】

参数验证功能 1 是基于 JSR303 实现的,用户只需标识 JSR303 标准的验证 annotation,并通过声明 filter 来实现验证 2。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 过滤器(十一)之 ValidationFilter》

【<6.15> 结果缓存】

结果缓存 1,用于加速热门数据的访问速度,Dubbo 提供声明式缓存,以减少用户加缓存的工作量 2。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 过滤器(十)之 CacheFilter》

【<6.16> 泛化引用】

泛化接口调用方式主要用于客户端没有 API 接口及模型类元的情况,参数及返回值中的所有 POJO 均用 Map 表示,通常用于框架集成,比如:实现一个通用的服务测试框架,可通过 GenericService 调用所有服务实现。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 调用特性(二)之泛化引用》

【<6.17> 泛化实现】

泛接口实现方式主要用于服务器端没有API接口及模型类元的情况,参数及返回值中的所有POJO均用Map表示,通常用于框架集成,比如:实现一个通用的远程服务Mock框架,可通过实现GenericService接口处理所有服务请求。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 调用特性(三)之泛化实现》

【<6.18> 回声测试】

回声测试用于检测服务是否可用,回声测试按照正常请求流程执行,能够测试整个调用是否通畅,可用于监控。

所有服务自动实现 EchoService 接口,只需将任意服务引用强制转型为 EchoService,即可使用。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 调用特性(一)之回音测试》

【<6.19> 上下文信息】

上下文中存放的是当前调用过程中所需的环境信息。所有配置信息都将转换为 URL 的参数,参见 schema 配置参考手册 中的对应URL参数一列。

RpcContext 是一个 ThreadLocal 的临时状态记录器,当接收到 RPC 请求,或发起 RPC 请求时,RpcContext 的状态都会变化。比如:A 调 B,B 再调 C,则 B 机器上,在 B 调 C 之前,RpcContext 记录的是 A 调 B 的信息,在 B 调 C 之后,RpcContext 记录的是 B 调 C 的信息。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 过滤器(二)之 ContextFilter》

【<6.20> 隐式参数】

可以通过 RpcContext 上的 setAttachment 和 getAttachment 在服务消费方和提供方之间进行参数的隐式传递。 1

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/context.png

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 过滤器(二)之 ContextFilter》

【<6.21> 异步调用】

基于 NIO 的非阻塞实现并行调用,客户端不需要启动多线程即可完成并行调用多个远程服务,相对多线程开销较小。 1

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/future.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【3】异步调用》

【<6.22> 本地调用】

本地调用使用了 injvm 协议,是一个伪协议,它不开启端口,不发起远程调用,只在 JVM 内直接关联,但执行 Dubbo 的 Filter 链。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务调用(一)之本地调用(Injvm)》

【<6.23> 参数回调】

参数回调方式与调用本地 callback 或 listener 相同,只需要在 Spring 的配置文件中声明哪个参数是 callback 类型即可。Dubbo 将基于长连接生成反向代理,这样就可以从服务器端调用客户端逻辑 1。可以参考 dubbo 项目中的示例代码。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【4】参数回调》

【<6.24> 事件通知】

在调用之前、调用之后、出现异常时,会触发 oninvokeonreturnonthrow 三个事件,可以配置当事件发生时,通知哪个类的哪个方法 1。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【3】异步调用》

【<6.25> 本地存根】

远程服务后,客户端通常只剩下接口,而实现全在服务器端,但提供方有些时候想在客户端也执行部分逻辑,比如:做 ThreadLocal 缓存,提前验证参数,调用失败后伪造容错数据等等,此时就需要在 API 中带上 Stub,客户端生成 Proxy 实例,会把 Proxy 通过构造函数传给 Stub 1,然后把 Stub 暴露给用户,Stub 可以决定要不要去调 Proxy。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/stub.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 动态代理(三)之本地存根 Stub》

【<6.26> 本地伪装】

本地伪装 1 通常用于服务降级,比如某验权服务,当服务提供方全部挂掉后,客户端不抛出异常,而是通过 Mock 数据返回授权失败。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(八)之 Mock 实现》

【<6.27> 延迟暴露】

如果你的服务需要预热时间,比如初始化缓存,等待相关资源就位等,可以使用 delay 进行延迟暴露。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— API 配置(二)之服务提供者》

【<6.28> 并发控制】

限制 com.foo.BarService 的每个方法,服务器端并发执行(或占用线程池线程数)不能超过 10 个

限制 com.foo.BarService 的 sayHello 方法,服务器端并发执行(或占用线程池线程数)不能超过 10 个

限制 com.foo.BarService 的每个方法,每客户端并发执行(或占用连接的请求数)不能超过 10 个

限制 com.foo.BarService 的 sayHello 方法,每客户端并发执行(或占用连接的请求数)不能超过 10 个

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 过滤器(四)之 ActiveLimitFilter && ExecuteLimitFilter》
  • 《精尽 Dubbo 源码解析 —— 集群容错(四)之 Loadbalance 实现》

【<6.29> 连接控制】

限制服务器端接受的连接不能超过 10 个 1:

限制客户端服务使用连接不能超过 10 个 2:

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 过滤器(四)之 ActiveLimitFilter && ExecuteLimitFilter》

【<6.30> 延迟连接】

延迟连接用于减少长连接数。当有调用发起时,再创建长连接。1

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【1】通信实现》

【<6.31> 粘滞连接】

粘滞连接用于有状态服务,尽可能让客户端总是向同一提供者发起调用,除非该提供者挂了,再连另一台。

粘滞连接将自动开启延迟连接,以减少长连接数。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(一)之抽象 API》

【<6.32> 令牌验证】

通过令牌验证在注册中心控制权限,以决定要不要下发令牌给消费者,可以防止消费者绕过注册中心访问提供者,另外通过注册中心可灵活改变授权方式,而不需修改或升级提供者

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/dubbo-token.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 过滤器(八)之 TokenFilter》

【<6.33> 路由规则】

路由规则 1 决定一次 dubbo 服务调用的目标服务器,分为条件路由规则和脚本路由规则,并且支持可扩展 2。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(七)之 Router 实现》

【<6.34> 配置规则】

向注册中心写入动态配置覆盖规则 1。该功能通常由监控中心或治理中心的页面完成。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(六)之 Configurator 实现》

【<6.35> 服务降级】

可以通过服务降级功能 1 临时屏蔽某个出错的非关键服务,并定义降级后的返回策略。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(八)之 Mock 实现》

【<6.36> 优雅停机】

Dubbo 是通过 JDK 的 ShutdownHook 来完成优雅停机的,所以如果用户使用 kill -9 PID 等强制关闭指令,是不会执行优雅停机的,只有通过 kill PID 时,才会执行。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 优雅停机》

【<6.37> 主机绑定】

缺省主机 IP 查找顺序:

  • 通过 LocalHost.getLocalHost() 获取本机地址。
  • 如果是 127.* 等 loopback 地址,则扫描各网卡,获取网卡 IP。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— API 配置(二)之服务提供者》

【<6.38> 日志适配】

自 2.2.1 开始,dubbo 开始内置 log4j、slf4j、jcl、jdk 这些日志框架的适配 1,也可以通过以下方式显示配置日志输出策略:

  1. 命令行
  2. 在 dubbo.properties 中指定
  3. 在 dubbo.xml 中配置

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 日志适配》

【<6.39> 访问日志】

如果你想记录每一次请求信息,可开启访问日志,类似于apache的访问日志。注意:此日志量比较大,请注意磁盘容量。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 过滤器(三)之 AccessLogFilter》

【<6.40> 服务容器】

服务容器是一个 standalone 的启动程序,因为后台服务不需要 Tomcat 或 JBoss 等 Web 容器的功能,如果硬要用 Web 容器去加载服务提供方,增加复杂性,也浪费资源。

服务容器只是一个简单的 Main 方法,并加载一个简单的 Spring 容器,用于暴露服务。

服务容器的加载内容可以扩展,内置了 spring, jetty, log4j 等加载,可通过容器扩展点进行扩展。配置配在 java 命令的 -D 参数或者 dubbo.properties 中。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务容器》

【<6.41> ReferenceConfig 缓存】

ReferenceConfig 实例很重,封装了与注册中心的连接以及与提供者的连接,需要缓存。否则重复生成 ReferenceConfig 可能造成性能问题并且会有内存和连接泄漏。在 API 方式编程时,容易忽略此问题。

因此,自 2.4.0 版本开始, dubbo 提供了简单的工具类 ReferenceConfigCache用于缓存 ReferenceConfig 实例。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— API 配置(三)之服务消费者》

【<6.42> 分布式事务】

分布式事务基于 JTA/XA 规范实现 1。

两阶段提交:

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/jta-xa.jpg

目前该功能暂未实现,如下是推荐阅读的内容:

  • 《RocketMQ 源码分析 —— 事务消息》
  • 《Sharding-JDBC 源码分析 —— 分布式事务(一)之最大努力型》
  • 《MyCAT 源码分析 —— XA分布式事务》
  • 《TCC-Transaction 源码解析 —— 精品合集》
  • 《Happylifeplat-TCC 源码解析 —— 精品合集》
  • 《Myth 源码解析 —— 精品合集》

【<6.43> 线程栈自动dump】

当业务线程池满时,我们需要知道线程都在等待哪些资源、条件,以找到系统的瓶颈点或异常点。dubbo通过Jstack自动导出线程堆栈来保留现场,方便排查问题

默认策略:

  • 导出路径,user.home标识的用户主目录
  • 导出间隔,最短间隔允许每隔10分钟导出一次

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 线程池》

【<6.44> Netty4】

dubbo 2.5.6版本新增了对netty4通信模块的支持

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— NIO 服务器(六)之 Netty4 实现》

【<8> schema 配置参考手册】

这里以 XML Config 1 为准,列举所有配置项 2。其它配置方式,请参见相应转换关系:属性配置,注解配置,API 配置。

对应源码解析文章:

  • 《精近 Dubbo 源码解析 —— XML 配置》

【<9.1> dubbo://】

Dubbo 缺省协议采用单一长连接和 NIO 异步通讯,适合于小数据量大并发的服务调用,以及服务消费者机器数远大于服务提供者机器数的情况。

反之,Dubbo 缺省协议不适合传送大数据量的服务,比如传文件,传视频等,除非请求量很低。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
dubbo-protocol.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【1】通信实现》
  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【2】同步调用》
  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【3】异步调用》
  • 《精尽 Dubbo 源码解析 —— 服务调用(二)之远程调用(Dubbo)【4】参数回调》

【<9.2> rmi://】

RMI 协议采用 JDK 标准的 java.rmi.* 实现,采用阻塞式短连接和 JDK 标准序列化方式。

注意:如果正在使用 RMI 提供服务给外部访问 1,同时应用里依赖了老的 common-collections 包 2 的情况下,存在反序列化安全风险 3。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(七)之远程调用(RMI)》

【<9.3> hessian://】

Hessian 1 协议用于集成 Hessian 的服务,Hessian 底层采用 Http 通讯,采用 Servlet 暴露服务,Dubbo 缺省内嵌 Jetty 作为服务器实现。

Dubbo 的 Hessian 协议可以和原生 Hessian 服务互操作,即:

  • 提供者用 Dubbo 的 Hessian 协议暴露服务,消费者直接用标准 Hessian 接口调用
  • 或者提供方用标准 Hessian 暴露服务,消费方用 Dubbo 的 Hessian 协议调用。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(四)之远程调用(Hessian)》

【<9.4> http://】

基于 HTTP 表单的远程调用协议,采用 Spring 的 HttpInvoker 实现 1

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(三)之远程调用(HTTP)》

【<9.5> webservice://】

基于 WebService 的远程调用协议,基于 Apache CXF 1 的 frontend-simple 和 transports-http 实现 2。

可以和原生 WebService 服务互操作,即:

  • 提供者用 Dubbo 的 WebService 协议暴露服务,消费者直接用标准 WebService 接口调用,
  • 或者提供方用标准 WebService 暴露服务,消费方用 Dubbo 的 WebService 协议调用。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(五)之远程调用(Webservice)》

【<9.6> thrift://】

当前 dubbo 支持 1的 thrift 协议是对 thrift 原生协议 2 的扩展,在原生协议的基础上添加了一些额外的头信息,比如 service name,magic number 等。

使用 dubbo thrift 协议同样需要使用 thrift 的 idl compiler 编译生成相应的 java 代码,后续版本中会在这方面做一些增强。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(十)之远程调用(Thrift)》

【<9.7> memcached://】

基于 memcached 1 实现的 RPC 协议 2。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(九)之远程调用(Memcached)》

【<9.8> redis://】

基于 Redis 1 实现的 RPC 协议 2。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(八)之远程调用(Redis)》

【<9.9> rest://】

对应文档为

  • 《在Dubbo中开发REST风格的远程调用(RESTful Remoting)》 。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务调用(六)之远程调用(REST)》

【<10.1> Multicast 注册中心】

Multicast 注册中心不需要启动任何中心节点,只要广播地址一样,就可以互相发现。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/multicast.jpg
  1. 提供方启动时广播自己的地址
  2. 消费方启动时广播订阅请求
  3. 提供方收到订阅请求时,单播自己的地址给订阅者,如果设置了 unicast=false,则广播给订阅者
  4. 消费方收到提供方地址时,连接该地址进行 RPC 调用。

组播受网络结构限制,只适合小规模应用或开发阶段使用。组播地址段: 224.0.0.0 - 239.255.255.255

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 注册中心(五)之 Multicast 》

【<10.2> zookeeper 注册中心】

Zookeeper 是 Apacahe Hadoop 的子项目,是一个树型的目录服务,支持变更推送,适合作为 Dubbo 服务的注册中心,工业强度较高,可用于生产环境,并推荐使用 1。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/zookeeper.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— Zookeeper 客户端》
  • 《精尽 Dubbo 源码分析 —— 注册中心(一)之抽象 API》
  • 《精尽 Dubbo 源码分析 —— 注册中心(二)之 Zookeeper》

【<10.3> Redis 注册中心】

基于 Redis 1 实现的注册中心 2。

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/user-guide/images/dubbo-redis-registry.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 注册中心(三)之 Redis》

【<10.4> Simple 注册中心】

Simple 注册中心本身就是一个普通的 Dubbo 服务,可以减少第三方依赖,使整体通讯方式一致。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 注册中心(四)之 Simple 》

【<11> Telnet 命令参考手册】

从 2.0.5 版本开始,dubbo 开始支持通过 telnet 命令来镜像服务治理。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— NIO 服务器(三)之 Telnet 层》

【<12> 在线运维命令-QOS】

dubbo 2.5.8 新版本重构了 telnet 模块,提供了新的 telnet 命令支持。

对应源码解析文章:

TODO

dubbo-ops

1.3 Dubbo 开发指南

本小节,我们将 《精尽 Dubbo 源码解析》 和 《Dubbo 开发指南》 做一次映射,方便大家直接找到感兴趣的功能的具体源码实现。当然,如果有整理不到位的地方,欢迎大家给我留言斧正。

【<1> 源码构建】

代码签出 
分支 
构建 
构建源代码 jar 包 
IDE 支持

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 调试环境搭建》

【<2> 框架设计】

精尽 Dubbo 原理与源码专栏( 已经完成 69+ 篇,预计总共 75+ 篇 )
/dev-guide/images/dubbo-framework.jpg

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 项目结构一览》
  • 《精近 Dubbo 源码解析 —— 核心流程一览》

【<3> 扩展点加载】

Dubbo 的扩展点加载从 JDK 标准的 SPI (Service Provider Interface) 扩展点发现机制加强而来。

Dubbo 改进了 JDK 标准的 SPI 的以下问题:

  • JDK 标准的 SPI 会一次性实例化扩展点所有实现,如果有扩展实现初始化很耗时,但如果没用上也加载,会很浪费资源。
  • 如果扩展点加载失败,连扩展点的名称都拿不到了。比如:JDK 标准的 ScriptEngine,通过 getName() 获取脚本类型的名称,但如果 RubyScriptEngine 因为所依赖的 jruby.jar 不存在,导致 RubyScriptEngine 类加载失败,这个失败原因被吃掉了,和 ruby 对应不起来,当用户执行 ruby 脚本时,会报不支持 ruby,而不是真正失败的原因。
  • 增加了对扩展点 IoC 和 AOP 的支持,一个扩展点可以直接 setter 注入其它扩展点。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 拓展机制 SPI》

【<5.1> 协议扩展】

RPC 协议扩展,封装远程调用细节。

契约:

  • 当用户调用 refer() 所返回的 Invoker 对象的 invoke() 方法时,协议需相应执行同 URL 远端 export() 传入的 Invoker 对象的 invoke() 方法。
  • 其中,refer() 返回的 Invoker 由协议实现,协议通常需要在此 Invoker 中发送远程请求,export() 传入的 Invoker 由框架实现并传入,协议不需要关心。

注意:

  • 协议不关心业务接口的透明代理,以 Invoker 为中心,由外层将 Invoker 转换为业务接口。
  • 协议不一定要是 TCP 网络通讯,比如通过共享文件,IPC 进程间通讯等。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务暴露(一)之本地暴露(Injvm)》
  • 《精尽 Dubbo 源码分析 —— 服务暴露(二)之远程暴露(Dubbo)》
  • 《精尽 Dubbo 源码分析 —— 服务引用(一)之本地引用(Injvm)》
  • 《精尽 Dubbo 源码分析 —— 服务引用(二)之远程引用(Dubbo)》

【<5.2> 调用拦截扩展】

服务提供方和服务消费方调用过程拦截,Dubbo 本身的大多功能均基于此扩展点实现,每次远程方法执行,该拦截都会被执行,请注意对性能的影响。

约定:

  • 用户自定义 filter 默认在内置 filter 之后。
  • 特殊值 default,表示缺省扩展点插入的位置。比如:filter="xxx,default,yyy",表示 xxx 在缺省 filter 之前,yyy 在缺省 filter 之后。
  • 特殊符号 -,表示剔除。比如:filter="-foo1",剔除添加缺省扩展点 foo1。比如:filter="-default",剔除添加所有缺省扩展点。
  • provider 和 service 同时配置的 filter 时,累加所有 filter,而不是覆盖。比如: 和 ,则 xxx,yyy,aaa,bbb 均会生效。如果要覆盖,需配置:

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 过滤器(一)之 ClassLoaderFilter》
  • 《精尽 Dubbo 源码解析 —— 过滤器(二)之 ContextFilter》
  • 《精尽 Dubbo 源码解析 —— 过滤器(三)之 AccessLogFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(四)之 ActiveLimitFilter && ExecuteLimitFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(五)之 TimeoutFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(六)之 DeprecatedFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(七)之 ExceptionFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(八)之 TokenFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(九)之 TpsLimitFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(十)之 CacheFilter》
  • 《精尽 Dubbo 源码分析 —— 过滤器(十一)之 ValidationFilter》

【<5.3> 引用监听扩展】

当有服务引用时,触发该事件。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务引用(一)之本地引用(Injvm)》

【<5.4> 暴露监听扩展】

当有服务暴露时,触发该事件。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 服务暴露(一)之本地暴露(Injvm)》

【<5.5> 集群扩展】

当有多个服务提供方时,将多个服务提供方组织成一个集群,并伪装成一个提供方。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(一)之抽象 API》
  • 《精尽 Dubbo 源码解析 —— 集群容错(二)之 Cluster 实现》

【<5.6> 路由扩展】

从多个服务提者方中选择一个进行调用。

  • 官方文档写的有问题,从多个服务提者方中筛选出所有匹配的结果集。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(七)之 Router 实现》

【<5.7> 负载均衡扩展】

从多个服务提者方中选择一个进行调用

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(四)之 Loadbalance 实现》

【<5.8> 合并结果扩展】

合并返回结果,用于分组聚合。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 集群容错(五)之 Merger 实现》

【<5.9> 注册中心扩展】

负责服务的注册与发现。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— Zookeeper 客户端》
  • 《精尽 Dubbo 源码分析 —— 注册中心(一)之抽象 API》
  • 《精尽 Dubbo 源码分析 —— 注册中心(二)之 Zookeeper》
  • 《精尽 Dubbo 源码分析 —— 注册中心(三)之 Redis》
  • 《精尽 Dubbo 源码分析 —— 注册中心(四)之 Simple 》
  • 《精尽 Dubbo 源码分析 —— 注册中心(五)之 Multicast 》

【<5.10> 监控中心扩展】

负责服务调用次和调用时间的监控。

对应源码解析文章:

TODO

【<5.11> 扩展点加载扩展】

扩展点本身的加载容器,可从不同容器加载扩展点。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 拓展机制 SPI》

【<5.12> 动态代理扩展】

将 Invoker 接口转换成业务接口。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 动态代理(一)之 Javassist》
  • 《精尽 Dubbo 源码分析 —— 动态代理(二)之 JDK》

【<5.13> 编译器扩展】

Java 代码编译器,用于动态生成字节码,加速调用。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 动态编译(一)之 Javassist》
  • 《精尽 Dubbo 源码分析 —— 动态编译(二)之 JDK》

【<5.14> 消息派发扩展】

通道信息派发器,用于指定线程池模型。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— NIO 服务器(一)之抽象 API》

【<5.15> 线程池扩展】

服务提供方线程程实现策略,当服务器收到一个请求时,需要在线程池中创建一个线程去执行服务提供方业务逻辑。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 线程池》

【<5.16> 序列化扩展】

将对象转成字节流,用于网络传输,以及将字节流转为对象,用于在收到字节流数据后还原成对象。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 序列化(一)之 总体实现》
  • 《精尽 Dubbo 源码分析 —— 序列化(二)之 Dubbo 实现》
  • 《精尽 Dubbo 源码分析 —— 序列化(三)之 Kryo 实现》

【<5.17> 网络传输扩展】

远程通讯的服务器及客户端传输实现。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— NIO 服务器(一)之抽象 API》
  • 《精尽 Dubbo 源码分析 —— NIO 服务器(二)之 Transport 层》

【<5.18> 信息交换扩展】

基于传输层之上,实现 Request-Response 信息交换语义。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— NIO 服务器(四)之 Exchange 层》

【<5.19> 组网扩展】

对等网络节点组网器。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 注册中心(五)之 Multicast 》

【<5.20> Telnet 命令扩展】

所有服务器均支持 telnet 访问,用于人工干预。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— NIO 服务器(三)之 Telnet 层》

【<5.21> 状态检查扩展】

检查服务依赖各种资源的状态,此状态检查可同时用于 telnet 的 status 命令和 hosting 的 status 页面。

对应源码解析文章:

TODO

【<5.22> 容器扩展】

服务容器扩展,用于自定义加载内容。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 服务容器》

【<5.23> 页面扩展】

对等网络节点组网器。

  • 官方文档写的有问题,应该是请求处理器,有点类似 Servlet 。

对应源码解析文章:

TODO

【<5.24> 缓存扩展】

用请求参数作为 key,缓存返回结果。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 过滤器(十)之 CacheFilter》

【<5.25> 验证扩展】

参数验证扩展点。

对应源码解析文章:

  • 《精尽 Dubbo 源码分析 —— 过滤器(十一)之 ValidationFilter》

【<5.26> 日志适配扩展】

日志输出适配扩展点。

对应源码解析文章:

  • 《精尽 Dubbo 源码解析 —— 日志适配》

1.4 Dubbo 运维指南

《Dubbo 运维指南》 ,暂时无映射的需要。

 

发表评论