0. 背景知识
Dubbo一开始只是阿里巴巴内部的一个分布式服务治理框架,于2012年开源。
由于阿里巴巴的的盛名在外,以及dubbo经过大规模业务验证,它被很多互联网公司所采用。
但是,遗憾的是,阿里巴巴在2014年停止了维护。
于是很多公司开始自己维护Dubbo框架,比较知名的便是当当网当时开源的DubboX。
庆幸的是,2017年9月,阿里巴巴重启了Dubbo的维护,并且有了新的规划。
2018年2月,Dubbo进入Apache孵化,意味着它将成为开源社区的重要一分子。
2019年5月,Apache Dubbo正式从孵化器毕业,成为Apache顶级项目。
1. 基本概念和原理
Dubbo是什么
根据官网的解释,如下:
Apache Dubbo |ˈdʌbəʊ| is a high-performance, light weight, java based RPC framework.
Apache Dubbo是一个高性能的,轻量的,基于Java的RPC框架。
Dubbo有哪些核心功能
Dubbo offers three key functionalities, which include interface based remote call, fault tolerance & load balancing, and automatic service registration & discovery.
Dubbo提供了三大核心功能:
- 基于接口的远程调用
- 容错和负载均衡
- 自动服务注册与发现
Dubbo架构图
2. 代码实例
新建一个maven工程为pom类型命名为dubbo-simple-demo
在工程下新建两个模块项目: provider-service和consumer-service,其中provider-service为pom类型,consumer-service为jar类型。
provider-service下面又新建两个模块项目,均为jar类型: provider-api和provider-service-impl。
provider-api用来定义当前服务对外提供的接口。
provider-service-impl则为服务对应的实现。
项目结构如下:
给项目总的添加依赖如下:
<dependency>
<groupId>org.apache.dubbo</groupId>
<artifactId>dubbo</artifactId>
<version>2.7.7</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.22</version>
</dependency>
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>3.4.10</version>
</dependency>
<dependency>
<groupId>com.101tec</groupId>
<artifactId>zkclient</artifactId>
<version>0.5</version>
</dependency>
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-framework</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>org.apache.curator</groupId>
<artifactId>curator-recipes</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId>
<version>4.0.35.Final</version>
</dependency>
在provider-api项目下,你只需创建一个接口名为UserService
public interface UserService {
String getNameById(String id);
}
provider-service-impl需要添加对provider-api项目的依赖,并增加接口实现UserServiceImpl
public class UserServiceImpl implements UserService {
@Override
public String getNameById(String id) {
System.out.println("receive data: " + id);
return "123456";
}
}
接下来需要创建服务提供者的配置文件(在resource文件夹下新建spring/provider-service-impl.xml)
provider-service-impl.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
xmlns="http://www.springframework.org/schema/beans"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd">
<dubbo:application metadata-type="remote" name="provider-service"/>
<dubbo:metadata-report address="zookeeper://127.0.0.1:2181"/>
<dubbo:registry address="zookeeper://127.0.0.1:2181"/>
<dubbo:protocol name="dubbo" />
<dubbo:service interface="org.genesis.dubbo.provider.api.UserService" ref="userService"/>
<bean id="userService" class="org.genesis.dubbo.provider.impl.UserServiceImpl"/>
</beans>
dubbo:application
用来描述提供方的应用信息,如应用名称等。dubbo:registry
配置注册中心的地址,可以使ZooKeeper,Nacos等。如果不需要注册中心可以写N/A。dubbo:protocol
配置协议dubbo:service
配置服务接口bean
指向实际的服务实现
接下来,你需要编写provider的main方法
ProviderMain
public class ProviderMain {
public static void main(String[] args) throws IOException {
ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("spring/provider-service-impl.xml");
context.start();
System.in.read();
}
}
运行之前你需要先启动ZooKeeper。
(如果没安装ZooKeeper的请先安装)
运行提供者程序,我们可以看到控制台有如下输出:
[22/05/20 20:03:07:728 CST] main INFO zookeeper.ZookeeperRegistry: [DUBBO] Register: dubbo://192.168.1.5:20880/org.genesis.dubbo.provider.api.UserService?...dubbo version: 2.7.7...
[22/05/20 20:03:07:752 CST] main INFO zookeeper.ZookeeperRegistry: [DUBBO] Subscribe: provider://192.168.1.5:20880/org.genesis.dubbo.provider.api.UserService?...dubbo version: 2.7.7...
[22/05/20 20:03:07:757 CST] main INFO zookeeper.ZookeeperRegistry: [DUBBO] Notify urls for subscribe url provider://192.168.1.5:20880/org.genesis.dubbo.provider.api.UserService?... dubbo version: 2.7.7...
说明服务提供者已经成功了!
服务消费者的配置相对简单一些,你也需要在resource目录下创建文件(spring/consumer-service.xml)
consumer-service.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
xmlns="http://www.springframework.org/schema/beans"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd">
<dubbo:application name="consumer-service"/>
<dubbo:registry address="zookeeper://127.0.0.1:2181"/>
<dubbo:reference id="userService" check="false" interface="org.genesis.dubbo.provider.api.UserService"/>
</beans>
- dubbo:reference
应用之前声明的远程服务接口
接下来就只要编写main方法即可了
ConsumerMain
public class ConsumerMain {
public static void main(String[] args) {
ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("spring/consumer-service.xml");
UserService userService = context.getBean("userService", UserService.class);
System.out.println(userService.getNameById("9999"));
}
}
运行程序,你会看到
Provider端会输出:
receive data: 9999
(输出了消费端传入的参数)
Consumer端会输出:
[DUBBO] Refer dubbo service org.genesis.dubbo.provider.api.UserService from url zookeeper://127.0.0.1:2181/org.apache.dubbo.registry.RegistryService...
123456
(输出了提供端返回的结果)
这样就标明一个简单的消费者提供者的dubbo程序已经成功了!