Spring Boot 2.x 基礎案例：整合Dubbo 2.7.3+Nacos1.1.3（配置中心）

時間 2019-11-20

標籤 spring boot 2.x 基礎案例整合 dubbo 2.7.3+nacos1.1.3 nacos 配置中心欄目 Spring 简体版

原文原文鏈接

本文原創首發於公衆號：Java技術乾貨java

一、概述

本文將Nacos做爲配置中心，實現配置外部化，動態更新。這樣作的優勢：不須要重啓應用，即可以動態更新應用裏的配置信息。在現在流行的微服務應用下，將應用的配置統一管理，顯得尤其重要。git

上一篇寫了《Spring Boot 2.x 基礎案例：整合Dubbo 2.7.3+Nacos1.1.3（最新版）》https://www.jianshu.com/p/b0dddce1d404，在文章中，nacos的角色是註冊中心。github

本文也是在上一篇的基礎上，繼續學習和研究以Dubbo爲微服務框架，nacos做爲配置中心，應該如何進行實踐。以及在此過程當中，遇到了什麼樣的問題，如何解決。web

二、nacos的必知必會

在進行編碼以前，先看看當nacos做爲配置中心時，操做界面是啥，有哪些新的知識點，須要咱們先去了解和掌握呢？以避免，在後面搭建環境時，全程懵逼。

spring

重要參數說明apache

Data Id

Data Id的默認值爲${nacos.config.prefix}-${spring.profile.active}.${nacos.config.file-extension}
nacos.config.prefix的默認值爲${spring.application.name}
nacos.config.file-extension的默認值爲properties
當spring.profiles.active未配置時，則匹配${spring.application.name}.properties
若設置了spring.profiles.active而Nacos中存在${spring.application.name}.properties時，若還存在${spring.application.name}-${spring.profiles.active}.properties，則默認匹配後者，若不存在，則會自動匹配前者
因爲Nacos建議且默認用spring.application.name做爲Data Id的前綴，若要在不一樣服務中共享項目統一配置，則能夠經過配置nacos.config.shared-dataids或nacos.config.refreshable-dataids來添加共享配置，前者不支持自動刷新，後者支持

Group

這是一個很靈活的配置項，並無固定的規定，能夠用做多環境、多模塊、多版本之間區分配置

Namespace

推薦使用命名空間來區分不一樣環境的配置，由於使用profiles或group會是不一樣環境的配置展現到一個頁面，而Nacos控制檯對不一樣的Namespace作了Tab欄分組展現，以下圖：

注意配置Namespace的時候不是經過名稱，而是經過命名空間的ID(上圖所示)，可經過以下配置來設置服務使用的命名空間：

nacos:
  service-address: 127.0.0.1
  port: 8848
  config:
    server-addr: ${nacos.service-address}:${nacos.port}
    namespace: 9af36d59-2efd-4f43-8a69-82fb37fc8094  # 命名空間ID 不是命名空間名稱

三、基礎框架搭建

個人建議，儘量本身花點時間，在不熟悉的狀況下，儘可能按照本身的想法思路，從零開始搭建一下，加深印象。在搭建過程當中，可能會遇到問題，此時不要慌（嘴上不說，內心卻慌得狠）。但幸運的是，你遇到了我，能夠聯繫，留言或關注我，一塊兒交流。api

爲了避免形成知識點的混淆，我將spring-boot-dubbo-nacos-demo的maven工程，源代碼已同步於github，從新拷貝一份，項目從新命名爲spring-boot-dubbo-nacos-configcenter-demo。
app

直接拷貝過來，項目名變動，對應的pom.xml還須要修改一下

修改shop-service-provider和shop-service-consumer:的pom.xml

框架

按照上一篇文章的六、測試，看一下項目是否能正常啓動，若是正常，咱們在開始整合nacos的配置中心。確保前面的功能都是正常的。maven

四、pom.xml說明

若是想nacos做爲配置中心，須要在對應的maven工程中引入nacos-config-spring-boot-starter的依賴包，這裏，將此依賴包在shop-service-provider和shop-service-consumer的項目中同時引入，這樣能夠方便服務提供者和服務消費者之間的測試。

這裏就不把pom.xml的代碼所有粘貼出來，你們想看的話，能夠去上一篇文章中看。

pom.xml新增nacos-config-spring-boot-starter依賴

