Dubbo入门demo

Dubbo是阿里开源的分布式RPC通信框架，目前在国内使用范围比较广，本文详细描述Dubbo的入门级使用过程，希望能够给想了解dubbo的人提供一点帮助。

前期准备(括号内为我使用的版本)

• JDK 1.5+（1.8.0_u161）
• eclipse(4.7.2)
• zookeeper(3.4.11)
• maven(3.5.2)

1. 我们在eclipse中创建maven项目，命名为dubbo-demo。
2. 创建三个子模块，分别为dubbo-provider，dubbo-consumer，dubbo-api，从命名可以看出这三个模块分别为服务提供者，服务消费者和API接口项目。

项目初始化结构

3. 在 dubbo-demo 的 pom.xml中添加公共依赖，主要是添加dubbo和zookeeper客户端依赖。代码如下：

    
    
        com.alibaba
        dubbo
        2.6.0
    
    
    
        com.101tec
        zkclient
        0.10
    


    
        
            org.apache.maven.plugins
            maven-compiler-plugin
            3.7.0
            
                1.8
                1.8
                utf-8
            
        
    

4. 首先我们先处理 api，此项目为其他两个项目提供接口，保证生产者和消费者所使用的接口统一。我们在 dubbo-api 项目中创建包 com.aotian.demo.dubbo.api，并添加 DemoService 接口。

API项目结构及代码

5. 接口类定义后我们需要在服务端和客户端项目中引用，保证两端接口一致，分别在两个项目的 pom.xml 中添加如下代码：

    
    
        com.aotian
        dubbo-api
        0.0.1-SNAPSHOT
    

6. 引用接口之后，我们需要在服务端添加接口实现类，在 dubbo-provider 项目中创建包 com.aotian.demo.dubbo.provider，并添加 DemoService 接口的实现类。

服务端项目结构及代码实现.png

7. 接口实现类添加后，我们需要将其注册到注册中心，只有这样，其他应用才有可能请求到，接下来我们在 src / main / resources 下创建 dubbo-provider.xml 文件，用于配置dubbo服务端注册，代码如下：

8. 接下来我们准备对服务端进行注册，所以需要准备注册中心，这里用的是 zookeeper，官网下载 zookeeper 后解压，将conf文件夹下的 zoo_sample.cfg 重命名为 zoo.cfg，之后在命令提示符下切换至bin目录下，执行 .\zkServer.cmd，看到如下提示后表示启动成功。

2018-03-13 23:12:59,007 [myid:] - INFO  [main:NIOServerCnxnFactory@89] - binding to port 0.0.0.0/0.0.0.0:2181

9. 启动服务端。本 Demo 用于测试，所以使用 main 方法加载的形式加载服务端，实际使用过程中可能会在 web 环境中使用。在服务端下添加 Provider.java 并执行 main 方法即可，其他 main 方法实现如下：

public static void main(String[] args) throws IOException {
    ClassPathXmlApplicationContext context 
        = new ClassPathXmlApplicationContext("classpath:dubbo-provider.xml");
    context.start();
    // 阻塞当前进程，否则程序会直接停止
    System.in.read();
}

10. 处理好服务端之后，我们再进行客户端的处理，首先添加客户端配置文件 dubbo-consumer.xml 放于 src / main / resources 下，内容与服务端相似，只不过不需要暴露接口，而是引用接口，代码如下：

11. 处理完配置文件，我们可以在客户端进行测试了，在 src / main / java 下创建包 com.aotian.demo.dubbo.api，并创建文件 consumer.java，main 方法代码如下：

public static void main(String[] args) {
    ClassPathXmlApplicationContext context 
        = new ClassPathXmlApplicationContext("classpath:dubbo-consumer.xml");
    context.start();
    
    String username = "aotian";
    DemoService demoService = (DemoService) context.getBean("demoService");
    System.out.println(demoService.changeUsername(username));
}

12. 执行后便可在控制台查看结果，如下图所示，表示客户端和服务端已经成功调用。

执行结果

示例代码：https://github.com/Aotian-GitHub/dubbo-basic-demo.git