SpringBoot配置文件properties和yml的实现
配置文件的作用
通常情况下,一个项目中的一些重要信息都会放在配置文件中,比如:数据库的连接信息、项目的启动端口、一些第三方的秘钥、记录信息的普通日志和异常日志等。
SprintBoot的配置文件(两种):
Spring Boot的配置文件主要有两种格式:
.properties和.yml
这两种格式的配置文件可以共同存在于一个项目中,但一般情况下我们会统一格式,只使用其中的一种,来降低故障率。
.properties是最早期的SpringBoot配置文件的格式,也是现在默认的配置文件格式,出现的时间早于.yml。
当这两个配置文件中出现相同的配置时,会优先执行.properties中的配置,然后再执行.yml中的配置,即.properties的优先级大于.yml
properties
创建SpringBoot项目后会自动生成一个配置文件,在该文件中,信息以键值对的形式进行储存。
# 配置项目的信息 # key=value server.port=8080 spring.datasource.url=jdbc:mysql://127.0.0.1:3306/testdb? characterEncoding=utf8 spring.datasource.username=root spring.datasource.password=root
如果我们想要在这个文件中配置一些信息,可以在遵循key-value格式下,可以定义任意名称的key
缺点:
对于同一个对象的多个属性进行设置时很麻烦,需要多次重复,存在冗余配置项。
如下,当我们想要设置同一个对象很多的信息时,需要多次重复这个信息:
而yml就很好的解决了这个问题。
yml
yml是YMAL的缩写,全称是 Yet Another Markup Language
,另一种标记语言。
YMAL是一个可读性高、易于理解、用来表达数据序列化的格式。
YMAL的作用是可以做到跨语言使用,不仅Java中可以使用,Go和python中都可以使用。
1.语法格式:
key: value表示键值对关系,冒号后面必须加一个空格
大小写敏感
缩进时不允许使用tab键,只能用空格
左对齐的一列数据就表示同一级
松散表示,java使用驼峰命名,而用原名或者-代替都可以正确映射,比如java中的名称是lastName,yml中使用lastName或者last-name都可以映射到。
2.键值关系
# 通常写法: student: id: 1 name: 张三 age: 20 # 行内写法 student: { id: 1,name: 张三, age: 20}
yml中,字符串默认不需要加上单引号或者双引号
使用双引号:不会转义字符串中的特殊字符,特殊字符会作为本身想要表达的意思:比如 name: “zhangsan \n 23”,会输出:zhangsan 换行 23
使用单引号:会转义特殊字符,特殊字符失去特殊作用变成普通字符。
在配置文件中,它是以键值对的形式储存信息的,如果是自己配置的信息,你可以在遵循key-value的格式下,定义任何名称的key.
使用YML连接数据库:
sping: datasource: url:jdbc: mysql://127.0.0.0:3306/dbname?characterEncoding=tuf8 username: root password: root
表示常用的字面量:
# 普通字面量 name: zhangsan age: 18 #布尔类型 flag: true #日期 date: 2022/04/15 # 同一个对象的多个属性 people: name: lisi age: 20 # 数组 # 用 -表示数组中的一个元素 pets: - cat - dog - pig # 行内写法 petss: [dog,cat,pig] # list对象、set对象、数组对象 students: - name: zhangsan age: 22 - name: lisi age: 20 - {name: wangwu,age: 18}
读取配置文件的方法:
@Value注解读取单个配置项
如果我们想要主动的读取配置文件中的信息,可以使用注解@Value。
使用格式:
@Value("${server.port}") private String port;
在属性前加上@Value注解,后面的括号写入要读取的配置中哪个key,比如读取下面的server.port,注意格式:双引号+${}
# 配置项目端口 server.port=8080
在测试类中得到这个值并进行打印:
package com.example.demo; import Controller.TestReadYml; import org.springframework.beans.factory.InitializingBean; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Value; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class DemoApplication implements InitializingBean { @Value("${server.port}") private String port; public static void main(String[] args) { SpringApplication.run(DemoApplication.class,args); } @Override public void afterPropertiesSet() throws Exception { System.out.println(" "); System.out.println("读取到信息:"+port); System.out.println(" "); } }
输入:
@ConfigurationProperties读取实体类
1.将配置文件中的一组对象映射到实体类上:
使用格式:
@Component //spring 启动时直接将配置文件映射到当前类属性上 @ConfigurationProperties("student") //student是在配置好的key
举例:
在yml配置文件中,我们创建一个student对象:
student: id: 1 name: 张三 age: 20
将这个对象映射到Student类中,也就是从配置文件里读取到类中,
package model; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.stereotype.Component; @Component //spring 启动时直接将配置文件映射到当前类属性上 @ConfigurationProperties("student") public class Student { private int id; private String name; private int age; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } }
2.使用注入的方式将对象注入到一个类中
在启动类中注入Student类进行使用:
package com.example.demo; import com.example.demo.model.Student; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.stereotype.Component; import javax.annotation.PostConstruct; @SpringBootApplication @Component public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class,args); } //属性注入 @Autowired private Student student; @PostConstruct private void postConstruct(){ System.out.println("Read Yml:"+student); } }
输出:
Read Yml:Student{id=1, name='张三', age=20}
注意包路径配置的问题!!!
启动类和要注入的类包必须放在同级目录下,否则读取不到,会显示启动失败Application failed to start.
properties VS yml 总结
- yml语法更简洁,可以解决数据冗余问题
- yml跨语言的通用性更好,它不支持java语言还支持golang 和python
- yml 支持更多的数据类型
- yml格式的配置文件在写的时候更容易出错(冒号后面需要加一个空格),而properties虽然写法更复杂但是不容易出错。
- yml虽然可以和properties共存,但一个项目中最好统一格式,只用其中的一个。
栏 目:JAVA代码
下一篇:Springboot 整合 RocketMQ 收发消息的配置过程
本文标题:SpringBoot配置文件properties和yml的实现
本文地址:http://www.codeinn.net/misctech/222374.html