Spring boot集成Nacos-配置中心详解

向右看齐 2022-02-19 01:45 213阅读 0赞

该文档是基于spring cloud版本进行开发。

Nacos持久化可以参考：[https://mp.weixin.qq.com/s/6khhRU46J2kFJKUBuDyTGQ][https_mp.weixin.qq.com_s_6khhRU46J2kFJKUBuDyTGQ]

# 项目集成 #

## 依赖 ##

最新版本可以参考https://github.com/spring-cloud-incubator/spring-cloud-alibaba/releases

<dependency>
    	<groupId>org.springframework.cloud</groupId>
    	<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>

## 配置文件 ##

这里有两个坑：1、配置文件必须是bootstrip.properties或者bootstrip.yml，如果配置application.properties或者application.yml会导致加载不到配置；2、spring.cloud.nacos.config.namespace如果是默认的Public，则不需填写，否则获取不到配置信息

#指定开发环境
    spring.profiles.active=dev
    #服务器地址
    spring.cloud.nacos.config.server-addr=127.0.01:8848
    #默认为Public命名空间,不需要写，如果加上的话会导致加载不到配置文件
    spring.cloud.nacos.config.namespace=686b723d-e1e6-4f6a-ba2b-cdee09dc8dae
    #文件名 -- 如果没有配置则默认为 ${spring.appliction.name}
    spring.cloud.nacos.config.prefix=dhap
    #指定文件后缀
    spring.cloud.nacos.config.file-extension=yaml
    #指定分组信息
    spring.cloud.nacos.config.group=AAA

# Nacos配置 #

## 命名空间 ##

nacos使用namespace进行环境隔离，可以指定不同的环境，更好的管理开发、测试、生产的配置文件管理  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70]

## 资源配置 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 1]

### Data ID ###

Data ID的格式如下:

参考：[https://nacos.io/zh-cn/docs/quick-start-spring-cloud.html][https_nacos.io_zh-cn_docs_quick-start-spring-cloud.html]

`${prefix}-${spring.profile.active}.${file-extension}`

*  prefix 默认为 [spring.application.name][] 的值，也可以通过配置项 `spring.cloud.nacos.config.prefix`来配置。
 *  spring.profile.active 即为当前环境对应的 profile。 注意：当 `spring.profile.active` 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成 `${prefix}.${file-extension}`。
 *  file-exetension 为配置内容的数据格式，可以通过配置项 `spring.cloud.nacos.config.file-extension`来配置。目前只支持 properties 和 yaml 类型。

### Group ###

默认为DEFAULT\_GROUP,可以对不同类型的微服务配置文件进行分组管理。配置文件通过`spring.cloud.nacos.config.group=AAA`来指定。

### 配置内容 ###

配置文件格式支持一下几种TEXT、JSON、XML、YAML、HTML、Properties

## 配置操作 ##

### 历史版本 ###

资源文件每次修改都会记录一个历史版本，历史记录默认保存时间为30天，可以根据历史记录看到每次更新的内容。还可以让指定的记录文件回滚至上一个版本。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 2]

### 监听查询 ###

可以监听每个具体资源文件由哪些ip进行访问  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 3]

# 项目示例 #

启动类

@SpringBootApplication(scanBasePackages= {"com.dhap"})
    @EnableDiscoveryClient
    public class Application {
        public static void main(String [] args){
        	SpringApplication.run(Application.class, args);
        }
    }

调用示例  
要实现配置文件实时生效需要加注解:`@RefreshScope`

@RequestMapping("/test")
    @RestController
    @RefreshScope
    public class TestController  {
    
    	@Autowired
    	private TestService<Test> tsService;
    
        @GetMapping("/nacos")
    	public String get() {
    		return test;
    	}
    
        @Value(value = "${test}")
    	private String test;
    
    	}

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 4]

[https_mp.weixin.qq.com_s_6khhRU46J2kFJKUBuDyTGQ]: https://mp.weixin.qq.com/s/6khhRU46J2kFJKUBuDyTGQ
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70]: /images/20220219/99dde43ae54a47b8a08639d4d65094f9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 1]: /images/20220219/03fa1bc441bf42febd5ba53039e132de.png
[https_nacos.io_zh-cn_docs_quick-start-spring-cloud.html]: https://nacos.io/zh-cn/docs/quick-start-spring-cloud.html
[spring.application.name]: http://spring.application.name
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 2]: /images/20220219/a480c43278a845a4904c293b277fd4f1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 3]: /images/20220219/409fb1724c074ce19fdedd03ae007f31.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY2hhbmdiaW4xMjM_size_16_color_FFFFFF_t_70 4]: /images/20220219/67f100a353c44cfa8f8cdf9dc380e774.png