【Java项目】从0到1完成Nacos配置文件扩展和共享

简介: 【Java项目】从0到1完成Nacos配置文件扩展和共享

使用nacos作用配置中心的好处在于我们可以在云端上修改配置文件之后,使得本地的配置重新生效,从而做到不用重启项目也可以加载新的配置。

环境配置

首先引入依赖,我们知道,SpringBoot的版本和SpringCloud以及SpringCloudAlibaba的版本是有对应关系的,也就是使用对应的关系,能减少bug的出现。

下面配置文件中的前三行我先列出了我的版本。

配置完毕版本之后,首先需要引入Spring-boot-starter-web,否则使用Nacos将会失效。

然后,如果你的项目需要将服务注册到注册中心,那么就需要引入discovery这个依赖,他是服务发现依赖,而如果你不需要进行服务注册,则不需要引入这个依赖。

config这个依赖则是使用nacos的配置中心,所以这个依赖我们需要引入。

<spring-boot.version>2.3.7.RELEASE</spring-boot.version>
        <spring-cloud.version>Hoxton.SR9</spring-cloud.version>
        <spring-cloud-alibaba.version>2.2.6.RELEASE</spring-cloud-alibaba.version>
        <!-- Spring Boot 的 Spring Web MVC 集成 -->
       <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
     <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>

配置文件

#微服务配置
spring:
  application:
    name: towelove
  cloud:
    nacos:
      server-addr: 192.168.146.114:8848
      discovery: # 开启服务发现
        namespace: 默认public
        group: 默认为DEFAULT_GROUP
      config: # 开启配置中心
        namespace: 默认public
        group: 默认为DEFAULT_GROUP
        file-extension: yaml # 配置文件类型
        refresh-enabled: true # 开启动态刷新
  #profiles默认为dev
  profiles:
    active: dev

上面的代码比较好理解,spring.application.name是必须的,他代表了这个服务的服务名称,spring.profiles.active就是你的开发环境,比如dev开发,prod生产,test测试环境。

到目前位置我们看上去好像没有映入任何的配置文件对吗?

其实不是的,Nacos默认此时已经去寻找了一个dataId如下的配置文件:

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

prefix 默认为 spring.application.name 的值,也可以通过配置项 spring.cloud.nacos.config.prefix来配置。

spring.profiles.active 即为当前环境对应的 profile,详情可以参考 Spring Boot文档。 注意:当 spring.profiles.active 为空时,对应的连接符 - 也将不存在,

dataId 的拼接格式变成{prefix}-{file-extension}

file-exetension 为配置内容的数据格式,可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。

所以,以上面的为例,此时这个服务一旦启动,就会先去配置中心中查找一个叫做

towelove-dev.yaml的配置文件。如果找到了就加载,没找到就不加载。

到此为止,我们已经简单的完成了一个服务的注册,下面我们讲解一下比较重要的概念。

名称空间和组

我们还需要知道nacos如何去定位一个具体的配置文件,即配置的三要素:namespace、group、dataid.

1、通过namespace、group找到具体的环境和具体的项目。

2、通过dataid找到具体的配置文件,dataid有三部分组成,

比如:towelove-dev.yaml配置文件 由(towelove)-(dev). (yaml)三部分组成

towelove:第一部分,它是在application.yaml中配置的应用名,即spring.application.name的值。

dev:第二部分,它是环境名,通过spring.profiles.active指定,

Yaml: 第三部分,它是配置文件 的后缀,目前nacos支持properties、yaml等格式类型,本项目选择yaml格式类型。

所以,如果我们要配置towelove工程的配置文件:

在开发环境中配置towelove-dev.yaml

在测试环境中配置towelove-test.yaml

在生产环境中配置towelove-prod.yaml

namespace和group

namespace:用于区分环境、比如:开发环境、测试环境、生产环境。

group:用于区分项目,比如:towelove项目、towelove2.0项目

我们可以创建一个名称空间,比如我们创建一个dev开发环境,注意,这里的dataId一定要自己去填写,不然你就得在上面配置文件的地方自己复制过来她随机给你生成的dataId了!!

创建完毕名称空间之后,我们就可以在对应的名称空间下创建配置文件了。

当然,我这个项目并没有用到towelove-dev.yaml这个配置文件,我不太需要。因为我想尽可能确保见面知意。

上面我们已经说过,默认的group和namespace不定义的话,使用的就是DEFAULT_GROUP和默认的这个public这个namespace。当然,对于新手来说这样子最友好。

不过我们也可以简单的配置一下。也不难,如下:

对于group,你填写好你自己设定的group即可,

对于dataId,要注意的是一定要记得自己加上文件的后缀哦,如图。

上面的这张图片表示会选择namespace为dev,并且组为towelove-group的配置文件。

扩展配置

上面我们说过,一个服务启动的时候,默认会去寻找

$ {prefix}-$ {spring.profiles.active}.${file-extension}这个配置文件。

但是,作为SpringCloud项目,我们很可能会需要去引入其他模块的配置文件。

