Dubbox - 入门小Demo

时间：2020-12-14 01:21:53


Dubbox简介

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

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

Dubbox - 入门小Demo

节点角色说明：

Provider: 暴露服务的服务提供方。
Consumer: 调用远程服务的服务消费方。
Registry: 服务注册与发现的注册中心。
Monitor: 统计服务的调用次调和调用时间的监控中心。
Container: 服务运行容器。

调用关系说明：

  1. 服务容器负责启动，加载，运行服务提供者。
  2. 服务提供者在启动时，向注册中心注册自己提供的服务。
  3. 服务消费者在启动时，向注册中心订阅自己所需的服务。
  4. 注册中心返回服务提供者地址列表给消费者，如果有变更，注册中心将基于长连接推 送变更数据给消费者。
  5. 服务消费者，从提供者地址列表中，基于软负载均衡算法，选一台提供者进行调用， 如果调用失败，再选另一台调用。
  6. 服务消费者和提供者，在内存中累计调用次数和调用时间，定时每分钟发送一次统计 数据到监控中心。

注册中心ZooKeeper

ZooKeeper介绍

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

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

ZooKeeper的安装

由于ZooKeeper是依赖于Java普通的，所以要安装对应版本的jdk。ZooKeeper可以安装到Windows平台下，也可以安装到Linux上。下边是对应两个平台的安装教程：

  • Linux上安装Zookeeper以及一些注意事项
  • Windows下安装ZooKeeper

由于本人是使用的阿里云云服务器ECS来安装ZooKeeper的，这里记录下怎么通过SSH远程连接云服务器以及怎么安装ZooKeeper。

通过SSH远程连接阿里云云服务器ECS

  1. 首先在本机上生成基于RSA算法的密钥对，生成的密钥对被存放在本机的~/.ssh目录下
  2. 登陆云服务器管理控制台，选择云服务器ECS -> 网络和安全 -> 密钥对
  3. 选择创建密钥对，这里可以让控制台自己帮你生成密钥对，也可以把我们之前自己生成的密钥对导入进去，注意是导入我们自己生成的公钥，也就是id_rsa.pub文件。
  4. 为我们刚刚创建好的密钥对绑定对应的云服务器实例
  5. 重启云服务器实例，这里必须要重启才能让刚刚绑定的公钥生效。
  6. 使用Xshell进行SSH远程连接我们的云服务器

具体的操作流程可以参考下这篇文章：使用SSH密钥对远程登录阿里云云服务器

阿里云云服务器安装ZooKeeper

安装ZooKeeper前需要先安装jdk，阿里云有镜像市场，可以很方便地直接更换系统盘，选择公共镜像进行安装，常见的有LAMP镜像或者LNMP镜像。我安装的是LNMP镜像。

  1. 首先需要将ZooKeeper的安装包传输到云服务器上，由于我使用的是Xshell，本身集成了Xftp，所以在远程连接了云服务器之后，直接通过Xftp将安装包传输到云服务器就行了。这是ZooKeeper的官方下载地址：http://mirrors.hust.edu.cn/apache/zookeeper/ 我使用的是zookeeper-3.4.6.tar.gz，版本比较落后，所以后边的操作可能和新版本的会有些出入。
  2. 解压压缩包：
tar -zxvf zookeeper-3.4.6.tar.gz

该命令会在当前目录下生成一个压缩包的同名文件(无后缀名)，然后将压缩包解压到该目录下。
3. 进入 zookeeper-3.4.6 目录，创建 data 文件夹

cd zookeeper-3.4.6
mkdir data

该文件夹用来存放ZooKeeper注册相关的数据。
4. 进入conf目录 ，把 zoo_sample.cfg 改名为 zoo.cfg(也可以直接复制zoo_sample.cfg这个文件并命名为zoo.cfg)

cd conf
mv zoo_sample.cfg zoo.cfg

因为Linux系统并没有命名专用的命令，所以使用mv这个移动文件的命令来进行重命名。如果是想要复制并命名一个文件，可以用下边的命令：cp zoo_sample.cfg zoo.cfg 5. 打开zoo.cfg , 修改 data 属性：dataDir=/root/zookeeper-3.4.6/data
这里的data指向我们刚刚创建的data文件夹，具体目录根据实际情况填写。在Linux里一般通过vi/vim进行修改文件，如下：

vim zoo.cfg

和vim相关的一些基本操作可以看下这篇文章：Linux笔记-怎么退出vi/vim编辑器

ZooKeeper的启动

进入bin目录，输入以下命令：

./zkServer.sh start

结束命令是：

./zkServer.sh stop

查看状态的命令是：

./zkServer.sh status

Dubbox本地JAR包部署与安装

在Maven的*仓库中可以查找到Dubbo的最终版本是2.5.3 , 阿里巴巴解散了Dubbo团队后由当当网继续维护此项目，并改名为 Dubbox，虽然坐标没有改变，版本也更新了，但是并没有将Dubbox提交到*仓库上，所以我们需要将Dubbox手动安装到本地仓库：
先将jar包放到某个目录下，接着打开cmd输入下边的命令，这里要注意-Dfile的值要根据你的jar目录来填写：

mvn install:install-file -Dfile=d:\dubbo-2.8.4.jar -DgroupId=com.alibaba -DartifactId=dubbo -Dversion=2.8.4 -Dpackaging=jar

