SpringBoot集成org.apache.Dubbo

一、前言

Dubbo作为一款优秀的RPC框架，在国内有着众多的使用者，自从2018年2月，Dubbo被阿里捐献给Apache基金会以后，Dubbo似乎以全新的名称 Apache Dubbo焕发了新的生命力。虽然有着同样优秀和优势的Spring Clould框架，但是Dubbo能焕发新生也是一件好事，期待着Dubbo能够完善机制，更新迭代出的更好。

所有代码我已上传到github，需要的可以自取测试，欢迎start，传送门
https://github.com/AggerChen/spring-boot-dubbo

二、项目简介

在Dubbo新的官网上查看资料，虽然也有很多demo发现要不还是旧包名com.alibaba.dubbo，要不就是集成的SpringBoot1.x，根本没法满足新的需要嘛，既然都已经是Apache Dubbo了，当然要使用最新的org.apache.dubbo和最新的SpringBoot2.x版本了~
此篇文章就是以一下版本来展示示例：

SpringBoot 2.2.2
org.apache.dubbo 2.7.5
zookeeper 3.4.14

三、项目开发

既然是Dubbo项目，那么我们的使用场景就是分布式微服务，多个service和一个consumer，还需要一个公共项目common来编写公用的类与接口。

3.1 创建项目spring-boot-dubbo

在IDEA中创建一个project，取名spring-boot-dubbo。这是一个根项目，其中pom.xml包含依赖如下：

pom.xml



    4.0.0

    
    
        org.springframework.boot
        spring-boot-starter-parent
        2.2.2.RELEASE
         
    

    
    com.agger
    spring-boot-dubbo
    1.0.0-SNAPSHOT
    pom
    ${project.artifactId}
    dubbo根项目

    
    
        true
        2.7.5
        3.4.14
        5.2.2.RELEASE
        0.0.1-SNAPSHOT
    


    
        dubbo-common
        dubbo-consumer
        dubbo-provider
    

    
    
        

            
            
                org.apache.dubbo
                dubbo
                ${dubbo.version}
                
                    
                        org.springframework
                        spring
                    
                    
                        javax.servlet
                        servlet-api
                    
                    
                        log4j
                        log4j
                    
                
            

            
            
                org.apache.dubbo
                dubbo-spring-boot-starter
                ${dubbo.version}
            

            
            
                org.apache.zookeeper
                zookeeper
                ${zookeeper.version}
                
                    
                        slf4j-log4j12
                        org.slf4j
                    
                
            
            
                com.github.sgroschupf
                zkclient
                0.1
            
            
                org.apache.curator
                curator-recipes
                4.2.0
            
            
                org.apache.curator
                curator-framework
                4.2.0
            

        
    

    
    

        
        
            org.springframework.boot
            spring-boot-starter
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
            
                
                    org.junit.vintage
                    junit-vintage-engine
                
            
        

        
        
            org.projectlombok
            lombok
            true
        

        
        
            com.agger
            dubbo-common
            ${dubbo.common}
        

    

    
    
        
            
                org.apache.maven.plugins
                maven-compiler-plugin
                
                    1.8
                    1.8

通过IDEA在项目spring-boot-dubbo中创建三个module，分别为：dubbo-common、dubbo-consumer、dubbo-privider。生成的目录结构为：

Image.png

3.2 dubbo-comm项目

此项目是一个公共项目，不需要其他多余的依赖，只是编写接口和公共的类使用。
编写一个接口名为HelloService：

HelloService.java

package com.agger.dubbocommon.service;
/**
 * @classname: HelloService
 * @description: Hello服务接口
 * @author chenhx
 * @date 2020-01-14 13:55:38
 */
public interface HelloService {
    String sayHello(String name);
}

pom.xml



    4.0.0
    
        com.agger
        spring-boot-dubbo
        1.0.0-SNAPSHOT
    

    com.agger
    dubbo-common
    0.0.1-SNAPSHOT
    dubbo-common
    jar
    dubbo公共项目

    
        
            
                org.apache.maven.plugins
                maven-compiler-plugin
                
                    1.8
                    1.8

3.3 dubbo-provider项目

此项目是一个服务类项目，也就是将接口服务注册到zookeeper注册中心供消费端调取使用。

编写pom文件依赖

