SpringCloud(一) - Dubbo + Zookeeper

Dubbo 和Zookeeper 不是SpringCloud的东西，放在这里只是为了方便复习；

1、下载安装Zookeeper和Dubbo

1.1 下载安装教程

下载安装教程 windows环境下安装zookeeper教程详解（单机版）

1.2 启动页面

1.2.1 zkServer.xmd zookeeper 服务端

1.2.2 zkCli.cmd zookeeper 客户端

1.3.3 运行 double-admin

java-jar dubbo-admin-0.0.1-SNAPSHOT.jar

访问localhost:7001

2、SpringBoot 集成 dubbo + zookeeper

2.1 模块项目建立

2.1.1 主项目

2.1.1.1 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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.9.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.kgc.sbt</groupId>
    <artifactId>springboot-10-dubbo-96</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>springboot-10-dubbo-96</name>
    <!-- 主项目打包方式，pom方式 -->
    <packaging>pom</packaging>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
        <!-- 版本统一管理 -->
        <dubbo.version>0.1.0</dubbo.version>
        <zkclient.version>0.10</zkclient.version>
    </properties>

    <!-- 父项目中的 dependencyManagement 中定义的只是依赖的声明，并不实现引入，因此子项目需要显式的声明需要用的依赖 -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.kgc.sbt</groupId>
                <artifactId>contactmall96-common</artifactId>
                <version>0.0.1-SNAPSHOT</version>
            </dependency>

            <dependency>
                <groupId>com.alibaba.boot</groupId>
                <artifactId>dubbo-spring-boot-starter</artifactId>
                <version>${dubbo.version}</version>
            </dependency>

            <dependency>
                <groupId>com.101tec</groupId>
                <artifactId>zkclient</artifactId>
                <version>${zkclient.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

	<!-- 模块管理  -->
    <modules>
        <module>contactmall96-common</module>
        <module>contactmall96-server</module>
        <module>contactmall96-web</module>
    </modules>

    <!-- 不需要 build -->

</project>

2.1.2 公共模块 common模块

2.1.2.1 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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.kgc.sbt</groupId>
        <artifactId>springboot-10-dubbo-96</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <relativePath>../pom.xml </relativePath>
    </parent>
    <groupId>com.kgc.sbt</groupId>
    <artifactId>contactmall96-common</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>contactmall96-common</name>
    <!-- 普通jar包，不是可执行jar,用于提供公共jar,给其他模块提供依赖 -->
    <packaging>jar</packaging>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

    <!-- 不需要 build -->

</project>

2.1.2.2 公共Api接口

// 联系人 公共接口(基于dubbo的rpc远程接口服务调用)，
// 此接口是提供给消费端web调用获取数据
// 服务端server实现此接口，提供数据
public interface ContactApi {

    //根据联系人编号，查询联系人详情公共方法
    ContactVO queryContactById(Integer id);

}

2.1.2.3 其他公共资源

注意：视图层的实体一定要进行序列化，因为在网络上传输的对象需要序列化；(ContactVO implements Serializable)

2.1.3 服务提供者 server模块

2.1.3.1 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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.kgc.sbt</groupId>
        <artifactId>springboot-10-dubbo-96</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <relativePath>../pom.xml </relativePath>
    </parent>
    <groupId>com.kgc.sbt</groupId>
    <artifactId>contactmall96-server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!--   依赖了common 模块，跨域直接使用模块中的依赖和类     -->
        <dependency>
            <groupId>com.kgc.sbt</groupId>
            <artifactId>contactmall96-common</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>

        <!-- fastjson -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.62</version>
        </dependency>

        <!-- mysql-connector-java -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.30</version>
        </dependency>

        <!-- commons-lang -->
        <dependency>
            <groupId>commons-lang</groupId>
            <artifactId>commons-lang</artifactId>
            <version>2.6</version>
        </dependency>

        <!-- mybatis-plus-boot-starter -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.3.4</version>
        </dependency>

        <!-- 父项目中管理了版本的不需要指定版本 -->
        <dependency>
            <groupId>com.alibaba.boot</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>com.101tec</groupId>
            <artifactId>zkclient</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

2.1.3.2 dubbo配置

# 端口
server.port=8096

#数据源
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/kh96_springboot_contactdb?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=GMT
spring.datasource.username=root
spring.datasource.password=root

#mybatis-plus 配置
mybatis-plus.configuration.map-underscore-to-camel-case=true

# dubbo配置
dubbo.application.name=contact-provider
dubbo.registry.address=127.0.0.1:2181
dubbo.registry.protocol=zookeeper
#端口号-1，会自动从20880开始递增，也可以指定（必须确保不冲突，一般不建议）(不要写成 dubbo.registry.port=-1)注册端口
#协议端口
dubbo.protocol.port=-1
#扫描指定包下的服务
dubbo.scan.base-packages=com.kgc.sbt.provider

2.1.3.3 代码分布情况

注意：主启动类扫描包，@MapperScan("com.kgc.sbt.mapper")

2.1.3.4 公共Api接口的实现类(注册服务)

package com.kgc.sbt.provider;

import com.alibaba.dubbo.config.annotation.Service;  //@Service作用：将当前服务注册为服务提供者
import com.kgc.sbt.api.ContactApi;
import com.kgc.sbt.service.ContactService;
import com.kgc.sbt.vo.ContactVO;
import org.springframework.beans.factory.annotation.Autowired;

//联系人功能 的提供者
@Service  //是alibaba包下的，不是spring的业务组件注解，作用：将当前服务注册为服务提供者
public class ContactProvider implements ContactApi {

    @Autowired
    private ContactService contactService;

    @Override
    public ContactVO queryContactById(Integer id) {
        //调用业务接口，查询联系人的详情
        return contactService.getContactById(id);
    }

}

2.1.4 消费模块 web模块

2.1.4.1 pom.xml

跟服务提供者差不多，这里列出所有pom主要是因为第一次这样构建模块项目，所以记录一下细节。

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.kgc.sbt</groupId>
        <artifactId>springboot-10-dubbo-96</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <relativePath>../pom.xml </relativePath>
    </parent>
    <groupId>com.kgc.sbt</groupId>
    <artifactId>contactmall96-web</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>contactmall96-web</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>com.kgc.sbt</groupId>
            <artifactId>contactmall96-common</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>

        <dependency>
            <groupId>com.alibaba.boot</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>com.101tec</groupId>
            <artifactId>zkclient</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

2.1.4.2 dubbo配置

# 端口
server.port=8098

# dubbo 配置
dubbo.application.name=contact-consumer
dubbo.registry.address=127.0.0.1:2181
dubbo.registry.protocol=zookeeper

2.1.4.3 代码分布情况

2.1.4.4 获取公共Api的实现类(订阅服务)

import com.alibaba.dubbo.config.annotation.Reference; //作用，到注册中心订阅当前接口对象提供的服务，成为该接口的消费者
import com.kgc.sbt.api.ContactApi;
import com.kgc.sbt.vo.ContactVO;
import org.springframework.stereotype.Service;

@Service  //spring容器的业务注解
public class ContactServiceImpl implements com.kgc.sbt.service.ContactService {

    @Reference //alibaba下的，作用，到注册中心订阅当前接口对象提供的服务，成为该接口的消费者
    private ContactApi contactApi;

    @Override
    public ContactVO getContactById(Integer contactId) {
        //基于RPC远程接口调用，调用服务提供者提供的服务，就等价于调用此既可，只不过是远程
        return contactApi.queryContactById(contactId);
    }
}

2.2 测试

先启动zookeeper和dubbo-admin;

在启动服务提供模块和服务消费模块；

2.2.1 请求测试

2.2.1.1 dubbo-admin页面查看 提供者和消费者

提供者：

消费者：

2.2.1.2 请求测试

2.2.2 多提供者，多消费者测试

2.2.2.1 复制服务

2.2.2.2 dubbo 查看 提供者和消费者

提供者：

消费者：

2.2.2.3 两个消费者请求测试

2.2.3 一些重要的点

2.2.3.1提供者的 权重

2.2.3.2 消费者的禁止

2.2.3.2.1 设置 消费者禁止：

被禁止的客户端将收到访问禁止异常

2.2.3.2.1 测试访问：

2.2.3.3 消费者的屏蔽

2.2.3.3.1 设置 消费者屏蔽：

屏蔽后，将不发起远程调用，直接在客户端返回空对象。

2.2.3.3.2 测试访问：

2.2.3.4 负载均衡

负载均衡有：随机(默认)，轮询，最少并发。