How to realize the unified contract in Dubbo?

Glacier team 2021-01-22 00:47:34
realize unified contract dubbo

Write it at the front

Before , A lot of friends sent me private letters : How to quickly master Dubbo The core principle and source code of . therefore , I wrote an article 《 How can I quickly grasp Dubbo The principle and source code of ( Dry only )?》. about Dubbo Source code analysis series article , I'm also thinking about how to make the article of source code analysis easier to understand , therefore , I adjusted my writing Dubbo Source code analysis article strategy , Try to make it easier for your friends 、 Easy to understand way to master thoroughly Dubbo Source code . today , Let's talk about Dubbo How to realize the unified contract in .

The article has been included in :

I have to say URL

URL The full name is the uniform resource locator , It can locate a unique network address in the Internet .URL The format of is as follows .


among , A brief description of each part is as follows .

  • protocol:URL The agreement . The most common protocol is HTTP and HTTPS, Others are FTP、WS、FILE、SMTP etc. .
  • username: user name .
  • password: password .
  • host: host , It's usually a domain name or IP Address .
  • port: Host port number .
  • path: The path of the requested target file .
  • parameters: Request specific parameter information , Here for key=value&key=value.

This is what we see on the Internet URL Brief description .

that , stay Dubbo Inside , A large number of methods receive parameters in the form of URL Encapsulated , that ,URL stay Dubbo What role does the interior play ? Let's move on .

Dubbo Medium URL

in general , stay Dubbo Inside , Service providers Provider Will encapsulate their own information into URL Sign up to Zookeeper Or other registries , So as to expose the services they provide . And service consumers Consumer Also through URL In the form of Zookeeper Or other registries subscribe to the services they want to call . And in the Dubbo Of SPI In the implementation ,URL And will participate in the logic processing of extension implementation . So ,URL stay Dubbo Is very important in the implementation of . It can also be said that ,Dubbo Medium URL Namely Dubbo The unified contract of .

So let's see Dubbo Medium URL What does it look like , By debugging Dubbo Bring their own Provider Sample source code , We can see in the Dubbo Medium URL As shown below .


This is also Provider Sign up to Zookeeper Or other registry information . The description of each part is as follows .

  • dubbo: It uses dubbo agreement .
  • host: The host IP The address is
  • port: The port number is 20880.
  • path: The request path here is :org.apache.dubbo.demo.DemoService
  • parameters: Requested parameter information , Here for :anyhost=true&application=dubbo-demo-annotation-provider&deprecated=false&dubbo=2.0.2&dynamic=true&generic=false&interface=org.apache.dubbo.demo.DemoService&methods=sayHello,sayHelloAsync&pid=15012&release=&side=provider&timestamp=1610857629484.

since Dubbo Is to Zookeeper Or other registries to register this information , that Dubbo How does the interior respond to URL It's packaged .

stay dubbo-common Module , There is one URL Class is designed to encapsulate URL, As shown below .

stay URL Class , Let's look at a core constructor , As shown below .