<!-- nacos config依賴 -->
        <dependency>
            <groupId>com.alibaba.boot</groupId>
            <artifactId>nacos-config-spring-boot-starter</artifactId>
            <version>0.2.3</version>
        </dependency>

五、配置文件說明

shop-service-provider和shop-service-consumer的application.yml，增以下配置，啓動項目，會和nacos建立鏈接

nacos:
  service-address: 127.0.0.1
  port: 8848
  config:
    server-addr: ${nacos.service-address}:${nacos.port}

相關配置參數，請參考com.alibaba.boot.nacos.config.properties.NacosConfigProperties.java

六、編寫業務代碼

6.一、shop-service-provider增長配置實體類NacosConfig.java

NacosConfig.java代碼實現：

package cn.raysonblog.shopserviceprovider.config;

import com.alibaba.nacos.api.config.annotation.NacosValue;
import com.alibaba.nacos.spring.context.annotation.config.NacosPropertySource;
import lombok.Data;
import org.springframework.stereotype.Component;

/**
 * 從Nacos外部拉取配置, 修改配置，自動會刷新應用的配置
 *
 * @author raysonfang
 */
@NacosPropertySource(dataId = "rayson", autoRefreshed = true)
@Data
@Component
public class NacosConfig {

    @NacosValue(value = "${service.name:1}", autoRefreshed = true)
    private String serviceName;
}

註解說明：
@NacosPropertySource註解其中包含兩個屬性，以下：

dataId：這個屬性是須要在Nacos中配置的Data Id。
autoRefreshed：爲true的話開啓自動更新。

在使用Nacos作配置中心後，須要使用@NacosValue註解獲取配置，使用方式與@Value同樣。

其中${service.name:1}的service.name是屬性key, 1是默認值。

6.二、shop-service-provider將NacosConfig的信息暴露到接口中獲取

package cn.raysonblog.shopserviceprovider.service.impl;

import cn.raysonblog.shopserviceprovider.config.NacosConfig;
import cn.raysonblog.shopserviceprovider.service.RpcShopService;
import org.apache.dubbo.config.annotation.Service;
import org.springframework.beans.factory.annotation.Autowired;

/**
 * 接口實現類
 *
 * ## @Service 這個註解是使用dubbo提供的，
 *             這個註解中有不少屬性，須要單獨瞭解去進行配置
 *
 * @author raysonfang
 */
@Service
public class ShopServiceImpl implements RpcShopService {

    @Autowired
    NacosConfig nacosConfig;

    public String sayHello(String name) {
        return name;
    }

    /**
     * 將nacos config的配置信息暴露給服務消費者
     * @param desc
     * @return
     */
    public String getConfigServiceName(String desc){
        return nacosConfig.getServiceName()+desc;
    }
}

RpcShopService.java接口新增getConfigServiceName()方法

package cn.raysonblog.shopserviceprovider.service;

/**
 * 提供暴露的Rpc接口
 * @author raysonfang
 */
public interface RpcShopService {
    String sayHello(String name);
    String getConfigServiceName(String desc);
}

6.三、shop-service-consumer新增接口方法`/getConfig`

package cn.raysonblog.shopserviceconsumer;

import cn.raysonblog.shopserviceprovider.service.RpcShopService;
import org.apache.dubbo.config.annotation.Reference;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

/**
 *
 * 把主類和controller寫在一塊兒，方便簡單測試演示。
 *
 * @author raysonfang
 */
@SpringBootApplication
@RestController
public class ShopServiceConsumerApplication {
    @Reference
    RpcShopService shopService;

    /**
     * 註釋緣由： 在主應用入口，只運行有一個RequestMapping 不然會報錯。
     */
  /*  @RequestMapping(name = "/sayHello", method = RequestMethod.GET)
    public String sayHello(){
        return shopService.sayHello("Hello Dubbo Nacos!更多原創分享，技術交流，關注：Java技術乾貨（ID:raysonfang）");
    }*/

    /**
     * Nacos config配置中心 獲取配置信息 測試接口
     * @return
     */
    @RequestMapping(name = "/getConfig", method = RequestMethod.GET)
    public String getConfig(){
        return shopService.getConfigServiceName("更多原創分享，技術交流，關注：Java技術乾貨（ID:raysonfang）");
    }

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

}