第一章 第一个dubbo项目

为了安全：服务启动的ip全部使用10.10.10.10

版本：

• dubbo：2.5.5

重要的网址：

• dubbo的github：https://github.com/alibaba/dubbo
• dubbo官网：http://dubbo.io/
• dubbo使用者手册：https://dubbo.gitbooks.io/dubbo-user-book/
• dubbo管理者手册：https://dubbo.gitbooks.io/dubbo-admin-book/
• dubbo开发者手册：https://dubbo.gitbooks.io/dubbo-dev-book/

首先从https://github.com/alibaba/dubbo下载dubbo源码到本地，我们的第一个dubbo项目就是dubbo源码中的dubbo-demo子模块。

代码结构如下：

其中：

• dubbo-demo-api是提供服务接口的模块
  • 在生产中，该模块会单独打成jar包，分别被provider和consumer依赖，provider实现该接口，consumer通过该接口引用provider实现的服务
• dubbo-demo-provider是服务提供者
• dubbo-demo-consumer是服务消费者

一 dubbo-demo-api

package com.alibaba.dubbo.demo;

public interface DemoService {
    String sayHello(String name);
}

只提供了一个接口。

二 dubbo-demo-provider

1 配置文件

src/main/resources/META-INF/spring/dubbo-demo-provider.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/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-2.5.xsd
       http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    <!-- 提供方应用信息，用于计算依赖关系 -->
    <dubbo:application name="demo-provider"/>

    <!-- 使用zookeeper注册中心，并使用curator客户端 -->
    <dubbo:registry protocol="zookeeper" address="10.211.55.5:2181" client="curator"/>

    <!-- 使用dubbo协议在20880端口暴露服务 -->
    <dubbo:protocol name="dubbo" port="20880"/>

    <!-- 和本地bean一样实现服务 -->
    <bean id="demoService" class="com.alibaba.dubbo.demo.provider.DemoServiceImpl"/>

    <!-- 声明需要暴露的服务接口 -->
    <dubbo:service interface="com.alibaba.dubbo.demo.DemoService" ref="demoService"/>
</beans>

配置项：

• dubbo:application：指定应用名字，在生产中通常与artifactId相同
• dubbo:registry：指定注册中心
  • protocol：使用的注册协议
  • address：注册中心地址
  • client：默认情况下，操作zookeeper的java客户端使用的是zkClient，这里使用curator
• dubbo:protocol：指定服务暴露的协议和端口
• dubbo:service：生命暴露的服务接口及其实现类

2 provider提供服务接口实现

package com.alibaba.dubbo.demo.provider;

import com.alibaba.dubbo.demo.DemoService;
import com.alibaba.dubbo.rpc.RpcContext;

import java.text.SimpleDateFormat;
import java.util.Date;

public class DemoServiceImpl implements DemoService {
    public String sayHello(String name) {
        System.out.println("[" + new SimpleDateFormat("HH:mm:ss").format(new Date()) + "] Hello " + name + ", request from consumer: " + RpcContext.getContext().getRemoteAddress());
        return "Hello " + name + ", response form provider: " + RpcContext.getContext().getLocalAddress();
    }
}

3 provider启动类

package com.alibaba.dubbo.demo.provider;

import org.springframework.context.support.ClassPathXmlApplicationContext;

public class Provider {
    public static void main(String[] args) throws Exception {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[]{"META-INF/spring/dubbo-demo-provider.xml"});
        context.start();

        System.in.read(); // 按任意键退出
    }
}

三 dubbo-demo-consumer

1 配置文件

src/main/resources/META-INF/spring/dubbo-demo-consumer.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/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-2.5.xsd
       http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    <!-- 消费方应用名，用于计算依赖关系，不是匹配条件，不要与提供方一样 -->
    <dubbo:application name="demo-consumer"/>

    <!-- 使用zookeeper注册中心，并使用curator客户端 -->
    <dubbo:registry protocol="zookeeper" address="10.211.55.5:2181" client="curator"/>

    <!-- 生成远程服务代理，可以和本地bean一样使用demoService -->
    <dubbo:reference id="demoService" check="false" interface="com.alibaba.dubbo.demo.DemoService"/>
</beans>

配置项：

• dubbo:reference：指定引用的服务
  • check：检查注册中心是否有可用的 provider

2 consumer启动类

package com.alibaba.dubbo.demo.consumer;

import com.alibaba.dubbo.demo.DemoService;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class Consumer {
    public static void main(String[] args) {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[]{"META-INF/spring/dubbo-demo-consumer.xml"});
        context.start();

        DemoService demoService = (DemoService) context.getBean("demoService"); // 获取远程服务代理
        String hello = demoService.sayHello("world"); // 执行远程方法

        System.out.println(hello); // 显示调用结果
    }
}

 启动服务并且调用远程服务。

四 启动服务

1 启动provider

启动成功后，会发现在zookeeper上创建了节点：

/dubbo

--/com.alibaba.dubbo.demo.DemoService

----/providers

------/dubbo://10.10.10.10:20880/com.alibaba.dubbo.demo.DemoService?anyhost=true&application=demo-provider&dubbo=2.0.0&generic=false&interface=com.alibaba.dubbo.demo.DemoService&methods=sayHello&pid=1393&side=provider&timestamp=1506831679007

注意：

• 所有dubbo相关的都会注册在“/dubbo”根节点下
• 与当前暴露的接口服务相关的，都注册在“/dubbo/接口”下

2 启动consumer

启动成功后，会发现在zookeeper上创建了节点：

/dubbo

--/com.alibaba.dubbo.demo.DemoService

----/consumers

------/consumer://10.10.10.10/com.alibaba.dubbo.demo.DemoService?application=demo-consumer&category=consumers&check=false&dubbo=2.0.0&interface=com.alibaba.dubbo.demo.DemoService&methods=sayHello&pid=1434&side=consumer&timestamp=1506832498078

之后，看到provider和consumer双方的互动输出，则表示rpc成功！

第一个dubbo项目就结束了，dubbo-demo项目也可以查看http://dubbo.io/的例子。