10分钟构建一个dubbo的小demo

我就是我 2022-05-16 00:30 187阅读 0赞

###        很多时候，相对于先学东西,先看结果会让人更容易接受。因为先学是广撒网，被动式的。而先看结果，就会主动去学习，因为大家都想知道，为啥要这么这么干。 ###

由于本文主要涉及的是操作，对于原理性的东西只会稍作介绍，正如上面说的，想知道为什么，自己查比我说来的效果要好。好了废话不多说，现在，我们就用idea来搭建一个简单的dubbo小demo，由于dubbo版本过低，这里选用dubbox。

**一：理论知识介绍**

**1 Dubbox简介**

Dubbox 是一个分布式服务框架，其前身是阿里巴巴开源项目Dubbo ，被国内电商及互联网项目中使用，后期阿里巴巴停止了该项目的维护，当当网便在Dubbo基础上进行优化，并继续维护，为了与原有的Dubbo区分，故将其命名为**Dubbox**。

Dubbox 致力于提供高性能和透明化的RPC远程服务调用方案，以及SOA服务治理方案。简单的说，dubbox就是个服务框架，如果没有分布式的需求，其实是不需要用的，只有在分布式的时候，才有dubbox这样的分布式服务框架的需求，并且本质上是个服务调用的东东，说白了就是个远程服务调用的分布式框架。

![70][]

**节点角色说明：**

· Provider: 暴露服务的服务提供方。

· Consumer: 调用远程服务的服务消费方。

· Registry: 服务注册与发现的注册中心。

· Monitor: 统计服务的调用次调和调用时间的监控中心。

· Container: 服务运行容器。

**调用关系说明：**

· 0. 服务容器负责启动，加载，运行服务提供者。

· 1. 服务提供者在启动时，向注册中心注册自己提供的服务。

· 2. 服务消费者在启动时，向注册中心订阅自己所需的服务。

· 3. 注册中心返回服务提供者地址列表给消费者，如果有变更，注册中心将基于长连接推

送变更数据给消费者。

· 4. 服务消费者，从提供者地址列表中，基于软负载均衡算法，选一台提供者进行调用，

如果调用失败，再选另一台调用。

· 5. 服务消费者和提供者，在内存中累计调用次数和调用时间，定时每分钟发送一次统计

数据到监控中心。

**2注册中心Zookeeper**

*2.1 Zookeeper 介绍*

官方推荐使用 zookeeper 注册中心。注册中心负责服务地址的注册与查找，相当于目录服务，服务提供者和消费者只在启动时与注册中心交互，注册中心不转发请求，压力较小。

Zookeeper 是 Apacahe Hadoop 的子项目，是一个树型的目录服务，支持变更推送，适合作为Dubbox 服务的注册中心，工业强度较高，可用于生产环境。

*2.2 Zookeeper 在Linux系统的安装*

安装步骤：

第一步：安装 jdk（此步省略，我给大家提供的镜像已经安装好JDK）

第二步：把 zookeeper 的压缩包（资源\\配套软件\\dubbox\\zookeeper-3.4.6.tar.gz）上传到 linux 系统。

Alt+P 进入SFTP ，输入put d:\\zookeeper-3.4.6.tar.gz 上传

第三步：解压缩压缩包

<table style="width:426.1pt;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:426.1pt;"> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">tar -zxvf zookeeper-3.4.6.tar.gz</span></span></p> </td> 
  </tr> 
 </tbody> 
</table>

第四步：进入 zookeeper-3.4.6 目录，创建 data 文件夹。

<table style="width:426.1pt;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:426.1pt;"> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">mkdir data</span></span></p> </td> 
  </tr> 
 </tbody> 
</table>

第五步：进入conf目录 ，把 zoo\_sample.cfg 改名为 zoo.cfg

<table style="width:426.1pt;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:426.1pt;"> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">cd conf</span></span></p> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">mv zoo_sample.cfg zoo.cfg</span></span></p> </td> 
  </tr> 
 </tbody> 
</table>

第六步：打开zoo.cfg ,  修改 data 属性：dataDir=/root/zookeeper-3.4.6/data

*2.3 Zookeeper 服务启动*

进入bin目录，启动服务输入命令

<table style="width:426.1pt;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:426.1pt;"> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">&nbsp;./zkServer.sh start</span></span></p> </td> 
  </tr> 
 </tbody> 
</table>

输出以下内容表示启动成功

![70 1][]

关闭服务输入命令

<table style="width:426.1pt;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:426.1pt;"> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">./zkServer.sh stop</span></span></p> </td> 
  </tr> 
 </tbody> 
</table>

输出以下提示信息

![70 2][]

查看状态：

<table style="width:426.1pt;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:426.1pt;"> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">./zkServer.sh status</span></span></p> </td> 
  </tr> 
 </tbody> 
