摘要：構(gòu)建服務(wù)接口創(chuàng)建一個(gè)簡單的項(xiàng)目，并在下面定義一個(gè)抽象接口，比如構(gòu)建服務(wù)接口提供方第一步創(chuàng)建一個(gè)項(xiàng)目，在中引入第一步中構(gòu)建的包以及對和的依賴，比如第一步中構(gòu)建的包這里需要注意兩點(diǎn)必須包含包，不然啟動(dòng)會(huì)報(bào)錯(cuò)。

很早以前，在剛開始搞Spring Cloud基礎(chǔ)教程的時(shí)候，寫過這樣一篇文章：《微服務(wù)架構(gòu)的基礎(chǔ)框架選擇：Spring Cloud還是Dubbo？》，可能不少讀者也都看過。之后也就一直有關(guān)于這兩個(gè)框架怎么選的問題出來，其實(shí)文中我有明確的提過，Spring Cloud與Dubbo的比較本身是不公平的，主要前者是一套較為完整的架構(gòu)方案，而Dubbo只是服務(wù)治理與RPC實(shí)現(xiàn)方案。

由于Dubbo在國內(nèi)有著非常大的用戶群體，但是其周邊設(shè)施與組件相對來說并不那么完善。很多開發(fā)者用戶又很希望享受Spring Cloud的生態(tài)，因此也會(huì)有一些Spring Cloud與Dubbo一起使用的案例與方法出現(xiàn)，但是一直以來大部分Spring Cloud整合Dubbo的使用方案都比較別扭。這主要是由于Dubbod的注冊中心采用了ZooKeeper，而開始時(shí)Spring Cloud體系中的注冊中心并不支持ZooKeeper，所以很多方案是存在兩個(gè)不同注冊中心的，之后即使Spring Cloud支持了ZooKeeper，但是由于服務(wù)信息的粒度與存儲(chǔ)也不一致。所以，長期以來，在服務(wù)治理層面上，這兩者一直都一套完美的融合方案。

直到Spring Cloud Alibaba的出現(xiàn)，才得以解決這樣的問題。在之前的教程中，我們已經(jīng)介紹過使用Spring Cloud Alibaba中的Nacos來作為服務(wù)注冊中心，并且在此之下可以如傳統(tǒng)的Spring Cloud應(yīng)用一樣地使用Ribbon或Feign來實(shí)現(xiàn)服務(wù)消費(fèi)。這篇，我們就來繼續(xù)說說Spring Cloud Alibaba下額外支持的RPC方案：Dubbo。

我們先通過一個(gè)簡單的例子，來直觀地感受Nacos服務(wù)注冊中心之下，利用Dubbo來實(shí)現(xiàn)服務(wù)提供方與服務(wù)消費(fèi)方。這里省略Nacos的安裝與使用，如果對Nacos還不了解，可以查看本系列的使用Nacos實(shí)現(xiàn)服務(wù)注冊與發(fā)現(xiàn)，下面就直接進(jìn)入Dubbo的使用步驟。

創(chuàng)建一個(gè)簡單的Java項(xiàng)目，并在下面定義一個(gè)抽象接口，比如：

public interface HelloService {

    String hello(String name);

}

第一步：創(chuàng)建一個(gè)Spring Boot項(xiàng)目，在pom.xml中引入第一步中構(gòu)建的API包以及Spring Cloud Alibaba對Nacos和Dubbo的依賴，比如：

    
        
        
            com.didispace
            alibaba-dubbo-api
            0.0.1-SNAPSHOT
        
        
            org.springframework.boot
            spring-boot-starter-actuator
        
        
            org.springframework.boot
            spring-boot-starter-web
        
                
            
            org.springframework.cloud
            spring-cloud-starter-dubbo
        
        
            org.springframework.cloud
            spring-cloud-starter-alibaba-nacos-discovery
        

        //...
    

這里需要注意兩點(diǎn)：

必須包含spring-boot-starter-actuator包，不然啟動(dòng)會(huì)報(bào)錯(cuò)。

spring-cloud-starter-dubbo包需要注意groupId，根據(jù)具體使用的spring cloud alibaba版本依賴來確定。

項(xiàng)目孵化期間，使用的groupId為：org.springframework.cloud；

項(xiàng)目孵化之后，使用的groupId修改為了com.alibaba.cloud，所以用戶需要注意是否使用正確。避免加載不到對應(yīng)JAR包的問題。

第二步：實(shí)現(xiàn)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服務(wù)相關(guān)的信息，比如：

spring.application.name=alibaba-dubbo-server
server.port=8001

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

