Spring Cloud与Dubbo的完美融合之手「Spring Cloud Alibaba」

 

 

很早之前，在刚开始搞Spring Cloud基础教程的时候，写过这样一篇文章：《微服务架构的基础框架选择：Spring Cloud仍是Dubbo？》，可能很多读者也都看过。以后也就一直有关于这两个框架怎么选的问题出来，其实文中我有明确的提过，Spring Cloud与Dubbo的比较自己是不公平的，主要前者是一套较为完整的架构方案，而Dubbo只是服务治理与RPC实现方案。

因为Dubbo在国内有着很是大的用户群体，可是其周边设施与组件相对来讲并不那么完善。不少开发者用户又很但愿享受Spring Cloud的生态，所以也会有一些Spring Cloud与Dubbo一块儿使用的案例与方法出现，可是一直以来大部分Spring Cloud整合Dubbo的使用方案都比较别扭。这主要是因为Dubbod的注册中心采用了ZooKeeper，而开始时Spring Cloud体系中的注册中心并不支持ZooKeeper，因此不少方案是存在两个不一样注册中心的，以后即便Spring Cloud支持了ZooKeeper，可是因为服务信息的粒度与存储也不一致。因此，长期以来，在服务治理层面上，这二者一直都一套完美的融合方案。

直到Spring Cloud Alibaba的出现，才得以解决这样的问题。在以前的教程中，咱们已经介绍过使用Spring Cloud Alibaba中的Nacos来做为服务注册中心，而且在此之下能够如传统的Spring Cloud应用同样地使用Ribbon或Feign来实现服务消费。这篇，咱们就来继续说说Spring Cloud Alibaba中特别支持的RPC方案：Dubbo。

入门案例

咱们先经过一个简单的例子，来直观地感觉Nacos服务注册中心之下，利用Dubbo来实现服务提供方与服务消费方。这里省略Nacos的安装与使用，若是对Nacos还不了解，能够查看本系列的使用Nacos实现服务注册与发现，下面就直接进入Dubbo的使用步骤。

构建服务接口

建立一个简单的Java项目，并在下面定义一个抽象接口，好比：

public interface HelloService {	
    String hello(String name);	
}

构建服务接口提供方

第一步：建立一个Spring Boot项目，在 pom.xml中引入第一步中构建的API包以及Spring Cloud Alibaba对Nacos和Dubbo的依赖，好比：

<dependencies>	
        <!-- 第一步中构建的API包 -->	
        <dependency>	
            <groupId>com.didispace</groupId>	
            <artifactId>alibaba-dubbo-api</artifactId>	
            <version>0.0.1-SNAPSHOT</version>	
        </dependency>	
        <dependency>	
            <groupId>org.springframework.boot</groupId>	
            <artifactId>spring-boot-starter-actuator</artifactId>	
        </dependency>	
        <dependency>	
            <groupId>org.springframework.boot</groupId>	
            <artifactId>spring-boot-starter-web</artifactId>	
        </dependency>	
        <dependency>        	
            <!--<groupId>com.alibaba.cloud</groupId>-->	
            <groupId>org.springframework.cloud</groupId>	
            <artifactId>spring-cloud-starter-dubbo</artifactId>	
        </dependency>	
        <dependency>	
            <groupId>org.springframework.cloud</groupId>	
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>	
        </dependency>	
        //...	
    </dependencies>

这里须要注意两点：

1. 必须包含 spring-boot-starter-actuator包，否则启动会报错。

2. spring-cloud-starter-dubbo包须要注意 groupId，根据具体使用的spring cloud alibaba版本依赖来肯定。

• 项目孵化期间，使用的 groupId为： org.springframework.cloud；

• 项目孵化以后，使用的 groupId修改成了 com.alibaba.cloud，因此用户须要注意是否使用正确。避免加载不到对应JAR包的问题。

第二步：实现Dubbo接口

@Service	
public class HelloServiceImpl implements HelloService {	
    @Override	
    public String hello(String name) {	
        return "hello " + name;	
    }	
}

注意：这里的 @Service注解不是Spring的，而是 org.apache.dubbo.config.annotation.Service注解。

第三步：配置Dubbo服务相关的信息，好比：

spring.application.name=alibaba-dubbo-server	
server.port=8001	
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848	
# 指定 Dubbo 服务实现类的扫描基准包	
dubbo.scan.base-packages=com.didispace.alibaba.dubbo.server	
dubbo.protocol.name=dubbo	
dubbo.protocol.port=-1	
dubbo.registry.address=spring-cloud://localhost

配置说明以下：

• dubbo.scan.base-packages: 指定 Dubbo 服务实现类的扫描基准包

