上一篇文章講解了Spring Cloud 整合 nacos 實(shí)現(xiàn)服務(wù)注冊(cè)與發(fā)現(xiàn)，nacos除了有服務(wù)注冊(cè)與發(fā)現(xiàn)的功能，還有提供動(dòng)態(tài)配置服務(wù)的功能。本文主要講解Spring Cloud 整合nacos實(shí)現(xiàn)動(dòng)態(tài)配置服務(wù)。主要參考官方部署手冊(cè)點(diǎn)我。

前提條件

先下載nacos并啟動(dòng)nacos服務(wù)。操作步驟詳見Nacos 快速入門。

整合步驟

1. 添加依賴

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2.2.7.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.2.12.RELEASE</version>
</dependency>

版本nacos2.1.x.RELEASE 對(duì)應(yīng)的是 Spring Boot 2.1.x 版本。版本 2.0.x.RELEASE 對(duì)應(yīng)的是 Spring Boot 2.0.x 版本，版本 1.5.x.RELEASE 對(duì)應(yīng)的是 Spring Boot 1.5.x 版本。版本不匹配的話，會(huì)出現(xiàn)很多莫名其妙的問題。nacos依賴版本要和nacos服務(wù)端版本要一致。

2. 新建 nacos 配置

在nacos控制臺(tái)添加配置列表：

設(shè)置dataId為nacos-config,文件后綴為Properties，設(shè)置內(nèi)容user.name=jack：

3. bootstrap.properties 配置

在application.yml同目錄下創(chuàng)建bootstrap.yml文件，并配置Nacos服務(wù)地址以及namespace(沒有就不需要配置)：

spring:
  application:
    name: nacos-config-client
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        namespace: 68468122-8955-45ee-a5b7-3d87972325b1

4. 配置dataId

dataId對(duì)應(yīng)步驟2里面的dataId，有兩種配置方式，一種是官方自動(dòng)構(gòu)建dataId ，另一種是指定dataId。

4.1 自動(dòng)配置 dataId

在Nacos Spring Cloud中，dataId的完整格式如下：

${prefix}-${spring.profiles.active}.${file-extension}

• prefix 默認(rèn)為 spring.application.name 的值，也可以通過配置項(xiàng) spring.cloud.nacos.config.prefix來配置。
• spring.profiles.active 即為當(dāng)前環(huán)境對(duì)應(yīng)的 profile。 注意：當(dāng) spring.profiles.active 為空時(shí)，對(duì)應(yīng)的連接符 - 也將不存在，dataId 的拼接格式變成 ${prefix}.${file-extension}
• file-exetension 為配置內(nèi)容的數(shù)據(jù)格式，可以通過配置項(xiàng) spring.cloud.nacos.config.file-extension 來配置。目前只支持 properties 和 yaml 類型。

比如項(xiàng)目名稱為nacos-config-client，當(dāng)前環(huán)境為test,格式文件為properties，那就需要新建一個(gè)dataId為nacos-config-client.properties配置。

4.2 手動(dòng)設(shè)置 dataId

在NacosConfigProperties類里面name字段就是配置dataId：

public class NacosConfigProperties {
  /**
	 * nacos config dataId name.
	 */
	private String name;
  //省略其他配置
}

在bootstrap.yml添加spring.cloud.nacos.config.name就可以設(shè)置dataId。

5.獲取數(shù)據(jù)

通過@Value就能獲取配置文件的數(shù)據(jù)：

@Component
@RefreshScope
public class TestConfig {

    @Value(value = "${user.name:null}")
    private String test;

    public String getTest(){
        return test;
    }

要實(shí)現(xiàn)配置的自動(dòng)更新，需要添加Spring Cloud原生注解 @RefreshScope。controller直接調(diào)用即可:

@RestController
public class TestController {

    @Autowired
    private TestConfig testConfig;

    @GetMapping("/config")
    public String testConfig(){
        String config = testConfig.getTest();
        return config;
    }
}

如果想通過@NacosValues注解獲取數(shù)據(jù)，需要引入nacos-config-spring-boot-starter依賴：

<dependency>
    <groupId>com.alibaba.boot</groupId>
    <artifactId>nacos-config-spring-boot-starter</artifactId>
    <version>0.2.7</version>
</dependency>

總結(jié)

• nacos-config配置首先添加spring-cloud-starter-alibaba-nacos-config依賴。
• 在配置列表添加配置
• bootstrap.properties添加nacos server地址和namespace
• 配置dataId有兩種方式
  • 手動(dòng)配置，配置spring.cloud.nacos.config.name
  • 自動(dòng)配置，根據(jù)${prefix}-${spring.profiles.active}.${file-extension}規(guī)則配置，其中prefix為項(xiàng)目名稱，spring.profiles.active為項(xiàng)目運(yùn)行環(huán)境，file-extension配置內(nèi)容的數(shù)據(jù)格式。
• 通過@Value(value = "${user.name:null}")設(shè)置在字段上就能獲取到屬性，要實(shí)現(xiàn)自動(dòng)更新配置需要添加@RefreshScope注解。

源碼

Github源碼

參考文獻(xiàn)

Nacos 融合 Spring Cloud，成為注冊(cè)配置中心

nacos屬性值@Value自動(dòng)刷新

到此這篇關(guān)于Spring Cloud 整合 nacos 實(shí)現(xiàn)動(dòng)態(tài)配置中心的文章就介紹到這了,更多相關(guān)Spring Cloud 整合 nacos內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論