赞
踩
全局配置文件能够对一些默认配置值进行修改。Spring Boot使用一个application.properties或者application.yaml的文件作为全局配置文件,该文件存放在src/main/resource目录或者类路径的/config,一般会选择resource目录。接下来,将针对这两种全局配置文件进行讲解 :
使用Spring Initializr方式构建Spring Boot项目时,会在resource目录下自动生成一个空的application.properties文件,Spring Boot项目启动时会自动加载application.properties文件。
我们可以在application.properties文件中定义Spring Boot项目的相关属性,当然,这些相关属性可以是系统属性、环境变量、命令参数等信息,也可以是自定义配置文件名称和位置
- # 修改tomcat的版本号
- server.port=8888
- # 定义数据库的连接信息 JdbcTemplate
- spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
- spring.datasource.url=jdbc:mysql://localhost:3306/lagou_edu
- spring.datasource.username=root
- spring.datasource.password=123456
- public class Pet {
- private String type; // 品种
- private String name; // 名称
- // set get
- }
- @Component
- // 将配置文件中所有以person开头的配置信息注入当前类中
- // 前提1:必须保证配置文件中person.xx与当前Person类中的属性名一致
- // 前提2:必须保证当前Person中的属性都具有set方法
- @ConfigurationProperties(prefix = "person")
- public class Person {
- private int id; //id
- private String name; //名称
- private List hobby; //爱好
- private String[] family; //家庭成员
- private Map map;
- private Pet pet; //宠物
- // set get
- }
- # 自定义配置信息注入到Person对象中
- person.id=100
- person.name=张三
- # list
- person.body=打人,打架,粗狂
- # String
- person.family=妻,妾
- # map
- person.map.k1=v1
- person.map.k2=v2
- # pet对象
- person.pet.type=dog
- person.pet.name=小王
- @RunWith(SpringRunner.class) // @RunWith:运行器 SpringJUnit4ClassRunner.class:Spring运行环境 junit:junit测试环境
- @SpringBootTest // 标记当前类为SpringBoot测试类,加载项目的ApplicationContext上下文环境
- class Springbootdemo2ApplicationTests {
-
- @Autowired
- private Person person;
- @Test
- void showPersonInfo(){
- System.out.println(person);
- }
- }
打印结果:
Person{id=100, name='张三', hobby=[抽烟, 喝酒, 烫头], family=[妻, 妾], map={k1=v1, k2=v2}, pet=com.lagou.pojo.Pet@7e49ded}
- #解决中文乱码
- server.tomcat.uri-encoding=UTF-8
- spring.http.encoding.force=true
- spring.http.encoding.charset=UTF-8
- spring.http.encoding.enabled=true
YAML文件格式是Spring Boot支持的一种JSON文件格式,相较于传统的Properties配置文件,YAML文件以数据为核心,是一种更为直观且容易被电脑识别的数据序列化格式。application.yaml配置文件的工作原理和application.properties是一样的,只不过yaml格式配置文件看起来更简洁一些。
SpringBoot的三种配置文件是可以共存的:
当YAML配置文件中配置的属性值为普通数据类型时,可以直接配置对应的属性值,同时对于字符串类型的属性值,不需要额外添加引号,示例代码如下
- server:
- port: 8080
- servlet:
- context-path: /hello
- person:
- hobby:
- - 抽烟
- - 喝酒
- - 烫头
或者使用如下示例形式
- person:
- hobby:
- 抽烟,
- 喝酒,
- 烫头
上述代码中,在YAML配置文件中通过两种缩进式写法对person对象的单列集合(或数组)类型的爱好hobby赋值。其中一种形式为“-(空格)属性值”,另一种形式为多个属性值之前加英文逗号分隔(注意,最后一个属性值后不要加逗号)。
- person:
- hobby: [play,read,sleep]
通过上述示例对比发现,YAML配置文件的行内式写法更加简明、方便。另外,包含属性值的中括号“[]”还可以进一步省略,在进行属性赋值时,程序会自动匹配和校对
(3)value值为Map集合和对象
当YAML配置文件中配置的属性值为Map集合或对象类型时,YAML配置文件格式同样可以分为两种书写方式:缩进式写法和行内式写法
- person:
- map:
- k1: v1
- k2: v2
- person:
- map: {k1: v1,k2: v2}
在YAML配置文件中,配置的属性值为Map集合或对象类型时,缩进式写法的形式按照YAML文件格式编写即可,而行内式写法的属性值要用大括号“{}”包含。
接下来,在Properties配置文件演示案例基础上,通过配置application.yaml配置文件对Person对象进行赋值,具体使用如下
person: id: 1000 name: 李四 hobby: - 抽烟 - 喝酒 - 烫头 family: - 郭麒麟 - 小月月 map: k1: 这是k1对应的value k2: 这是k2对应的value pet: type: dog name: 金毛
Person{id=1000, name='李四', hobby=[抽烟, 喝酒, 烫头], family=[郭麒麟, 小月月], map={k1=这是k1对应的value, k2=这是k2对应的value}, pet=com.lagou.pojo.Pet@563ccd31}
可以看出,测试方法configurationTest()同样运行成功,并正确打印出了Person实体类对象。需要说明的是,本次使用application.yaml配置文件进行测试时需要提前将application.properties配置文件中编写的配置注释,这是因为application.properties配置文件会覆盖application.yaml配置文件
配置文件的优先级如下: 从低到高
- <includes>
- <include>**/application*.yml</include>
- <include>**/application*.yaml</include>
- <include>**/application*.properties</include>
- </includes>
如果配置属性是Spring Boot已有属性,例如服务端口server.port,那么Spring Boot内部会自动扫描并读取这些配置文件中的属性值并覆盖默认属性。
如果配置的属性是用户自定义属性,例如刚刚自定义的Person实体类属性,还必须在程序中注入这些配置属性方可生效。
Spring Boot支持多种注入配置文件属性的方式,下面来介绍如何使用注解@ConfigurationProperties和@Value注入属性
Spring Boot提供的@ConfigurationProperties注解用来快速、方便地将配置文件中的自定义属性值批量注入到某个Bean对象的多个对应属性中。假设现在有一个配置文件,如果使用@ConfigurationProperties注入配置文件的属性,示例代码如下:
- @Component
- // 将配置文件中所有以person开头的配置信息注入当前类中
- // 前提1:必须保证配置文件中person.xx与当前Person类中的属性名一致
- // 前提2:必须保证当前Person中的属性都具有set方法
- @ConfigurationProperties(prefix = "person")
- public class Person {
- private int id; //id
- private String name; //名称
- private List hobby; //爱好
- private String[] family; //家庭成员
- private Map map;
- private Pet pet; //宠物
- }
上述代码使用@Component和@ConfigurationProperties(prefix = “person”)将配置文件中的每个属性映射到person类组件中。
@Value注解是Spring框架提供的,用来读取配置文件中的属性值并逐个注入到Bean对象的对应属性中,Spring Boot框架从Spring框架中对@Value注解进行了默认继承,所以在Spring Boot框架中还可以使用该注解读取和注入配置文件属性值。使用@Value注入属性的示例代码如下
- @Component
- public class Person {
- @Value("${person.id}")
- private int id;
- }
上述代码中,使用@Component和@Value注入Person实体类的id属性。其中,@Value不仅可以将配置文件的属性注入Person的id属性,还可以直接给id属性赋值,这点是@ConfigurationProperties不支持的,而@Value注解对于包含Map集合、对象以及YAML文件格式的行内式写法的配置文件的属性注入都不支持,如果赋值会出现错误
spring Boot免除了项目中大部分的手动配置,对于一些特定情况,我们可以通过修改全局配置文件以适应具体生产环境,可以说,几乎所有的配置都可以写在application.yml文件中,Spring Boot会自动加载全局配置文件从而免除我们手动加载的烦恼。但是,如果我们自定义配置文件,Spring Boot是无法识别这些配置文件的,此时就需要我们手动加载。接下来,将针对Spring Boot的自定义配置文件及其加载方式进行讲解
对于这种加载自定义配置文件的需求,可以使用@PropertySource注解来实现。@PropertySource注解用于指定自定义配置文件的具体位置和名称
当然,如果需要将自定义配置文件中的属性值注入到对应类的属性中,可以使用@ConfigurationProperties或者@Value注解进行属性值注入
演示
- product.id=99
- product.name=华为
- @Component
- @PropertySource("classpath:my.properties")// 通过该注解改在外部的自定义配置文件,参数是配置文件的路径
- @ConfigurationProperties(prefix = "product")
- public class Product {
- private int id;
- private String name;
- // 省略属性getXX()和setXX()方法 // 省略toString()方法
- }
主要是一个自定义配置类,通过相关注解引入了自定义的配置文件,并完成了自定义属性值的注入。针对示例中的几个注解,具体说明如下
- @RunWith(SpringRunner.class) // @RunWith:运行器 SpringJUnit4ClassRunner.class:Spring运行环境 junit:junit测试环境
- @SpringBootTest // 标记当前类为SpringBoot测试类,加载项目的ApplicationContext上下文环境
- class Springbootdemo2ApplicationTests {
- @Autowired
- private Product product;
-
- @Test
- public void showProductInfo(){
- System.out.println(product);
- }
- }
演示:
- package com.lagou.service;
-
- public class MyService {
- }
- package com.lagou.config;
-
- import com.lagou.service.MyService;
- import org.springframework.context.annotation.Bean;
- import org.springframework.context.annotation.Configuration;
-
- @Configuration // 标识当前类是一个配置类,SpringBoot会扫描该类,将所有标识@Bean注解的方法返回值注入到容器中
- public class MyConfig {
- @Bean // 注入的名称就是方法的名称,注入的类型就是返回值的类型
- public MyService myService(){
- return new MyService();
- }
- }
MyConfig是@Configuration注解声明的配置类(类似于声明了一个XML配置文件),该配置类会被Spring Boot自动扫描识别;使用@Bean注解的myService()方法,其返回值对象会作为组件添加到了Spring容器中(类似于XML配置文件中的标签配置),并且该组件的id默认是方法名myService
- @Autowired
- private ApplicationContext applicationContext;
-
- @Test
- public void testConfig(){
- System.out.println(applicationContext.containsBean("myService"));
- }
上述代码中,先通过@Autowired注解引入了Spring容器实例ApplicationContext,然后在测试方法 testConfig()中测试查看该容器中是否包括id为myService的组件。
执行测试方法testConfig() ,查看控制台输出效果,结果如下:
从测试结果可以看出,测试方法iocTest()运行成功,显示运行结果为true,表示Spirng的IOC容器中也已经包含了id为myService的实例对象组件,说明使用自定义配置类的形式完成了向Spring容器进行组件的添加和配置
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。