pom.xml



    4.0.0
    
        com.agger
        spring-boot-dubbo
        1.0.0-SNAPSHOT
    

    
    com.agger
    dubbo-provider
    0.0.1-SNAPSHOT
    dubbo-provider
    jar
    dubbo项目服务端

    
        
        
            org.apache.dubbo
            dubbo
        
        
            org.apache.dubbo
            dubbo-spring-boot-starter
        
        
        
            org.apache.zookeeper
            zookeeper
            ${zookeeper.version}
            
                
                    slf4j-log4j12
                    org.slf4j
                
            
        
        
            com.github.sgroschupf
            zkclient
            0.1
        
        
            org.apache.curator
            curator-recipes
            4.2.0
        
        
            org.apache.curator
            curator-framework
            4.2.0
        
    

    
        
            
                org.apache.maven.plugins
                maven-compiler-plugin
                
                    1.8
                    1.8

编写一个service类实现接口
注意：@Service注解是dubbo里的注解，不是spring里的注解

HelloServiceImpl.java

package com.agger.dubboprovider.impl;

import com.agger.dubbocommon.service.HelloService;
import org.apache.dubbo.config.annotation.Service;
import org.springframework.stereotype.Component;

/**
 * @classname: HelloServiceImpl
 * @description: HelloService实现
 * @author chenhx
 * @date 2020-01-14 14:11:39
 */

@Service
@Component
public class HelloServiceImpl implements HelloService {

    @Override
    public String sayHello(String name) {
        System.out.println("dubbo服务调用：" + name);
        return "早上好啊~" + name;
    }
}

在springBoot启动类上添加配置
@EnableDubboConfig注解表示开启Dubbo的相关配置
@DubboComponentScan用来扫描提供的接口实现位置

DubboProviderApplication.java

package com.agger.dubboprovider;

import org.apache.dubbo.config.spring.context.annotation.DubboComponentScan;
import org.apache.dubbo.config.spring.context.annotation.EnableDubboConfig;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@EnableDubboConfig
@DubboComponentScan("com.agger.dubboprovider.impl")
@SpringBootApplication
public class DubboProviderApplication {
    public static void main(String[] args) {
        SpringApplication.run(DubboProviderApplication.class, args);
    }
}

添加dubbo配置
dubbo添加配置的方式有多种，既有xml和properties也有API方式。既然我们使用的是SpringBoot那么就应该消灭xml的配置方式，使用properties和yml方式都就可以，在此使用yml作为示例。

application.yml

server:
  port: 8087    # 服务端口

dubbo:
  application:
    id: dubbo-provider
    name: dubbo-provider  #应用名称
    owner: aggerChen      #应用所属者
    organization: agger   #应用所属组织
  registry:
    id: zookeeper-registry #注册中心id
    protocol: zookeeper    #注册中心协议
    address: zookeeper://127.0.0.1:2181 #注册中心地址
  metadata-report:
    address: zookeeper://127.0.0.1:2181
  protocol:
    name: dubbo   #协议名称
    port: 20880   #协议端口
    accesslog: dubbo-access.log #协议访问log
  provider:
    retries: 0    #重试次数
    timeout: 3000 #超时时间
  monitor:
    protocol: registry # 注册监控中心

3.4 dubbo-consumer项目

此项目就是一个web消费项目，当然也可以不是web项目，在此方便演示就使用了web项目，首先来看依赖文件。依赖于provider项目一样，只多了一个spring-boot-starter-web

pom.xml



    4.0.0
    
        com.agger
        spring-boot-dubbo
        1.0.0-SNAPSHOT
    

    com.agger
    dubbo-consumer
    0.0.1-SNAPSHOT
    dubbo-consumer
    jar
    dubbo项目客户端

    
        
        
            org.apache.dubbo
            dubbo
        
        
            org.apache.dubbo
            dubbo-spring-boot-starter
        

        
        
            org.apache.zookeeper
            zookeeper
            ${zookeeper.version}
            
                
                    slf4j-log4j12
                    org.slf4j
                
            
        
        
            com.github.sgroschupf
            zkclient
            0.1
        
        
            org.apache.curator
            curator-recipes
            4.2.0
        
        
            org.apache.curator
            curator-framework
            4.2.0
        

        
        
            org.springframework.boot
            spring-boot-starter-web
        
    

    
        
            
                org.apache.maven.plugins
                maven-compiler-plugin
                
                    1.8
                    1.8

编写一个controller来调用方法
使用@Reference注解来注入接口

HelloController.java

package com.agger.dubboconsumer.controller;

