第一个基于Dubbo+Zookeeper搭建的项目

文 | 平哥 日期 | 20201013

具体代码详见GitHub仓库：点我跳转

项目简介

此项目为自己学习Dubbo+Zookeeper，搭建的第一个项目，主要架构就是一个父项目、三个子Module：dubbo_provider、 dubbo_consumer 和 dubbo_api，三个子Module分别继承父项目。

Dubbo的远程访问是基于接口的。Consumer和Provider使用同一个接口，可以实现远程访问。

  • Provider给接口写实现，提供服务。
  • Consumer使用接口，并通过Dubbo创建的动态代理对象，远程访问Provider。
  • 把接口独立定义在一个工程（dubbo_api）中，做依赖管理。

p.s. 此项目重点是练习Dubbo+Zookeeper，故没有写连接数据库的内容，只是模拟了访问数据库。

Step 1 创建项目并编写父项目Maven依赖

1.1 创建项目

用IDEA创建项目，创建完项目目录如下：


image

1.2 编写父项目Maven依赖

直接上代码：

<?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.gcp</groupId>
    <artifactId>dubbo_pro01</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>dubbo_provider</module>
        <module>dubbo_consumer</module>
        <module>dubbo_api</module>
    </modules>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.4.RELEASE</version>
    </parent>
    <dependencies>
        <!--springboot 启动器-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <!--lombok依赖-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
        <!--dubbo springboot启动器-->
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
            <version>2.7.8</version>
        </dependency>
        <!--curator依赖-->
        <!--Curator提供了一套Java类库， 可以更容易的使用ZooKeeper。 -->
        <dependency>
            <groupId>org.apache.curator</groupId>
            <artifactId>curator-recipes</artifactId>
            <version>5.1.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.curator</groupId>
            <artifactId>curator-framework</artifactId>
            <version>5.1.0</version>
        </dependency>
    </dependencies>
</project>

Step 2 编写dubbo_api

2.1 定义POJO类

package com.gcp.pojo;
import lombok.Data;
@Data
public class User {
    private Long id;
    private String name;
    private String password;
}

2.2 定义Service接口

package com.gcp.service;
import com.gcp.pojo.User;
/**
 * 用户服务接口
 */
public interface UserService {
    void register(User user);
    User getUserById(Long id);
}

Step 3 编写dubbo_provider

说明

  • Dubbo服务提供者Provider，是不需要定义Controller的，是直接通过Service提供服务的。
  • 使用Dubbo框架提供的注解@DubboService，声明当前的类型的对象，是一个Dubbo服务提供者。
  • 让Spring容器初始化、管理，并通过curator框架，把服务信息注册到Zookeeper中。
  • 在老版本的Dubbo（2.6（含）以前）中，注解命名是@Service。所以使用老版本开发的时候，注意导入的注解的包。
  • 需要提供一个application.yml配置文件，说明Dubbo使用的注册中心是什么，地址是什么。

3.1 配置pom.xml

在pom.xml文件中添加依赖：

<dependencies>
    <dependency>
        <groupId>com.gcp</groupId>
        <artifactId>dubbo_api</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>
</dependencies>

3.2 定义Mapper接口和类

UserMapper接口：

import com.gcp.pojo.User;

/**
 * 模拟数据库访问
 */
public interface UserMapper {
    void insert(User user);
    User selectById(Long id);
}

UserMapperImpl实现类：

@Repository
public class UserMapperImpl implements UserMapper {
    @Override
    public void insert(User user) {
        System.out.println("数据库访问：新增用户 - " + user);
    }

    @Override
    public User selectById(Long id) {
        User user = new User();
        user.setId(id);
        user.setName("name" + id);
        user.setPassword("password" + id);
        System.out.println("数据库访问：主键查询用户 - " + user);
        return user;
    }
}

3.3 定义Service实现类

@DubboService(loadbalance = "roundrobin")， 其中 loadbalance = "roundrobin" 意思是如果此服务有集群将采用轮询的方式进行负载均衡访问，
默认是 random：随机


@DubboService(loadbalance = "roundrobin")
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public void register(User user) {
        System.out.println("UserService 实现类中：注册用户");
        userMapper.insert(user);
    }

    @Override
    public User getUserById(Long id) {
        System.out.println("UserService 实现类中：根据id查询用户");
        return userMapper.selectById(id);
    }
}

3.4 配置application.yml

说明：

  • dubbo中，对每个服务提供者和消费者的管理，都是基于应用级别的。
  • 都是使用命名作为唯一标记的。
  • 同名的服务提供者或消费者，自动组成集群。
  • dubbo应用默认使用的协议是dubbo协议，使用的端口默认为20880。协议是可以配置的。

在 resources 文件夹下创建application.yml：

dubbo: # dubbo配置根节点
  registry: # 配置dubbo的注册中心 registry
    address: zookeeper://192.168.40.170:2181  # 提供注册中心的访问地址。
  application: # 配置本dubbo应用信息
    name: gcp-dubbo-first-provider  # 配置本dubbo的应用名称，名称组成是：字母，数字，'-'，字母开头
  protocol: # 协议，协议自定义配置的时候，所有的默认值失效。
    name: dubbo # 协议名
    port: 20880 # 端口，默认20880