例如我的项目就是,controller层单独放了一个包,也就是提供API接口,而service以及下层,都放在另一个叫做service的包中,这样子,我就可以做到独立开发两个模块的功能了。

那么其实我们知道,controller层不再需要再一次引入mysql的配置,而只需要在service包中引入,因为我们的数据库操作都是在service完成开发和测试的,那么,service包中就会需要用到mysql的配置,而controller在启动的时候也需要。

那么,我们就可以让controller这个包去引入service的服务,同时他也会吧service包的配置文件一起读过来。

那么我们此时就可以让controller这个服务去扩展service的配置文件。

这个时候,只需要在towelove-service-dev.yaml中引入mysql的配置,那么我在做service的接口开发的时候能够成功,controller这个项目他也能成功运行。

共享配置文件

可以在上面的图中看到我用了一个shared-configs,他代表的其实就是多个项目之间都共同使用的一些配置文件。

比如,redis,rocketmq啊这些配置文件,他们都是共享的,那么我就可以使用共享配置文件的方式来引入他们。

这样子我就不需要重复编写配置文件了。

配置文件优先级

刚才说了dataid第一部分就是spring.application.name,nacos 客户端要根据此值确定配置文件 名称,所以spring.application.name不在nacos中配置,而是要在工程的本地进行配置。

本地配置文件现在是application.yaml需要修改为bootstrap.yaml,因为SpringBoot读取配置文件 的顺序如下:

因此,我们如果想要吧服务注册到Nacos,我们需要在bootstrap中配置nacos的地址。

同时,如果说我们的配置文件他们有相同的属性怎么办?谁的优先级更高?

我们引入配置文件的方式有:

1:以项目应用名引入

2:以扩展配置文件方式引入

3:以共享配置文件方式引入

4:本地配置文件

那么这些配置文件的优先级如下:

以项目应用名引入 > 以扩展配置文件方式引入 > 以共享配置文件方式引入 > 本地配置文件

如果本地优先级这么低的话,会让我们如果要启动多个服务的时候,不好修改端口,所以我们可以编写如下配置

spring.cloud.config.override-none=true

也就是关闭覆盖功能,这样子就能使得本地的配置文件不被覆盖


相关文章
|
22天前
|
存储 Java Android开发
java实战项目音乐管理系统
java实战项目音乐管理系统
|
22天前
|
Java
java实战项目超市管理系统控制台版
java实战项目超市管理系统控制台版
|
2天前
|
Java
解决IDEA打开java项目出现橙色j无法运行
解决IDEA打开java项目出现橙色j无法运行
5 0
|
5天前
|
Java 应用服务中间件 Docker
【Docker】部署启动java项目
【Docker】部署启动java项目
13 2
|
6天前
|
搜索推荐 前端开发 Java
java医院绩效考核管理系统项目源码
系统需要和his系统进行对接,按照设定周期,从his系统获取医院科室和医生、护士、其他人员工作量,对没有录入信息化系统的工作量,绩效考核系统设有手工录入功能(可以批量导入),对获取的数据系统按照设定的公式进行汇算,且设置审核机制,可以退回修正,系统功能强大,完全模拟医院实际绩效核算过程,且每步核算都可以进行调整和参数设置,能适应医院多种绩效核算方式。
10 0
|
6天前
|
前端开发 Java 测试技术
Java从入门到精通:4.1.1参与实际项目,锻炼编程与问题解决能力
Java从入门到精通:4.1.1参与实际项目,锻炼编程与问题解决能力
|
14天前
|
jenkins Java 持续交付
实战指南:运用Jenkins实现Java项目的持续集成与自动化部署
【4月更文挑战第17天】Jenkins是一款强大的开源CI/CD工具,广泛用于Java项目的自动化构建、测试和部署。通过配置Jenkins环境、创建Job、设定构建触发器和步骤,实现持续集成和部署。集成Maven、Git等工具,确保代码质量并加速上线。持续部署阶段,Jenkins可将工件发布至远程服务器或云环境,实现高效、稳定的自动化流程。实践过程中,关注工作流优化、配置备份和服务器状态监控,以提升整体开发效率和软件质量。
|
18天前
|
Java
Java配置大揭秘:读取自定义配置文件的绝佳指南
Java配置大揭秘:读取自定义配置文件的绝佳指南
17 0
Java配置大揭秘:读取自定义配置文件的绝佳指南
|
21天前
|
监控 数据可视化 安全
智慧工地SaaS可视化平台源码,PC端+APP端,支持二开,项目使用,微服务+Java++vue+mysql
环境实时数据、动态监测报警,实时监控施工环境状态,有针对性地预防施工过程中的环境污染问题,打造文明生态施工,创造绿色的生态环境。
15 0
智慧工地SaaS可视化平台源码,PC端+APP端,支持二开,项目使用,微服务+Java++vue+mysql
|
22天前
|
SQL Java Go
java项目超市购物管理系统
java项目超市购物管理系统