安装完毕后会看到BUILD SUCCESS的提示。

在Eclipse中配置Dubbox的离线约束

dtd文件的在线地址： http://code.alibabatech.com/schema/dubbo/dubbo.xsd

Dubbox的jar包和离线的dtd文件和本Demo项目的源码打包在一块，可以在文章最后去下载。

下边是Eclipse中的配置方式：

Window -> Preferences -> XML -> XML Catalog -> Add… -> File System… -> 选中dtd文件 -> Key type选择Schema location -> 接着把Key的值改为http://code.alibabatech.com/schema/dubbo/dubbo.xsd -> 最后点确定

这样Eclipse就能对Dubbox进行自动提示了。

简单的Demo工程(Maven项目)

本Demo工程一共分为两部分，一部分是服务提供方dubboxdemo-service项目，一部分是服务消费方dubboxdemo-web项目。项目源码在GitHub上有，也可以直接在本文最后去下载。

dubboxdemo-service项目的注意事项

dubboxdemo-service项目是服务提供方，项目里使用的@Service注解是dubbox框架里的，而不是spring框架的。这里如果导错包会导致服务发布失败而无法被服务消费方所调用。

请修改本项目里的spring配置文件applicationContext-service.xml里的dubbox的ZooKeeper地址(host:port)：

<dubbo:registry address="zookeeper://host:port"  timeout="100000" />

dubboxdemo-web项目的注意事项

dubboxdemo-web项目是服务消费方，同样需要修改配置文件springmvc.xml里的dubbox的ZooKeeper地址(host:port)；另外该项目需要使用到服务提供方的提供的接口，所以需要将dubboxdemo-service里的接口复制过来。之所以直接复制代码，而不是通过导包的方式，我猜想是因为dubbox框架本来就是将提供方和消费方进行解耦的，双方互相不知道对方的存在，统一在注册中心ZooKeeper这里进行注册，以便于交互管理。

在Controller类中，有UserService这个私有变量，该变量不能用@autowired等注解来注入，因为其实现类并不在该项目中，实现类在服务提供方的源码中，所以我们要用dubbo提供的@Reference这个注解来远程注入。

服务的启动与关闭

首先需要将部署在云服务器上的ZooKeeper启动，接着启动本地的dubboxdemo-service项目，最后启动dubboxdemo-web项目。

因为我们在pom里配置了Tomcat7的插件，所以启动项目的时候，可以直接在Eclipse里右键该项目，选择Run As，接着选择Maven build...，接着在Goals:里输入tomcat7:run，接着回车即可启动项目。第一次启动项目的时候需要填写这个配置，以后启动同一个项目只需要直接点击Maven build就可以了，它会自动沿用之前的配置。

至于关闭服务就简单了，直接点击Eclipse里的控制台Console里的红色方格按钮Terminate就可以直接关闭项目了。因为启动了两个项目，所以需要两个都关闭掉才行。

远程连接ZooKeeper超时

在测试的时候遇到个问题，就是虽然云服务器上启动了ZooKeeper，也配置好了安全组策略，我配置的是允许全部协议访问云服务器，因为ZooKeeper用的是ZooKeeper协议。

但是我发现在启动了服务并访问dubboxdemo-web项目的时候，老是报连接超时的异常。在本地测试就没有这个问题，最后发现是因为云服务器上的防火墙导致的。我用的是CentOS 7.4，使用的防火墙是iptables，关闭命令如下：

service iptables stop

启动防火墙命令是service iptables start，不过我发现防火墙规则里并没有任何内容，暂时也不清楚为什么启动了iptables就会导致ZooKeeper的端口被拦截。

测试我们的服务

在成功启动ZooKeeper、以及两个项目后，通过访问http://localhost:8082/user/name.do，会返回一个页面，页面中是一段字符串，在我的项目里是让服务提供方直接返回字符串lewky，所以我这里的页面上会得到lewky这个字符串。

之所以这里是访问的8082端口，是因为在dubboxdemo-web项目的pom里设置了8082端口，另外dubboxdemo-service项目的pom里设置的是8081端口。

dubbo本身有个管理系统，可以很直观地看到注册中心中有哪些服务等内容，这个项目叫dubbo-admin，百度就有，可以将其源码打成war包，然后丢到Tomcat的webapps目录下，接着启动Tomcat即可访问该项目。这个项目的war包我也一起打包到一块了，在下面的链接里可以下载。

说一下这个dubbo-admin，当你启动好Tomcat后，如果是在本地就访问http://localhost:8080/dubbo-admin/，接着需要你输入账号密码，这个管理系统的账号密码都是root。

下图可以看到本项目的服务提供方：

Dubbox - 入门小Demo

补充

可以发现，在我们的服务提供方和服务消费方中使用到了重复的代码：UserService，服务消费方中通过持有UserService该接口，得以通过dubbox框架的@Reference进行远程注入。

这种写法其实并不好，因为两个项目中可能存在UserService代码不一致的情况，不利于维护，一个更好的写法，是将服务提供方和服务消费方共用的接口给提取出来，作为另外一个项目或者jar包来使用，这样就可以避免两端代码不一致的问题，同时也易于维护。因为这只是个简单的Demo，所以就不计较这些地方了，有兴趣的可以自己重新设计。

下载链接

Github项目地址

参考链接


标签：

相关文章