• dubbo.protocol: Dubbo 服务暴露的协议配置，其中子属性 name 为协议名称，port 为协议端口（ -1 表示自增端口，从 20880 开始）

• dubbo.registry: Dubbo 服务注册中心配置，其中子属性 address 的值 "spring-cloud://localhost"，说明挂载到 Spring Cloud 注册中心

注意：若是使用Spring Boot 2.1及更高版本时候，须要增长配置 spring.main.allow-bean-definition-overriding=true

第四步：建立应用主类，好比：

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

构建服务接口消费方

第一步：建立一个Spring Boot项目，在 pom.xml中引入第一步中构建的API包以及Spring Cloud Alibaba对Nacos和Dubbo的依赖，具体内容与服务提供方一致：

<dependencies>	
        <!-- 第一步中构建的API包 -->	
        <dependency>	
            <groupId>com.didispace</groupId>	
            <artifactId>alibaba-dubbo-api</artifactId>	
            <version>0.0.1-SNAPSHOT</version>	
        </dependency>	
        <dependency>	
            <groupId>org.springframework.boot</groupId>	
            <artifactId>spring-boot-starter-actuator</artifactId>	
        </dependency>	
        <dependency>	
            <groupId>org.springframework.boot</groupId>	
            <artifactId>spring-boot-starter-web</artifactId>	
        </dependency>	
        <dependency>        	
            <!--<groupId>com.alibaba.cloud</groupId>-->	
            <groupId>org.springframework.cloud</groupId>	
            <artifactId>spring-cloud-starter-dubbo</artifactId>	
        </dependency>	
        <dependency>	
            <groupId>org.springframework.cloud</groupId>	
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>	
        </dependency>	
        //...	
    </dependencies>

第二步：配置Dubbo服务相关的信息，好比：

spring.application.name=alibaba-dubbo-client	
server.port=8002	
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848	
dubbo.protocol.name=dubbo	
dubbo.protocol.port=-1	
dubbo.registry.address=spring-cloud://localhost	
dubbo.cloud.subscribed-services=alibaba-dubbo-server

注意：

1. 这里多增长了 dubbo.cloud.subscribed-services参数，表示要订阅服务的服务名，这里配置的 alibaba-dubbo-server对应的就是上一节服务提供方的 spring.application.name的值，也就是服务提供方的应用名。

2. 若是使用Spring Boot 2.1及更高版本时候，须要增长配置 spring.main.allow-bean-definition-overriding=true。

第三步：建立应用主类，并实现一个接口，在这个接口中调用Dubbo服务，好比：

@EnableDiscoveryClient	
@SpringBootApplication	
public class DubboClientApplication {	
    public static void main(String[] args) {	
        SpringApplication.run(DubboClientApplication.class, args);	
    }	
    @Slf4j	
    @RestController	
    static class TestController {	
        @Reference	
        HelloService helloService;	
        @GetMapping("/test")	
        public String test() {	
            return helloService.hello("didispace.com");	
        }	
    }	
}

注意：这里的 @Reference注解是 org.apache.dubbo.config.annotation.Reference

测试验证

完成了上面的全部开发以后，咱们能够将Nacos、服务提供者、服务消费者依次启动起来。在完成启动以后，咱们能够在Nacos控制台的服务列表中看到上面定义的两个服务，好比：

接下来，咱们就能够经过调用服务消费者中定义的 /test接口来触发dubbo服务的消费了。若是一切顺畅，应该能够获得以下结果：

$ curl localhost:8002/test	
hello didispace.com

小结

经过上面的例子，若是你曾经同时玩过Spring Cloud和Dubbo，必定会深有感触。你不用再同时顾虑Eureka和Zookeeper的配置，也不一样同时关注这两个中间件的健康，只须要关注和维护好Nacos一个便可。而对于Dubbo的配置和使用来讲，配置仍是至关简单的，而代码编写上与以往的Dubbo没什么大的不一样。在Spring Cloud Alibaba的整合之下，Dubbo用户既能够享受到本来RPC带来性能优点，又能够更好的享受Spring Cloud的各类福利；而对于Spring Cloud用户来讲，在服务治理层面，又对了一个不错的可选项。能够说这块的整合是真正的让这两大用户群体获得了很好的融合，起到了互相成就的做用。更多关于Spring Cloud与Spring Cloud Alibaba教程内容可点击查看。

参考资料：官方文档

代码示例

本文介绍内容的客户端代码，示例读者能够经过查看下面仓库中的 alibaba-dubbo-api、 alibaba-dubbo-server、 alibaba-dubbo-client项目：

• Github：https://github.com/dyc87112/SpringCloud-Learning/

• Gitee：https://gitee.com/didispace/SpringCloud-Learning/