public URL(String protocol,
String username,
String password,
String host,
int port,
String path,
Map<String, String> parameters,
Map<String, Map<String, String>> methodParameters) {
if (StringUtils.isEmpty(username)
&& StringUtils.isNotEmpty(password)) {
throw new IllegalArgumentException("Invalid url, password without username!");
this.protocol = protocol;
this.username = username;
this.password = password; = host;
this.port = Math.max(port, 0);
this.address = getAddress(, this.port);
// trim the beginning "/"
while (path != null && path.startsWith("/")) {
path = path.substring(1);
this.path = path;
if (parameters == null) {
parameters = new HashMap<>();
} else {
parameters = new HashMap<>(parameters);
this.parameters = Collections.unmodifiableMap(parameters);
this.methodParameters = Collections.unmodifiableMap(methodParameters);

You can see ,Dubbo about URL The core encapsulation of , It's basically the same as in the Internet URL Encapsulation is consistent .

stay Dubbo Of dubbo-common The module provides processing URL Tool class of :URLBuilder and URLStrParser. As shown below .

The implementation of these two classes is relatively simple , Friends can read by themselves Dubbo Source code .

Next , Let's see Dubbo Inside ,URL How to realize the unified contract ?

Dubbo in URL Practical application of

here , We mainly talk about it from three aspects URL stay Dubbo Internal applications :

  • URL stay SPI Application in .
  • URL Applications in service registration .
  • URL Applications in service discovery .

URL stay SPI Application in

I know a little about Dubbo Everyone knows that ,Dubbo With a high degree of scalability , And this scalability is based on Dubbo Self SPI To achieve . stay Dubbo Realized SPI in ,URL And played a very important role .

stay Dubbo SPI In the implementation of , A typical scene is being @Adaptive Annotation decorated interface method , for example , stay dubbo-registry-api Module RegistryFactory Interface getRegistry() The method is @Adaptive({"protocol"}) To modify . As shown below .

explain RegistryFactory Interface getRegistry() Method is an adapter method ,Dubbo In the process of running , Would be getRegistry() Methods are generated dynamically RegistryFactory$Adaptive type . for example , Generated RegistryFactory$Adaptive The types are as follows .

public class RegistryFactory$Adaptive
implements RegistryFactory {
public Registry getRegistry(org.apache.dubbo.common.URL arg0) {
if (arg0 == null) throw new IllegalArgumentException("");
org.apache.dubbo.common.URL url = arg0;
String extName = (url.getProtocol() == null ? "dubbo" : url.getProtocol());
if (extName == null)
throw new IllegalStateException("");
RegistryFactory extension = (RegistryFactory) ExtensionLoader.getExtensionLoader(RegistryFactory.class).getExtension(extName);
return extension.getRegistry(arg0);

This code is relatively easy to understand , Generated RegistryFactory$Adaptive It's automatic getRegistry() Method , stay getRegistry() In the method , Will get URL Medium protocol Parameters to determine URL The agreement , If you get protocol It's empty , Use the default dubbo agreement , With this Agreement , I can get through SPI Load specific extension implementation classes dynamically .

We are Dubbo Of dubbo-registry-api Found in module RegistryProtocol class , As shown below .

Find one getRegistry() Method and hit the breakpoint , As shown below .

Next ,debug start-up Dubbo Of Provider Example , As shown below .

You can see , Used at this time protocol Agreement for zookeeper. of Dubbo in SPI The implementation of the , We will analyze it in detail later , today , Let's have a general understanding .

URL Applications in service registration

stay Dubbo The implementation of service registration in ,URL Also played a very important role . here , The registry I use is Zookeeper, therefore , We are dubbo-registry-zookeeper Found in module ZookeeperRegistry class , As shown below .

Find one doRegister() Method , Set a breakpoint , As shown below .

debug start-up Dubbo Self contained provider Example , As shown below .

You can see , Register to Zookeeper Medium URL in , Contains protocol agreement 、host Host name 、port Port number 、path Request path ,parameters Parameter information .

URL Applications in service discovery

Dubbo Consumers of services in the market Consumer When it starts , Will send to Zookeeper The registry subscribes to the services it needs to call , That's how to get through URL What about the subscription ? We are also in dubbo-registry-zookeeper Module ZookeeperRegistry Find in class doSubscribe() Method . stay doSubscribe() Method , As shown below .

start-up Dubbo Self contained Consumer Example , As shown below .

We can see ,Dubbo Of Consumer Will send to Zookeeper Pass in the following parameters to subscribe to the service .


Among them protocol by consumer, Represents a subscription agreement .category Represents the category to subscribe to , Here is providers,configurators,routers Three categories .interface Represents the interface service to subscribe to , Here is org.apache.dubbo.demo.DemoService.methods Represents the method to subscribe to , Here is sayHello,sayHelloAsync.

Another thing to note is : In the process of service registration ,Dubbo Will URL Turn into Zookeeper Path to register information to Zookeeper in ; In the process of service discovery ,Dubbo Will URL Turn into Zookeeper route , To monitor Zookeeper Change the directory to subscribe to related services .

All in all , stay Dubbo Through internal URL The realization of a unified contract . Have you learned ?

Okay , That's all for today , I'm glacier , If you have any questions, please leave a message below , I can also add wechat :sun_shine_lyz, Exchange technology together , Step up together , Let's fight together ~~

本文为[Glacier team]所创,转载请带上原文链接,感谢

  1. 【计算机网络 12(1),尚学堂马士兵Java视频教程
  2. 【程序猿历程,史上最全的Java面试题集锦在这里
  3. 【程序猿历程(1),Javaweb视频教程百度云
  4. Notes on MySQL 45 lectures (1-7)
  5. [computer network 12 (1), Shang Xuetang Ma soldier java video tutorial
  6. The most complete collection of Java interview questions in history is here
  7. [process of program ape (1), JavaWeb video tutorial, baidu cloud
  8. Notes on MySQL 45 lectures (1-7)
  9. 精进 Spring Boot 03:Spring Boot 的配置文件和配置管理,以及用三种方式读取配置文件
  10. Refined spring boot 03: spring boot configuration files and configuration management, and reading configuration files in three ways
  11. 精进 Spring Boot 03:Spring Boot 的配置文件和配置管理,以及用三种方式读取配置文件
  12. Refined spring boot 03: spring boot configuration files and configuration management, and reading configuration files in three ways
  13. 【递归,Java传智播客笔记
  14. [recursion, Java intelligence podcast notes
  15. [adhere to painting for 386 days] the beginning of spring of 24 solar terms
  16. K8S系列第八篇(Service、EndPoints以及高可用kubeadm部署)
  17. K8s Series Part 8 (service, endpoints and high availability kubeadm deployment)
  18. 【重识 HTML (3),350道Java面试真题分享
  19. 【重识 HTML (2),Java并发编程必会的多线程你竟然还不会
  20. 【重识 HTML (1),二本Java小菜鸟4面字节跳动被秒成渣渣
  21. [re recognize HTML (3) and share 350 real Java interview questions
  22. [re recognize HTML (2). Multithreading is a must for Java Concurrent Programming. How dare you not
  23. [re recognize HTML (1), two Java rookies' 4-sided bytes beat and become slag in seconds
  24. 造轮子系列之RPC 1:如何从零开始开发RPC框架
  25. RPC 1: how to develop RPC framework from scratch
  26. 造轮子系列之RPC 1:如何从零开始开发RPC框架
  27. RPC 1: how to develop RPC framework from scratch
  28. 一次性捋清楚吧,对乱糟糟的,Spring事务扩展机制
  29. 一文彻底弄懂如何选择抽象类还是接口,连续四年百度Java岗必问面试题
  30. Redis常用命令
  31. 一双拖鞋引发的血案,狂神说Java系列笔记
  32. 一、mysql基础安装
  33. 一位程序员的独白:尽管我一生坎坷,Java框架面试基础
  34. Clear it all at once. For the messy, spring transaction extension mechanism
  35. A thorough understanding of how to choose abstract classes or interfaces, baidu Java post must ask interview questions for four consecutive years
  36. Redis common commands
  37. A pair of slippers triggered the murder, crazy God said java series notes
  38. 1、 MySQL basic installation
  39. Monologue of a programmer: despite my ups and downs in my life, Java framework is the foundation of interview
  40. 【大厂面试】三面三问Spring循环依赖,请一定要把这篇看完(建议收藏)
  41. 一线互联网企业中,springboot入门项目
  42. 一篇文带你入门SSM框架Spring开发,帮你快速拿Offer
  43. 【面试资料】Java全集、微服务、大数据、数据结构与算法、机器学习知识最全总结,283页pdf
  44. 【leetcode刷题】24.数组中重复的数字——Java版
  45. 【leetcode刷题】23.对称二叉树——Java版
  46. 【leetcode刷题】22.二叉树的中序遍历——Java版
  47. 【leetcode刷题】21.三数之和——Java版
  48. 【leetcode刷题】20.最长回文子串——Java版
  49. 【leetcode刷题】19.回文链表——Java版
  50. 【leetcode刷题】18.反转链表——Java版
  51. 【leetcode刷题】17.相交链表——Java&python版
  52. 【leetcode刷题】16.环形链表——Java版
  53. 【leetcode刷题】15.汉明距离——Java版
  54. 【leetcode刷题】14.找到所有数组中消失的数字——Java版
  55. 【leetcode刷题】13.比特位计数——Java版
  56. oracle控制用户权限命令
  57. 三年Java开发,继阿里,鲁班二期Java架构师
  58. Oracle必须要启动的服务
  59. 万字长文!深入剖析HashMap,Java基础笔试题大全带答案
  60. 一问Kafka就心慌?我却凭着这份,图灵学院vip课程百度云