Spring Boot 配置中心与应用属性完美匹配 | 深入探究@ConfigurationProperties与@NacosPropertySource

本文主要是介绍Spring Boot 配置中心与应用属性完美匹配 | 深入探究@ConfigurationProperties与@NacosPropertySource,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

@ConfigurationProperties

@ConfigurationProperties 注解是 Spring Boot 中用于将外部配置文件(如 YAML 或 properties 文件)中的属性映射到 Java Bean 类属性的强大工具。

以下是关于 @ConfigurationProperties 注解与 YAML 配置文件属性匹配规则的详细说明:

前缀匹配:在 @ConfigurationProperties 注解中,通过 prefix 属性指定了配置文件中属性的前缀。Spring Boot 会查找所有以该前缀开头的属性,并将它们映射到 Java Bean 类的对应属性上。

驼峰命名规则:YAML 配置文件中的属性名通常使用短横线分隔单词(例如 my-property-name),而 Java Bean 类的属性名则遵循驼峰命名规则(例如 myPropertyName)。Spring Boot 会自动将短横线分隔的属性名转换为驼峰命名,并与 Java Bean 类的属性进行匹配。

属性类型转换:Spring Boot 会尝试自动将 YAML 配置文件中的属性值转换为 Java Bean 类属性的相应类型。例如,如果 YAML 文件中有一个字符串值,而 Java Bean 类中的属性是一个 int 类型,Spring Boot 会尝试进行类型转换。如果转换失败,将会抛出异常。

集合类型匹配:当 Java Bean 类的属性是集合类型(如 ListSetMap 等)时,Spring Boot 会尝试将 YAML 配置文件中的数组或列表语法映射到这些集合类型上。通过在 YAML 文件中使用列表(以 - 开头)或映射(key-value 对)语法,可以轻松地为集合类型的属性提供配置值。

默认值:您可以在 Java Bean 类的属性上设置默认值,这样即使 YAML 配置文件中没有指定该属性的值,Java Bean 类的属性也会使用这些默认值。此外,您还可以在 @ConfigurationProperties 注解中指定 ignoreUnknownFields 属性来控制是否忽略配置文件中的未知属性。

下面是一个简单的示例代码,演示了如何使用 @ConfigurationProperties 注解与 YAML 配置文件进行属性匹配:

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;import java.util.List;@Component
@ConfigurationProperties(prefix = "myapp")
public class MyAppProperties {private String appName;private int port;private List<String> servers;// 必须提供 getter 和 setter 方法,以便 Spring 能够注入属性值public String getAppName() {return appName;}public void setAppName(String appName) {this.appName = appName;}public int getPort() {return port;}public void setPort(int port) {this.port = port;}public List<String> getServers() {return servers;}public void setServers(List<String> servers) {this.servers = servers;}
}

假设在 application.yml 配置文件中定义了如下属性:

myapp:app-name: "My Application"port: 8080servers:- "server1"- "server2"- "server3"

通过以上配置,Spring Boot 会自动将 myapp.app-namemyapp.portmyapp.servers 的值注入到 MyAppProperties 类对应的属性中,无需编写任何额外的配置代码。这使得从配置文件中读取属性变得非常简单和直观。

@NacosPropertySource

@NacosPropertySource 是 Spring Cloud Alibaba Nacos Config 提供的一个注解,它允许开发者从 Nacos 配置中心加载配置,并将这些配置属性注入到 Spring 容器中。这个注解与 Nacos 配置中心中的配置文件有特定的匹配规则,同时它也可以与 @ConfigurationProperties@Value 注解一起使用,以便将配置属性映射到 Java 类中。

Nacos 配置文件命名规则
在 Nacos 配置中心,配置文件的命名通常遵循 {dataId}.{group} 的格式。其中,dataId 是配置的唯一标识符,用于区分不同的配置项;group 是配置的分组,用于对配置进行逻辑上的分类。

@NacosPropertySource 注解使用
在 Spring Boot 应用的启动类或配置类上,你可以使用 @NacosPropertySource 注解来指定要加载的 Nacos 配置文件的 dataIdgroup。这个注解告诉 Spring Boot 从 Nacos 配置中心加载指定的配置文件,并将其内容作为属性源添加到 Spring 环境中。

属性值注入

  • 使用 @Value 注解:你可以在 Java 类的字段上使用 @Value 注解,并通过 ${property.name} 的形式来引用 Nacos 配置中的属性。Spring Boot 会自动将这些属性注入到相应的字段中。

  • 使用 @ConfigurationProperties 注解:对于更复杂的配置,如包含多个属性的对象或集合,你可以使用 @ConfigurationProperties 注解。这个注解允许你将一组相关的配置属性绑定到一个 Java 类上。你需要在类上指定前缀(prefix),Spring Boot 会根据这个前缀从属性源中匹配对应的属性,并自动注入到类的字段中。

示例代码

