问题引进
在进行属性绑定时,可能会遇到如下情况,为了进行标准命名,开发者会将属性名严格按照驼峰命名法书写,在yml配置文件中将datasource修改为dataSource,如下:
代码语言:javascript复制dataSource:
driverClassName: com.mysql.jdbc.Driver
此时程序可以正常运行,然后又将代码中的前缀datasource修改为dataSource,如下:
代码语言:javascript复制@Bean
@ConfigurationProperties(prefix = "dataSource")
public DruidDataSource datasource(){
DruidDataSource ds = new DruidDataSource();
return ds;
}
此时就发生了编译错误,而且并不是idea工具导致的,运行后依然会出现问题,配置属性名dataSource是无效的
代码语言:javascript复制Configuration property name 'dataSource' is not valid:
Invalid characters: 'S'
Bean: datasource
Reason: Canonical names should be kebab-case ('-' separated), lowercase alpha-numeric characters and must start with a letter
Action:
Modify 'dataSource' so that it conforms to the canonical names requirements.
规范的名称应该是烤肉串(kebab)模式(case),即使用-分隔,使用小写字母数字作为标准字符,且必须以字母开头。
宽松绑定
springboot进行编程时人性化设计的一种体现,即配置文件中的命名格式与变量名的命名格式可以进行格式上的最大化兼容。兼容到什么程度呢?几乎主流的命名格式都支持,例如:
代码语言:javascript复制@Component
@Data
@ConfigurationProperties(prefix = "servers")
public class ServerConfig {
private String ipAddress;
}
可以与下面的配置属性名规则全兼容:
代码语言:javascript复制servers:
ipAddress: 192.168.0.3 # 驼峰模式
ip_address: 192.168.0.3 # 下划线模式
ip-address: 192.168.0.3 # 烤肉串模式
IP_ADDRESS: 192.168.0.3 # 常量模式
以上4种模式最终都可以匹配到ipAddress这个属性名。
原因就是在进行匹配时,配置中的名称要去掉中划线和下划线后,忽略大小写的情况下去与java代码中的属性名进行忽略大小写的等值匹配,以上4种命名去掉下划线中划线忽略大小写后都是一个词ipaddress,java代码中的属性名忽略大小写后也是ipaddress,这样就可以进行等值匹配了,这就是为什么这4种格式都能匹配成功的原因。不过springboot官方推荐使用烤肉串模式,也就是中划线模式。
以上规则仅针对springboot中@ConfigurationProperties注解进行属性绑定时有效,对@Value注解进行属性映射无效。
- @ConfigurationProperties绑定属性时支持属性名宽松绑定,这个宽松体现在属性名的命名规则上
- @Value注解不支持松散绑定规则
- 绑定前缀名推荐采用烤肉串命名规则,即使用中划线做分隔符
Property | Note |
---|---|
my.main-project.person.first-name | Kebab 风格(短横线隔开),建议在 .properties 和 YAML 文件中使用。 |
my.main-project.person.firstName | 标准的驼峰语法。 |
my.main-project.person.first_name | 下划线,这是一种用于 .properties 和 YAML 文件的替代格式。 |
MY_MAINPROJECT_PERSON_FIRSTNAME | 大写格式,在使用系统环境变量时建议使用大写格式 |
注解的
prefix
值 必须 是kebab风格(小写并以-
分隔,如my.main-project.person
)。
@Value(补充)
在Spring框架中,@Value
注解是用来注入外部化配置文件或者系统属性的值。通过使用这个注解,我们可以注入一些简单类型的值(int,String,boolean等),也可以注入一个复杂对象。这个注解可以标记在类的属性上,表示将该属性的值与配置文件中的某个属性的值进行绑定。
@Value("${example.property}")
private String exampleProperty;
使用@Value
注解将配置文件中配置的值 进行自动注入的时候,经常会出现的一个问题就是:若我们忘记在配置文件中配置该参数 则会造成项目启动报错。
我们可以通过给被@Value注解作用的变量进行注入的时候,如果没有找到该配置参数时 设置一个默认值,相当于是一个兜底的方案。
代码语言:javascript复制@Value("${example.property:xxx}")
private String exampleProperty;
被static修饰的变量通过@Value会注入失败 ,如果真的需要可以选择以下形式
代码语言:javascript复制public static String port;
@Value("${spring.port:8080}")
public void setPort(String port){
Test.port = port;
}
三种常见用法
@Value(“${xxxx}”)注解从配置文件读取值的用法
常量注入
代码语言:javascript复制@Value("xxx")
privat String name;
@Value(“#{}”)是获取bean属性,系统属性,表达式( SpEL表达式)
SpEL表达式语言是一种表达式语言,是一种可以与一个基于spring的应用程序中的运行时对象交互的东西。有点类似于ognl表达式。总得来说SpEL表达式是一种简化开发的表达式,通过使用表达式来简化开发,减少一些逻辑、配置的编写。