</table>

如果启动状态，提示

![70 3][]

如果未启动状态，提示：

![70 4][]

**3 Dubbox本地 JAR包部署与安装**

Dubbox的jar包并没有部署到Maven的中央仓库中，大家在Maven的中央仓库中可以查找到Dubbo的最终版本是2.5.3 , 阿里巴巴解散了Dubbo团队后由当当网继续维护此项目，并改名为 Dubbox ,坐标不变，版本变更了，但是并没有提交到中央仓库。

我们现在需要手动将Dubbox的jar包安装到我的本地仓库中。

先将dubbo-2.8.4.jar包放到d:\\setup, 然后输入命令

<table style="width:426.1pt;"> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;width:426.1pt;"> <p><span style="color:#1e1c11;"><span style="color:#1e1c11;">mvn install:install-file -Dfile=d:\setup\dubbo-2.8.4.jar -DgroupId=com.alibaba -DartifactId=dubbo -Dversion=2.8.4 -Dpackaging=jar</span></span></p> </td> 
  </tr> 
 </tbody> 
</table>

**5入门小Demo开始**

*5.1服务提供者开发(目录结构)*

![70 5][]

开发步骤：

**（1）创建Maven工程（WAR）dubboxdemo-service  ，在pom.xml中引入依赖**

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>com.syl.test</groupId>
        <artifactId>dubboxdemo-service</artifactId>
        <version>1.0-SNAPSHOT</version>
        <packaging>war</packaging>
        <properties>
            <spring.version>4.2.4.RELEASE</spring.version>
        </properties>
        <dependencies>
            
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-context</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-beans</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-webmvc</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-jdbc</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-aspects</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-jms</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-context-support</artifactId>
                <version>${spring.version}</version>
            </dependency>
            
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>dubbo</artifactId>
                <version>2.8.4</version>
            </dependency>
            <dependency>
                <groupId>org.apache.zookeeper</groupId>
                <artifactId>zookeeper</artifactId>
                <version>3.4.6</version>
            </dependency>
            <dependency>
                <groupId>com.github.sgroschupf</groupId>
                <artifactId>zkclient</artifactId>
                <version>0.1</version>
            </dependency>
            <dependency>
                <groupId>javassist</groupId>
                <artifactId>javassist</artifactId>
                <version>3.11.0.GA</version>
            </dependency>
            
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>javax.servlet-api</artifactId>
                <version>3.0.1</version>
                <scope>provided</scope>
            </dependency>
        </dependencies>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>2.3.2</version>
                    <configuration>
                        <source>1.7</source>
                        <target>1.7</target>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.tomcat.maven</groupId>
                    <artifactId>tomcat7-maven-plugin</artifactId>
                    <configuration>
                        
                        <port>8080</port>
                        
                        <path>/</path>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    
    </project>

**（2）在工程的webapps下创建WEB-INF文件夹，创建web.xml**

**（3）创建业务接口**

创建包com.syl.test.service，用于存放业务接口，创建接口

package com.syl.test.service;
    
    /**
     * 业务接口 2018/8/13 
     */
    
    public interface TestService {
         String sayHello();
    }

**（4）创建业务实现类**

创建包com.syl.test.service.impl ，用于存放业务实现类。创建业务实现类：

package com.syl.test.service.impl;
    
    import com.alibaba.dubbo.config.annotation.Service;
    import com.syl.test.service.TestService;
    
    /**
     * Created by Administrator on 2018/8/13 0013.
     */
    @Service
    public class TestServiceImpl implements TestService {
        @Override
        public String sayHello() {
            return "I'm dubbox demo,Hello World!";
        }
    }

注意：这里要用com.alibaba包下的Service注解（留意以上代码的import）

**（5）编写配置文件**

在src/main/resources下创建applicationContext-service.xml ,内容如下：

<?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
           xmlns:context="http://www.springframework.org/schema/context"
           xmlns:dubbo="http://code.alibabatech.com/schema/dubbo" xmlns:mvc="http://www.springframework.org/schema/mvc"
           xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
            http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd
            http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd
            http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
    
        <dubbo:application name="dubboxdemo-service"/>
        <dubbo:registry address="zookeeper://192.168.25.219:2181"/>
        <dubbo:annotation package="com.syl.test.service"/>
    </beans>

**注意：**

http://code.alibabatech.com/schema/dubbo/dubbo.xsd 由于code.alibabatech.com这个网站已经不维护了。所以这里是无法正确引入这个限制文件的。我们通过手动引入这个文件。

可以去这个地址下载.xsd到本地