首先,在 Nacos 配置中心创建一个配置文件,例如 example.properties,内容如下:

# example.properties
app.name=My Application
app.port=8080

然后,在一个配置类中使用 @Value@ConfigurationProperties 注解将属性值注入到 Java 类中:

使用 @Value 注解:

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;@Component
@NacosPropertySource(dataId = "example.properties", autoRefreshed = true)
public class MyAppProperties {@Value("${app.name}")private String appName;@Value("${app.port}")private int port;// 省略 getter 和 setter 方法
}

通过以上配置,Spring Boot 应用会从 Nacos 配置中心加载 example.properties 文件的配置,并将 app.nameapp.port 的值注入到相应的 Java 类中。当 Nacos 配置中心中的配置发生变化时,如果启用了配置刷新功能(通过 @RefreshScope),应用可以动态地更新这些配置。

注意:如果在配置类当中有配置值(java类),但是配置文件中也有值(yml文件或者nacos配置),会优先优先使用配置文件当中的值。

这篇关于Spring Boot 配置中心与应用属性完美匹配 | 深入探究@ConfigurationProperties与@NacosPropertySource的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!


原文地址:
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/832403

相关文章

nginx -t、nginx -s stop 和 nginx -s reload 命令的详细解析(结合应用场景)

《nginx-t、nginx-sstop和nginx-sreload命令的详细解析(结合应用场景)》本文解析Nginx的-t、-sstop、-sreload命令,分别用于配置语法检... 以下是关于 nginx -t、nginx -s stop 和 nginx -s reload 命令的详细解析,结合实际应

Spring boot整合dubbo+zookeeper的详细过程

《Springboot整合dubbo+zookeeper的详细过程》本文讲解SpringBoot整合Dubbo与Zookeeper实现API、Provider、Consumer模式,包含依赖配置、... 目录Spring boot整合dubbo+zookeeper1.创建父工程2.父工程引入依赖3.创建ap

Linux线程之线程的创建、属性、回收、退出、取消方式

《Linux线程之线程的创建、属性、回收、退出、取消方式》文章总结了线程管理核心知识:线程号唯一、创建方式、属性设置(如分离状态与栈大小)、回收机制(join/detach)、退出方法(返回/pthr... 目录1. 线程号2. 线程的创建3. 线程属性4. 线程的回收5. 线程的退出6. 线程的取消7.

Linux下进程的CPU配置与线程绑定过程

《Linux下进程的CPU配置与线程绑定过程》本文介绍Linux系统中基于进程和线程的CPU配置方法,通过taskset命令和pthread库调整亲和力,将进程/线程绑定到特定CPU核心以优化资源分配... 目录1 基于进程的CPU配置1.1 对CPU亲和力的配置1.2 绑定进程到指定CPU核上运行2 基于

SpringBoot结合Docker进行容器化处理指南

《SpringBoot结合Docker进行容器化处理指南》在当今快速发展的软件工程领域,SpringBoot和Docker已经成为现代Java开发者的必备工具,本文将深入讲解如何将一个SpringBo... 目录前言一、为什么选择 Spring Bootjavascript + docker1. 快速部署与

深入理解Go语言中二维切片的使用

《深入理解Go语言中二维切片的使用》本文深入讲解了Go语言中二维切片的概念与应用,用于表示矩阵、表格等二维数据结构,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧... 目录引言二维切片的基本概念定义创建二维切片二维切片的操作访问元素修改元素遍历二维切片二维切片的动态调整追加行动态

Spring Boot spring-boot-maven-plugin 参数配置详解(最新推荐)

《SpringBootspring-boot-maven-plugin参数配置详解(最新推荐)》文章介绍了SpringBootMaven插件的5个核心目标(repackage、run、start... 目录一 spring-boot-maven-plugin 插件的5个Goals二 应用场景1 重新打包应用

SpringBoot+EasyExcel实现自定义复杂样式导入导出

《SpringBoot+EasyExcel实现自定义复杂样式导入导出》这篇文章主要为大家详细介绍了SpringBoot如何结果EasyExcel实现自定义复杂样式导入导出功能,文中的示例代码讲解详细,... 目录安装处理自定义导出复杂场景1、列不固定,动态列2、动态下拉3、自定义锁定行/列,添加密码4、合并

Spring Boot集成Druid实现数据源管理与监控的详细步骤

《SpringBoot集成Druid实现数据源管理与监控的详细步骤》本文介绍如何在SpringBoot项目中集成Druid数据库连接池,包括环境搭建、Maven依赖配置、SpringBoot配置文件... 目录1. 引言1.1 环境准备1.2 Druid介绍2. 配置Druid连接池3. 查看Druid监控

Java中读取YAML文件配置信息常见问题及解决方法

《Java中读取YAML文件配置信息常见问题及解决方法》:本文主要介绍Java中读取YAML文件配置信息常见问题及解决方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要... 目录1 使用Spring Boot的@ConfigurationProperties2. 使用@Valu