import com.agger.dubbocommon.service.HelloService;
import com.agger.dubboconsumer.vo.ResultVO;
import org.apache.dubbo.config.annotation.Reference;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @classname: HelloController
 * @description: Hello控制器
 * @author chenhx
 * @date 2020-01-14 13:57:48
 */
@RestController
@RequestMapping("/hello")
public class HelloController {

    @Reference
    HelloService helloService;

    @GetMapping("/morning/{name}")
    public ResultVO morning(@PathVariable("name") String name){
        System.out.println(name);
        String hello = helloService.sayHello(name);
        System.out.println(hello);
        return ResultVO.builder().flag(true).msg("调用成功").data(hello).build();
    }
}

当然你可以将调用接口的方法再封装一层service，方便更改service的版本号等等。

在项目启动类上添加配置
在项目的启动类DubboConsumerApplication中添加Dubbo启动注解和扫描注解。

DubboConsumerApplication.java

package com.agger.dubboconsumer;

import org.apache.dubbo.config.spring.context.annotation.DubboComponentScan;
import org.apache.dubbo.config.spring.context.annotation.EnableDubboConfig;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@EnableDubboConfig
@DubboComponentScan("com.agger.dubboconsumer.controller")
@SpringBootApplication
public class DubboConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(DubboConsumerApplication.class, args);
    }
}

填写配置文件

application.yml

server:
  port: 8088

dubbo:
  application:
    name: dubbo-consumer  # 应用名称
    owner: aggerChen      # 应用所属者
    organization: agger   # 应用所属组织
  registry:
    id: zookeeper-registry #注册中心id
    protocol: zookeeper    #注册中心协议
    address: zookeeper://127.0.0.1:2181 #注册中心地址
  monitor:
    protocol: registry # 注册监控中心

3.5 测试

到此为止编码部分就完成了，现在开始启动测试。

启动zookeeper
启动项目之前需要先启动zookeeper客户端，这个可以从官网上去下载传送门
选择稳定版本并下载。

Image [2].png

Image [3].png

下载完成后，记得将conf文件夹下面的文件zoo_sample.cfg改名为zoo.cfg，然后启动bin/zkServer.cmd就可以了。

启动dubbo-provider
如果你在内网有多台机器或者虚拟机，可以打包dubbo-provider项目在不同的机器上多启动几台。并使用java -jar dubbo-provider命令启动运行。我在IDEA中运行查看控制台信息：已经成功将接口HelloService注册到zookeeper上了

Image [4].png

启动dubbo-cosumer
启动后可以看到consumer已经从注册中心订阅了自己需要的接口

Image [5].png
测试访问
在浏览器访问地址：http://localhost:8088/hello/morning/tom
或者可以用IDEA的测试工具HTTP Client非常好用
看到测试结果如下，OK，测试成功！

Image [6].png

四、总结

以上的所有代码我已上传到github，需要的可以自取测试，欢迎start，传送门
https://github.com/AggerChen/spring-boot-dubbo
大家可以访问阿里中间件团队的博客，传送门，下载阿里插件可以快速构建项目并生成需要的common、consumer、provider包。
插件如下：Alibaba Cloud Toolkit

Image [7].png

构建Dubbo项目：

Image [8].png

Image [9].png

一路完成，就会自动构建需要的项目，大家可以测试一下~

此篇文章没有讲解Dubbo的太多原理，只是一个快速上手demo，要学习更多Dubbo的其他方面还需要多多啃一啃官网。
最后我们可以在dubbo-admin上查看我们的服务情况，需要选取下载项目并构建启动，传送门
https://github.com/apache/dubbo-admin

我们需要先打开dubbo-admin\dubbo-admin-server\src\main\resources\application.properties配置文件填写zookeeper地址和登陆用户名和密码。
Maven方式安装：

git clone https://github.com/apache/dubbo-admin.git 
cd dubbo-admin mvn clean package 
cd dubbo-admin-distribution/target java -jar dubbo-admin-0.1.jar

如果启动是报8080端口被占用，那么一定是zookeeper捣鬼，因为zookeeper客户端3.5版本Zookeeper AdminServer默认占用8080，所以我们需要在客户端配置文件zoo.cfg上添加更改端口配置：admin.serverPort=8999
登陆http://localhost:8080/ 点击服务查询，输入账号密码，默认root root。可以看到我启动的两个dubbo-provider服务，点击消费者可以查看消费者ip等信息。

Image [10].png

SpringBoot集成org.apache.Dubbo