导入依赖
这里导入的依赖很有讲究,你是啥springboot版本,然后下面的配置值就是啥,我也是醉啦。
<!-- Spring Boot 启动父依赖 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.6.RELEASE</version>
</parent>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
<version>2.2.6.RELEASE</version>
</dependency>
创建命名空间
"命名空间"视为项目。
下载好nacos服务器,启动 nacos服务器后,创建第一个命名空间"MY_PROJECT"。
这个命名空间专门用于给"MY_PROJECT"项目使用,刚创建的命名空间的ID是"3dab7b44-83fa-429a-8496-528986c6f54a",待会需要代码中需要这个参数。
创建启动分支分组
项目的配置文件空间创建好了,下一步就是创建不同的开发分支。正常会有dev、test、pro分支。
这个分支在nacos中对应的概念就是"Group"。
如下图,我们点击"MY_PROJECT",到我们这个项目的统一配置中心来。
我们创建dev环境的分组。创建dataId为 "demo.properties",group是dev的第一个配置文件。配置文件的内容是指定端口为8081,就像我们在以前的application.yaml中配置的那样。顺带再设置一个常量"author",如下图所示。
?
配置完返回并查看,MY_PROJECT命名空间下,我们就配置好了一个dataId是demo.properties的配置文件,且该配置文件属于分组dev,我们把它设计为开发环境需要的参数。未来可以增加更多的分组对应不同的环境,例如test环境、pro环境。
该demo.properties文件的内容很简单,就是"server.port=8081",还有"author=dayu"
代码接入nacos
我们创建一个bootstrap.properties文件,它的加载优先级会比较高。
spring.application.name=demo,设计我们的项目名称时"demo"。另外配置文件的文件后缀设计为"properties"。因此nacos的配置文件连接起来为 demo.properties,对应的是"DataID"。
spring.cloud.nacos.config.group=dev。因此对应nacos的配置文件的?Group为dev,对应的是"Group"。
#服务器地址
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
#项目的命名空间的ID,每个人的都不一样
spring.cloud.nacos.config.namespace=3dab7b44-83fa-429a-8496-528986c6f54a
#当前启动分支分组
spring.cloud.nacos.config.group=dev
#配置文件的文件后缀
spring.cloud.nacos.config.fileExtension=properties
#项目名称
spring.application.name=demo
?启动项目:
控制台打印:
?控制台说明加载dataId[demo],默认后缀是properties被省略掉了,group是dev。说明正确。
项目按照了8081端口启动,说明了我们已经读取到了nacos统一配置平台的配置。
?加载多个配置
在项目中创建application.yaml文件,增加启动分支的选择。
再次启动项目,除了之前based on dataId[demo] ,我们看到控制台上显示:based on dataId[demo-dev.properties] 。这就说明nacos根据启动分支,也尝试去读取?
${spring.application.name}-${启动分支}.${spring.cloud.nacos.config.fileExtension} ,即demo-dev.properties文件。
于是我们顺水推舟,在nacos上创建dataId为[demo-dev.properties] ,同时配置分组为dev,如下图,切记别忘了配置分组!!!
?返回并查看
代码验证
这里代码中需要加上 @RefreshScope 注解!!!
@RestController
@RequestMapping(value = "/")
@RefreshScope
public class HelloController {
@Value("${author}")
private String author; // 在demo.properties文件中配置了
@Value("${age}")
private String age; // 在demo-dev.properties文件中配置了
@GetMapping(value = "/hello")
public String function() {
return "hello " + author + ",your age is " + age;
}
}
看我的调用效果:
配置文件动态刷新
?在nacos上编辑demo-dev.properties文件,我们尝试修改age值
改成18岁,然后点击"发布"按钮,相当于重新刷新一下配置的值。
重新发布后,控制台上打印出?Refresh keys changed: [age] ,说明重新刷新了age的值。
再次访问,值就已经刷新啦!
?
更多的配置文件
目前我们的应用可以读取demo.properties文件与demo-dev.properties文件,如果想把更多的配置文件加入到nacos中,应该怎么读取呢?
假设我们有一个数据库的配置要抽出来单独放到 database.yaml中。我们可以这样配。
配置内容如下:
spring:
datasource:
mysql:
driver-class-name: com.mysql.cj.jdbc.Driver
配置好了以后,怎么让项目启动的时候读取这个database.yaml,且分组时common的配置文件呢?
我们在bootstrap.properties文件中增加这段配置。
#额外的配置文件
#额外的第一个配置文件的dataId
spring.cloud.nacos.config.extension-configs[0].data-id=database.yaml
#额外的第一个配置文件的分组
spring.cloud.nacos.config.extension-configs[0].group=common
#开启自动刷新
spring.cloud.nacos.config.extension-configs[0].refresh=true
#额外的第二个配置文件只需要改变角标即可
#spring.cloud.nacos.config.extension-configs[1].data-id=database.yaml
#spring.cloud.nacos.config.extension-configs[1].group=common
#spring.cloud.nacos.config.extension-configs[1].refresh=true
测试Controller代码如下:
@RestController
@RequestMapping(value = "/")
@RefreshScope
public class DBController {
@Value("${spring.datasource.mysql.driver-class-name}")
private String driver;
@GetMapping(value = "/db")
public String function() {
return driver;
}
}
?浏览器访问查看,读取到了我们在nacos中的database.yaml中的${spring.datasource.mysql.driver-class-name} 配置的值。嘎嘎。
?
总结?
你真是太棒啦!这是伟大的第一步,我们终于成功入门了nacos!
如果本文对你有帮助,不妨请作者大宇喝瓶可乐吧!
你的打赏是对我最好的支持!
?? ? ? ? ? ? ? ? ? ?
|