[https://github.com/apache/incubator-dubbo/blob/master/dubbo-config/dubbo-config-spring/src/main/resources/META-INF/dubbo.xsd][https_github.com_apache_incubator-dubbo_blob_master_dubbo-config_dubbo-config-spring_src_main_resources_META-INF_dubbo.xsd]

然后Idea中Settings中这个选项

![70 6][]

然后点击绿色加号，出现以下界面，配置一下就ok了。

![70 7][]

**（6）测试运行**注意：dubbo:annotation用于扫描@Service注解。

tomcat7:run

![70 8][]

*5.2服务消费者开发（目录结构）*

![70 9][]

开发步骤：

**（1）创建Maven工程（WAR）dubboxdemo-web** ，在pom.xml引入依赖 ，同“dubboxdemo-service”工程。区别就是把tomcat插件的运行端口改为80

**（2）在webapps目录下创建WEB-INF 目录**，并创建web.xml

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
             version="3.1">
        
        <filter>
            <filter-name>CharacterEncodingFilter</filter-name>
            <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
            <init-param>
                <param-name>encoding</param-name>
                <param-value>utf-8</param-value>
            </init-param>
            <init-param>
                <param-name>forceEncoding</param-name>
                <param-value>true</param-value>
            </init-param>
        </filter>
        <filter-mapping>
            <filter-name>CharacterEncodingFilter</filter-name>
            <url-pattern>/*</url-pattern>
        </filter-mapping>
        <servlet>
            <servlet-name>springmvc</servlet-name>
            <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
            
            <init-param>
                <param-name>contextConfigLocation</param-name>
                <param-value>classpath:applicationContext-web.xml</param-value>
            </init-param>
        </servlet>
        <servlet-mapping>
            <servlet-name>springmvc</servlet-name>
            <url-pattern>/</url-pattern>
        </servlet-mapping>
    </web-app>

**（3）拷贝业务接口**

将“dubboxdemo-service”工程的com.syl.test.service 包以及下面的接口拷贝至此工程。

**（4）编写Controller**

package com.syl.test.controller;
    
    import com.alibaba.dubbo.config.annotation.Reference;
    import com.syl.test.service.TestService;
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.ResponseBody;
    
    /**
     * Created by Administrator on 2018/8/13 0013.
     */
    @Controller
    @RequestMapping("/test")
    public class TestController {
        @Reference
        private TestService testService;
    
        @RequestMapping("/sayHello")
        @ResponseBody
        public String sayHello(){
            return testService.sayHello();
        }
    }

**（5）编写spring配置文件**

在src/main/resources下创建applicationContext-web.xml

<?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
           xmlns:context="http://www.springframework.org/schema/context"
           xmlns:dubbo="http://code.alibabatech.com/schema/dubbo" xmlns:mvc="http://www.springframework.org/schema/mvc"
           xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
            http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd
            http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd
            http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
    
        <mvc:annotation-driven >
            <mvc:message-converters register-defaults="false">
                <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                    <constructor-arg value="UTF-8" />
                </bean>
            </mvc:message-converters>
        </mvc:annotation-driven>
        <dubbo:application name="dubboxdemo-web"/>
        <dubbo:registry address="zookeeper://192.168.25.219:2181"/>
        <dubbo:annotation package="com.syl.test.controller"/>
    </beans>

**（6）测试运行**

tomcat7:run

![70 10][]

在浏览器输入[http://localhost/test/sayHello][http_localhost_test_sayHello]，查看浏览器输出结果

![70 11][]

OK,搞定。

[70]: /images/20220516/213dd94c9e99470b8ca7e886cca266b1.png
[70 1]: /images/20220516/f38e2960b8b042bb9cdc9a42763214ed.png
[70 2]: /images/20220516/77f4105c80274f008d10baa289a04c70.png
[70 3]: /images/20220516/c8fc131c8b3b428192dd99a93df9b060.png
[70 4]: /images/20220516/9ea50145474447d5901849ee413cd866.png
[70 5]: /images/20220516/0e360e941ca340aeaeb7ce9ed4c5920b.png
[https_github.com_apache_incubator-dubbo_blob_master_dubbo-config_dubbo-config-spring_src_main_resources_META-INF_dubbo.xsd]: https://github.com/apache/incubator-dubbo/blob/master/dubbo-config/dubbo-config-spring/src/main/resources/META-INF/dubbo.xsd
[70 6]: /images/20220516/a7aa61ef4bc14590a7f087dd16a6b5eb.png
[70 7]: /images/20220516/9bf988de9ced487fb314b8ddac19ec09.png
[70 8]: /images/20220516/f92f8999366248708c80452a910724e1.png
[70 9]: /images/20220516/63db1705894b467d983061c77ec9bf26.png
[70 10]: /images/20220516/e3af31ee57b94600aa8113a524400098.png
[http_localhost_test_sayHello]: http://localhost/test/sayHello
[70 11]: /images/20220516/2a79e01f50534ba3900fb3749d53dced.png