原创: 泥瓦匠
本文目录
- 一、为啥整合 Dubbo 实现 SOA
- 二、运行 springboot-dubbo-server 和 springboot-dubbo-client 工程
- 三、springboot-dubbo-server 和 springboot-dubbo-client 工程配置详解
Spring Boot 系列文章:《Spring Boot 那些事》 https://www.bysocket.com/springboot
一、为啥集成 Dubbo?
Dubbo 不单单只是高性能的 RPC 调用框架,更是 SOA 服务治理的一种方案。
核心:
- 远程通信,向本地调用一样调用远程方法。
- 集群容错
- 服务自动发现和注册,可平滑添加或者删除服务提供者。
我们常常使用 Springboot 暴露 HTTP 服务,并走 JSON 模式。但慢慢量大了,一种 SOA 的治理方案。这样可以暴露出 Dubbo 服务接口,提供给 Dubbo 消费者进行 RPC 调用。下面我们详解下如何集成 Dubbo。
二、运行 springboot-dubbo-server 和 springboot-dubbo-client 工程
运行环境:JDK 7 或 8,Maven 3.0+ 技术栈:SpringBoot 1.5+、Dubbo 2.5+、ZooKeeper 3.3+
1.ZooKeeper 服务注册中心
ZooKeeper 是一个分布式的,开放源码的分布式应用程序协调服务。它是一个为分布式应用提供一致性服务的软件,提供的功能包括:配置维护、域名服务、分布式同步、组服务等。
下载 ZooKeeper ,地址 http://www.apache.org/dyn/closer.cgi/zookeeper 解压 ZooKeeper
tar zxvf zookeeper-3.4.8.tar.gz
在 conf 目录新建 zoo.cfg ,照着该目录的 zoo_sample.cfg 配置如下。
cd zookeeper-3.3.6/confvim zoo.cfg
zoo.cfg 代码如下(自己指定 log 文件目录):
tickTime=2000dataDir=/javaee/zookeeper/datadataLogDir=/javaee/zookeeper/logclientPort=2181
在 bin 目录下,启动 ZooKeeper
cd zookeeper-3.3.6/bin./zkServer.sh start
2. git clone 下载工程 springboot-learning-example
项目地址见 GitHub – https://github.com/JeffLi1993/springboot-learning-example:
git clone git@github.com:JeffLi1993/springboot-learning-example.git
然后,Maven 编译安装这个工程:
cd springboot-learning-examplemvn clean install
3.运行 springboot-dubbo-server Dubbo 服务提供者工程
右键运行 springboot-dubbo-server 工程 ServerApplication 应用启动类的 main 函数。Console 中出现如下表示项目启动成功:
![58dbf2d11098759d47ca2ca2885ad045.png](https://i-blog.csdnimg.cn/blog_migrate/450f8c5cc3930e1713a0c1903f902d55.jpeg)
这里表示 Dubbo 服务已经启动成功,并注册到 ZK (ZooKeeper)中。
4.运行 springboot-dubbo-client Dubbo 服务消费者工程
右键运行 springboot-dubbo-client 工程 ClientApplication 应用启动类的 main 函数。Console 中出现如下:
![6b8a17ef2d4e4fe7c1c2a5e01f14d2c7.png](https://i-blog.csdnimg.cn/blog_migrate/e95b941bf8bec2f1cd4d7f20e9de743e.jpeg)
最后打印的城市信息,就是通过 Dubbo 服务接口调用获取的。顺利运行成功,下面详解下各个代码及配置。
三、springboot-dubbo-server 和 springboot-dubbo-client 工程配置详解
代码都在 GitHub 上, https://github.com/JeffLi1993/springboot-learning-example。
1.详解 springboot-dubbo-server Dubbo 服务提供者工程
springboot-dubbo-server 工程目录结构
![0af310316840b113e3b2adeeac878dc1.png](https://i-blog.csdnimg.cn/blog_migrate/afe893c46cc38d709db9123d3383bbc9.jpeg)
a.pom.xml 配置
pom.xml 中依赖了 spring-boot-starter-dubbo 工程,该项目地址是 https://github.com/teaey/spring-boot-starter-dubbo。pom.xml 配置如下
![0a8aa7233d5cccb0971a36dfb1d3ef3a.png](https://i-blog.csdnimg.cn/blog_migrate/ddb5cf6c8aa3118d033e765d0a53745e.jpeg)
续下图
![3b43b2e17d4d2506cd2646595ba66961.png](https://i-blog.csdnimg.cn/blog_migrate/90495eb29f197adc01f766eee68de52f.jpeg)
b.application.properties 配置
![cecb85aad6bcf271c291a874ca154adc.png](https://i-blog.csdnimg.cn/blog_migrate/e39677bc2c2bdca947e0e83369dd08ad.jpeg)
这里 ZK 配置的地址和端口,就是上面本机搭建的 ZK 。如果有自己的 ZK 可以修改下面的配置。配置解释如下:
- spring.dubbo.application.name 应用名称
- spring.dubbo.registry.address 注册中心地址
- spring.dubbo.protocol.name 协议名称
- spring.dubbo.protocol.port 协议端口
- spring.dubbo.scan dubbo 服务类包目录
c.CityDubboServiceImpl.java 城市业务 Dubbo 服务层实现层类
![c8efb2c78fa1c17f5fa4c44aaadf90e3.png](https://i-blog.csdnimg.cn/blog_migrate/51f0da4f6a01c313162d658f894017ce.jpeg)
@Service 注解标识为 Dubbo 服务,并通过 version 指定了版本号。
d.City.java 城市实体类
实体类通过 Dubbo 服务之间 RPC 调用,则需要实现序列化接口。最好指定下 serialVersionUID 值。
2.详解 springboot-dubbo-client Dubbo 服务消费者工程
springboot-dubbo-client 工程目录结构
![43722a37a03d052e9e1447c3b40bbf82.png](https://i-blog.csdnimg.cn/blog_migrate/c69bc0fed52ccd4e2356c58f6944ebac.jpeg)
pom.xml 、 CityDubboService.java、City.java 没有改动。Dubbo 消费者通过引入接口实现 Dubbo 接口的调用。
a.application.properties 配置
![a2f21337085e1aa526efbf61230c61d2.png](https://i-blog.csdnimg.cn/blog_migrate/56b92f55a56a0cfc5109d136422a67a4.jpeg)
## 避免和 server 工程端口冲突server.port=8081## Dubbo 服务消费者配置spring.dubbo.application.name=consumerspring.dubbo.registry.address=zookeeper://127.0.0.1:2181spring.dubbo.scan=org.spring.springboot.dubbo
因为 springboot-dubbo-server 工程启动占用了 8080 端口,所以这边设置端口为 8081。
b.CityDubboConsumerService.java 城市 Dubbo 服务消费者
@Componentpublic class CityDubboConsumerService { @Reference(version = "1.0.0") CityDubboService cityDubboService; public void printCity() { String cityName="温岭"; City city = cityDubboService.findCityByName(cityName); System.out.println(city.toString()); }}
@Reference(version = “1.0.0”) 通过该注解,订阅该接口版本为 1.0.0 的 Dubbo 服务。
这里将 CityDubboConsumerService 注入 Spring 容器,是为了更方便的获取该 Bean,然后验证这个 Dubbo 调用是否成功。
c.ClientApplication.java 客户端启动类
@SpringBootApplicationpublic class ClientApplication { public static void main(String[] args){ // 程序启动入口 // 启动嵌入式的 Tomcat 并初始化 Spring 环境及其各 Spring 组件 ConfigurableApplicationContext run = SpringApplication.run(ClientApplication.class, args); CityDubboConsumerService cityService = run.getBean(CityDubboConsumerService.class); cityService.printCity(); }}
解释下这段逻辑,就是启动后从 Bean 容器中获取城市 Dubbo 服务消费者 Bean。然后调用该 Bean 方法去验证 Dubbo 调用是否成功。
代码示例
本文示例读者可以通过查看下面仓库的中的模块工程名: 2-x-spring-boot-webflux-handling-errors:
- Github:https://github.com/JeffLi1993/springboot-learning-example
- Gitee:https://gitee.com/jeff1993/springboot-learning-example