基于SpringBoot+Dubbo+Zookeeper+Maven+IDEA搭建分布式项目实战

一、名词解释（来源百度百科）：

Spring Boot是由Pivotal团队提供的全新框架，其设计目的是用来简化新Spring应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置，从而使开发人员不再需要定义样板化的配置。

Dubbo(读音[ˈdʌbəʊ])是阿里巴巴公司开源的一个高性能优秀的服务框架，使得应用可通过高性能的 RPC 实现服务的输出和输入功能，可以和Spring框架无缝集成。

ZooKeeper是一个分布式的，开放源码的分布式应用程序协调服务，是Google的Chubby一个开源的实现，是Hadoop和Hbase的重要组件。它是一个为分布式应用提供一致性服务的软件，提供的功能包括：配置维护、域名服务、分布式同步、组服务等。

Maven项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建，报告和文档的项目管理工具软件。

IDEA 全称 IntelliJ IDEA，是java编程语言开发的集成环境。IntelliJ在业界被公认为最好的java开发工具，尤其在智能代码助手、代码自动提示、重构、JavaEE支持、各类版本工具(git、svn等)、JUnit、CVS整合、代码分析、 创新的GUI设计等方面的功能可以说是超常的。IDEA是JetBrains公司的产品，这家公司总部位于捷克共和国的首都布拉格，开发人员以严谨著称的东欧程序员为主。它的旗舰版本还支持HTML，CSS，PHP，MySQL，Python等。免费版只支持Java等少数语言。

二、项目搭建步骤：

1、安装本地Zookeeper注册中心，下载地址:https://www.apache.org/dyn/closer.cgi/zookeeper/ ，采用镜像下载速度快，如下图：

下载完成后解压，然后打开配置拷贝一份zoo_sample.cfg，修改名称为zoo.cfg，如下图：

打开zoo_.cfg，修改数据保存路径，如下图修改为本地可用路径，没有就创建对应的文件夹目录：

终端下进入bin命令，然后执行命令： ./zkServer.sh start ，如下图：

至此，Zookeeper启动成功。

2、打开IDEA开发工具，创建一个基于maven的SpringBoot的父项目，然后基于父项目创建三个子模块module，最终项目结构如下图：

1）打开父项目pom.xml文件，添加刚才创建的三个子模块，如下图完整代码：

    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        2.3.0.RELEASE
         
    

    com.qunhongtech
    springboot-dubbo-demo
    0.0.1-SNAPSHOT
    springboot-dubbo-demo
    Demo project for Spring Boot
    pom


    
        1.8
    

    
        dubbo-api
        dubbo-customer
        dubbo-provider
    

    
        
            org.springframework.boot
            spring-boot-starter
        

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

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

注意：pom 需要手动添加。

2）dubbo-api模块中新增服务接口类HelloService，代码如下：

package com.qunhongtech.api.service;

public interface HelloService {

    String sayHello(String name);
}

dubbo-api中pom.xml代码如下：

    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        2.3.0.RELEASE
         
    

    com.qunhongtech
    dubbo-api
    0.0.1-SNAPSHOT
    dubbo-api
    Demo project for Spring Boot

    
        1.8
    

    
        
            org.springframework.boot
            spring-boot-starter
        

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

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

结构目录如下图：

3）dubbo-provider模块中新增实现接口类HelloServiceImpl，代码如下：

package com.qunhongtech.provider.service.impl;

import com.alibaba.dubbo.config.annotation.Service;
import com.qunhongtech.api.service.HelloService;


@Service //发布服务
public class HelloServiceImpl implements HelloService {

    @Override
    public String sayHello(String name) {
        return "Hello, " + name;
    }
}

dubbo-provider中DubboProviderApplication启动类添加dubbo注解，代码如下：

package com.qunhongtech.provider;

import com.alibaba.dubbo.config.spring.context.annotation.EnableDubbo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;


@EnableDubbo
@SpringBootApplication
public class DubboProviderApplication {

    public static void main(String[] args) {
        SpringApplication.run(DubboProviderApplication.class, args);
    }

}

dubbo-provider中pom.xml代码如下：

    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        2.3.0.RELEASE
         
    

    com.qunhongtech
    dubbo-provider
    0.0.1-SNAPSHOT
    dubbo-provider
    Demo project for Spring Boot

    
        1.8
        3.4.13
        0.2.0
    

    

        
            com.qunhongtech
            dubbo-api
            0.0.1-SNAPSHOT
        

        
            org.springframework.boot
            spring-boot-starter
        


        
            com.alibaba.boot
            dubbo-spring-boot-starter
            ${dubbo.version}
        

        
            org.apache.zookeeper
            zookeeper
            ${zookeeper.version}
            
                
                    org.slf4j
                    slf4j-log4j12
                
                
                    log4j
                    log4j
                
            
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
            
                
                    org.junit.vintage
                    junit-vintage-engine
                
            
        
    

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

dubbo-provider中application.yml配置内容如下：

server:
  port: 8091

dubbo:
  application:
    name: dubbo-provider
  protocol:
    name: dubbo
    port: 20880
  registry:
    address: zookeeper://127.0.0.1:2181

结构目录如下图：

注意：

@Service 是dubbo发布服务的注解；

@EnableDubbo 是启动dubbo服务注解；

log4j 和 slf4j-log4j12 需要排除，否则会与zookeeper冲突；

 

4）dubbo-customer模块中新增控制类HelloController，便于测试，代码如下：

package com.qunhongtech.customer;


import com.alibaba.dubbo.config.annotation.Reference;
import com.qunhongtech.api.service.HelloService;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @Reference //引用服务
    private HelloService helloService;

    @GetMapping("/sayHello")
    private String sayHello(@RequestParam String name){

        System.out.println("调用sayHello成功了..." + " name:" + name);

        return helloService.sayHello(name);
    }

}

 

dubbo-customer中pom.xml代码如下：

    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        2.3.0.RELEASE
         
    
    com.qunhongtech
    dubbo-customer
    0.0.1-SNAPSHOT
    dubbo-customer
    Demo project for Spring Boot

    
        1.8
        3.4.13
        0.2.0
    

    

        
            com.qunhongtech
            dubbo-api
            0.0.1-SNAPSHOT
        

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

        
            com.alibaba.boot
            dubbo-spring-boot-starter
            ${dubbo.version}
        

        
            org.apache.zookeeper
            zookeeper
            ${zookeeper.version}
            
                
                    org.slf4j
                    slf4j-log4j12
                
                
                    log4j
                    log4j
                
            
        

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

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

dubbo-customer中application.yml配置内容如下：

server:
  port: 8090

dubbo:
  application:
    name: dubbo-customer
  registry:
    address: zookeeper://127.0.0.1:2181

结构目录如下图：

注意：

@Reference 是dubbo引用服务的注解；

至此，基于dubbo的分布式项目框架就搭建完成了。

三、项目消费-服务功能测试：

1）首先运行启动服务提供者dubbo-provider子模块，如下图：

2）然后启动服务消费者dubbo-customer子模块，如下图：

3）测试网址路径：http://localhost:8090/sayHello?name=群鸿科技，测试结果如下：

 

项目源码：https://github.com/mapboo/springboot-dubbo-demo 

结束语：通过一步步的操作，最终成功搭建了基于Dubbo的分布式项目框架，至于其中涉及的原理和概念，大家可以继续参考相关资料或视频，进一步加深理解，本文用最精简的代码和配置，演示了一个Dubbo项目从0到1搭建的过程，仅供参考，如有不妥之处，请不吝指正。