如何安装Zookeeper可以详见我另一篇文章

3.5 创建SpringBoot启动程序

  • 启动的每个Dubbo应用，一定会在注册中心中注册信息。
  • 服务提供者注册的是/dubbo/xxx/providers
  • 服务消费者注册的是/dubbo/xxx/consumers
  • Dubbo启动器（dubbo-spring-boot-starter）默认不生效。
  • 必须通过@EnableDubbo让启动器生效。
  • 在2.7.2-以前版本中，部分配置默认不加载，需要使用@EnableDubboConfig让全部配置生效。
  • 负载均衡策略：
  • 设置负载均衡策略，可以在@DubboService或者@DubboReference注解上
  • 加属性loadbalance进行配置。
  • 消费者默认是不考虑负载均衡策略的，是使用提供者定义的负载均衡策略。
  • 如果消费者配置了负载均衡策略，则忽略提供者配置的负载均衡策略。
    在 com.gcp 包下创建SpringBoot启动类：
@SpringBootApplication
@EnableDubbo
// @EnableDubboConfig
public class DbProviderApplication {
    public static void main(String[] args) {
        SpringApplication.run(DbProviderApplication.class,args);
    }
}

此时可启动，测试看Zookeeper中是否成功注册上服务，访问Linux服务器，利用Zookeeper客户端工具查看：


image

Step 4 编写dubbo_consumer

4.1 配置pom.xml

在pom.xml文件中添加依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.gcp</groupId>
        <artifactId>dubbo_api</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>
</dependencies>

4.2 创建consumer本地Service接口和实现类

有人可能会疑惑，Zookeeper注册中心中已经有提供的Service服务了，怎么本地还需要Service？
说明： 其实，dubbo远程服务调用，是为了 封装通用规则，但各个子项目有自己的个性逻辑
如：用户的注册逻辑，在一个企业中是统一的。提供一个Provider实现注册逻辑；
对于consumer来说，是不同的，可以提供若干入口。如腾讯的用户注册，可以通过QQ、QQ音乐、QQ空间等实现注册或登录。底层的用户是相同的。

LocalUserService接口：

package com.gcp.service;
import com.gcp.pojo.User;
/**
 * consumer子Module的本地Service
 */
public interface LocalUserService {
    void register(User user);
    User getById(Long id);
}

LocalUserServiceImpl实现类：

@Service
public class LocalUserServiceImpl implements LocalUserService {

    /**
     * 远程服务的接口。通过注解@DubboReference实现动态代理创建
     * 规则：
     * 1、 通知Dubbo框架，根据配置找注册中心，发现服务的地址。
     *    拿接口名称作为zookeeper中节点的命名规则，获取地址。
     * 2、 通知Spring，根据Dubbo框架的特性，创建接口的动态代理对象，并维护
     *    在Spring容器中。
     * 3、 类似@Autowired，把代理对象注入到当前的变量中。
     */
    @DubboReference
    private UserService userService;
    @Override
    public void register(User user) {
        System.out.println("准备调用远程服务，服务对象类型是：" + userService.getClass().getName());
        System.out.println("注册的用户是： " + user);
        userService.register(user);
    }
    @Override
    public User getById(Long id) {
        System.out.println("根据主键查询用户，主键是： " + id);
        return userService.getUserById(id);
    }
}

4.3 创建Controller类

UserController类：

@RestController
public class UserController {

    @Autowired
    private LocalUserService localUserService;
    @RequestMapping("findUser")
    public User findUser(Long id){
        return localUserService.getById(id);
    }
    @RequestMapping("registerUser")
    public String register(User user){
        localUserService.register(user);
        return "注册用户成功";
    }
}

4.4 配置注册中心地址

在 resources 文件夹下创建 application.yml：

dubbo:
  registry:
    address: zookeeper://192.168.40.170:2181

4.5 创建Springboot启动类

在 com.gcp 包下创建 DbConsumerApplication：

@SpringBootApplication
@EnableDubbo
public class DbConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(DbConsumerApplication.class,args);
    }
}

4.6 启动测试

启动consumer的启动类，查看Zookeeper注册中心是否注册成功：


image

Step 5 项目整体测试

打开浏览器，输入consumer访问地址，测试是否可以正常访问：


image

后台输出：
consumer 子 Module：


image

provider 子 Module：


image

至此，项目搭建创建成功，大家可以自己多复制几个provider和consumer子Module的启动类，把端口都改成不一样试试集群轮询、随机访问的效果。

具体代码详见GitHub仓库：点我跳转

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 220,367评论 6赞 512
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 93,959评论 3赞 396
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 166,750评论 0赞 357
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 59,226评论 1赞 295
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 68,252评论 6赞 397
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,975评论 1赞 308
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 40,592评论 3赞 420
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 39,497评论 0赞 276
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 46,027评论 1赞 319
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,147评论 3赞 340
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,274评论 1赞 352
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,953评论 5赞 347
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 41,623评论 3赞 331
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,143评论 0赞 23
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,260评论 1赞 272
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 48,607评论 3赞 375
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 45,271评论 2赞 358