# 指定 Dubbo 服務(wù)實(shí)現(xiàn)類的掃描基準(zhǔn)包
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 服務(wù)實(shí)現(xiàn)類的掃描基準(zhǔn)包

dubbo.protocol: Dubbo 服務(wù)暴露的協(xié)議配置，其中子屬性 name 為協(xié)議名稱，port 為協(xié)議端口（ -1 表示自增端口，從 20880 開始）

dubbo.registry: Dubbo 服務(wù)注冊中心配置，其中子屬性 address 的值 "spring-cloud://localhost"，說明掛載到 Spring Cloud 注冊中心

注意：如果使用Spring Boot 2.1及更高版本時(shí)候，需要增加配置spring.main.allow-bean-definition-overriding=true

第四步：創(chuàng)建應(yīng)用主類，比如：

@EnableDiscoveryClient
@SpringBootApplication
public class DubboServerApplication {

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

}

第一步：創(chuàng)建一個(gè)Spring Boot項(xiàng)目，在pom.xml中引入第一步中構(gòu)建的API包以及Spring Cloud Alibaba對Nacos和Dubbo的依賴，具體內(nèi)容與服務(wù)提供方一致：

    
        
        
            com.didispace
            alibaba-dubbo-api
            0.0.1-SNAPSHOT
        
        
            org.springframework.boot
            spring-boot-starter-actuator
        
        
            org.springframework.boot
            spring-boot-starter-web
        
                
            
            org.springframework.cloud
            spring-cloud-starter-dubbo
        
        
            org.springframework.cloud
            spring-cloud-starter-alibaba-nacos-discovery
        

        //...
    

第二步：配置Dubbo服務(wù)相關(guān)的信息，比如：

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

注意：

這里多增加了dubbo.cloud.subscribed-services參數(shù)，表示要訂閱服務(wù)的服務(wù)名，這里配置的alibaba-dubbo-server對應(yīng)的就是上一節(jié)服務(wù)提供方的spring.application.name的值，也就是服務(wù)提供方的應(yīng)用名。

如果使用Spring Boot 2.1及更高版本時(shí)候，需要增加配置spring.main.allow-bean-definition-overriding=true。

第三步：創(chuàng)建應(yīng)用主類，并實(shí)現(xiàn)一個(gè)接口，在這個(gè)接口中調(diào)用Dubbo服務(wù)，比如：

@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

完成了上面的所有開發(fā)之后，我們可以將Nacos、服務(wù)提供者、服務(wù)消費(fèi)者依次啟動(dòng)起來。在完成啟動(dòng)之后，我們可以在Nacos控制臺(tái)的服務(wù)列表中看到上面定義的兩個(gè)服務(wù)，比如：

接下來，我們就可以通過調(diào)用服務(wù)消費(fèi)者中定義的/test接口來觸發(fā)dubbo服務(wù)的消費(fèi)了。如果一切順暢，應(yīng)該可以得到如下結(jié)果：

$ curl localhost:8002/test
hello didispace.com

通過上面的例子，如果你曾經(jīng)同時(shí)玩過Spring Cloud和Dubbo，一定會(huì)深有感觸。你不用再同時(shí)顧慮Eureka和Zookeeper的配置，也不同同時(shí)關(guān)注這兩個(gè)中間件的健康，只需要關(guān)注和維護(hù)好Nacos一個(gè)即可。而對于Dubbo的配置和使用來說，配置還是相當(dāng)簡單的，而代碼編寫上與以往的Dubbo沒什么大的不同。在Spring Cloud Alibaba的整合之下，Dubbo用戶既可以享受到原本RPC帶來性能優(yōu)勢，又可以更好的享受Spring Cloud的各種福利；而對于Spring Cloud用戶來說，在服務(wù)治理層面，又對了一個(gè)不錯(cuò)的可選項(xiàng)?？梢哉f這塊的整合是真正的讓這兩大用戶群體得到了很好的融合，起到了互相成就的作用。更多關(guān)于Spring Cloud與Spring Cloud Alibaba教程內(nèi)容可點(diǎn)擊查看。

參考資料：官方文檔

本文介紹內(nèi)容的客戶端代碼，示例讀者可以通過查看下面?zhèn)}庫中的alibaba-dubbo-api、alibaba-dubbo-server、alibaba-dubbo-client項(xiàng)目：

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

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

如果您對這些感興趣，歡迎star、follow、收藏、轉(zhuǎn)發(fā)給予支持！> 歡迎關(guān)注我的公眾號：程序猿DD，獲得獨(dú)家整理的學(xué)習(xí)資源和日常干貨推送。如果您對我的專題內(nèi)容感興趣，也可以關(guān)注我的博客：didispace.com