Ⅰ.簡(jiǎn)介
SpringBoot使用一個(gè)全局的配置文件,配置文件名是固定的恨憎;
1.application.properties
2.application.yml(或者是yaml)
配置文件的作用:修改SpringBoot自動(dòng)配置的默認(rèn)值蕊退;SpringBoot在底層都給我們自動(dòng)配置好;
YAML(YAML Ain't Markup Language)
??YAML A Markup Language:是一個(gè)標(biāo)記語(yǔ)言
??YAML isn't Markup Language:不是一個(gè)標(biāo)記語(yǔ)言憔恳;
標(biāo)記語(yǔ)言:
??以前的配置文件瓤荔;大多都使用的是 xxxx.xml文件;
??YAML:以數(shù)據(jù)為中心钥组,比json输硝、xml等更適合做配置文件;
Ⅱ.yaml語(yǔ)法
1.基本語(yǔ)法
以空格的縮進(jìn)來控制層級(jí)關(guān)系程梦;只要是左對(duì)齊的一列數(shù)據(jù)点把,都是同一個(gè)層級(jí)的,大小寫敏感
k:(空格)v:
#空格不能省
#k: v:字面直接來寫;
# 字符串默認(rèn)不用加上單引號(hào)或者雙引號(hào)作烟;
# "":雙引號(hào)愉粤;不會(huì)轉(zhuǎn)義字符串里面的特殊字符;特殊字符會(huì)作為本身想表示的意思
# name: "zhangsan \n lisi":輸出拿撩;zhangsan 換行 lisi
# '':?jiǎn)我?hào)衣厘;會(huì)轉(zhuǎn)義特殊字符,特殊字符最終只是一個(gè)普通的字符串?dāng)?shù)據(jù)
# name: ‘zhangsan \n lisi’:輸出;zhangsan \n lisi
2.表示對(duì)象影暴、Map(屬性和值)(鍵值對(duì))語(yǔ)法:
k: v:在下一行來寫對(duì)象的屬性和值的關(guān)系错邦;注意縮進(jìn),對(duì)象還是k: v的方式
friends:
lastName: zhangsan
age: 20
行內(nèi)寫法:
friends: {lastName: zhangsan,age: 18}
3.表示數(shù)組的語(yǔ)法
用- 值表示數(shù)組中的一個(gè)元素(- 和屬性之間空格不能省)
pets:#(數(shù)組名)
- cat#(屬性)
- dog#(屬性)
- pig#(屬性)
行內(nèi)寫法
pets: [cat,dog,pig]
寫一個(gè)間的的將配置文件的值注入到JavaBean中的例子
1.創(chuàng)建一個(gè)springboot項(xiàng)目
Person類為:
package com.byls.springbootdemo.bean;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import java.util.Date;
import java.util.List;
import java.util.Map;
/**
* 將配置文件中配置的每一個(gè)屬性的值型宙,映射到這個(gè)組件中
* @ConfigurationProperties:告訴SpringBoot將本類中的所有屬性和配置文件中相關(guān)的配置進(jìn)行綁定撬呢;
* prefix = "person":配置文件中哪個(gè)下面的所有屬性進(jìn)行一一映射
*
* 只有這個(gè)組件是容器中的組件,才能容器提供的@ConfigurationProperties功能妆兑;
*
*/
@Component//將Person類注冊(cè)到容器中
@ConfigurationProperties(prefix = "person") //綁定配置文件的值
public class Person {
private String lastName;//名字
private Integer age;//年齡
private Boolean boss;//是否是老板
private Date bir;//生日
private Map<String,Object> maps;//map集合
private List<Object> lists;//list集合
private Dog dog;//Dog類對(duì)象 只有name 和 age屬性
public Person() {
}
@Override
public String toString() {
return "Person{" +
"lastName='" + lastName + '\'' +
", age=" + age +
", boss=" + boss +
", bir=" + bir +
", maps=" + maps +
", lists=" + lists +
", dog=" + dog +
'}';
}
public Person(String lastName, Integer age, Boolean boss, Date bir, Map<String, Object> maps, List<Object> lists, Dog dog) {
this.lastName = lastName;
this.age = age;
this.boss = boss;
this.bir = bir;
this.maps = maps;
this.lists = lists;
this.dog = dog;
}
public void setLastName(String lastName) {
this.lastName = lastName;
}
public void setAge(Integer age) {
this.age = age;
}
public void setBoss(Boolean boss) {
this.boss = boss;
}
public void setBir(Date bir) {
this.bir = bir;
}
public void setMaps(Map<String, Object> maps) {
this.maps = maps;
}
public void setLists(List<Object> lists) {
this.lists = lists;
}
public void setDog(Dog dog) {
this.dog = dog;
}
public String getLastName() {
return lastName;
}
public Integer getAge() {
return age;
}
public Boolean getBoss() {
return boss;
}
public Date getBir() {
return bir;
}
public Map<String, Object> getMaps() {
return maps;
}
public List<Object> getLists() {
return lists;
}
public Dog getDog() {
return dog;
}
}
yaml文件:
person:
lastName: byls
age: 22
boss: true
bir: 2017/12/01
maps: {k1: v1,k2: v2}
lists:
- zs
- ls
dog:
name: baibai
age: 10
測(cè)試類:
package com.byls.springbootdemo;
import com.byls.springbootdemo.bean.Person;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringbootDemoApplicationTests {
@Autowired
private Person person;
@Test
public void contextLoads() {
// Person person = new Person();
System.out.println(person.toString());
}
}
先運(yùn)行springboot主程序類的main方法魂拦,在運(yùn)行測(cè)試類,運(yùn)行結(jié)果:
可以看出結(jié)果和我們?cè)趛aml文件中預(yù)設(shè)的值是一樣的搁嗓,配置文件綁定成功
Ⅲ.springbooot的properties類型配置文件
properties類型配置文件語(yǔ)法和以前并無卻別芯勘,不多介紹,直接上例子
person.last-name=張三
person.age=12
person.bir=2017/12/01
person.maps.k1=v1
person.maps.k2=v2
person.dog.name=xiaobai
person.dog.age=12
person.lists=a,b,c
person.boss=true
運(yùn)行:
這里出現(xiàn)亂碼是因?yàn)閕dea的默認(rèn)編碼格式是utf-8腺逛,而application.properties編譯時(shí)ascii碼
調(diào)整:
Ⅳ.除了用“@ConfigurationProperties”綁定配置文件外荷愕,還可以用“@value”進(jìn)行綁定
@ConfigurationProperties和@value的對(duì)比
@ConfigurationProperties | @value | |
---|---|---|
功能 | 批量注入配置文件中的屬性 | 一個(gè)一個(gè)注入 |
松散綁定 | 支持 | 不支持 |
SpEL | 不支持 | 支持 |
JSR303數(shù)據(jù)校驗(yàn) | 支持 | 不支持 |
復(fù)雜數(shù)據(jù)類型封裝 | 支持 | 不支持 |
使用場(chǎng)景對(duì)比:
如果說,我們只是在某個(gè)業(yè)務(wù)邏輯中需要獲取一下配置文件中的某項(xiàng)值棍矛,使用@Value安疗;
如果說,我們專門編寫了一個(gè)javaBean來和配置文件進(jìn)行映射够委,我們就直接使@ConfigurationProperties荐类;
package com.byls.springbootdemo.controller;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;
/**
* @Value的一個(gè)簡(jiǎn)單的使用場(chǎng)景例子
*/
@RestController //@ResponseBody和@Controller的結(jié)合
public class HelloController {
@Value("${person.last-name}")//使用@Value從配置文件中取單個(gè)值
private String name;
@RequestMapping("/hello")//設(shè)置請(qǐng)求路徑
public String hello(){
return "hello"+name;
}
}
Ⅵ.@PropertySource&@ImportResource和@Bean
前面的@ConfigurationProperties能將實(shí)體類和springboot的全局配置文件進(jìn)行綁定哪自,但實(shí)際上我們一個(gè)項(xiàng)目不能把所有的配置文件都寫在全局配置文件中惭等,所有我們就可以下面幾個(gè)注解
@PropertySource:加載指定的配置文件:
在resourse文件夾中創(chuàng)建一個(gè)person.properties用于存放先前的配置文件并把之前的配置文件注釋
Preson類部分代碼如下
@PropertySource(value ={"classpath:person.properties"}) //value的值可以是數(shù)組
@Component
@ConfigurationProperties(prefix = "person")//這個(gè)不能注,注了就會(huì)報(bào)錯(cuò)
public class Person {
// @Value("${person.last-name}")
private String lastName;
// @Value("#{25*5}")
private Integer age;
private Boolean boss;
private Date bir;
private Map<String,Object> maps;
private List<Object> lists;
private Dog dog;
//此處省略**行書體類代碼,前面有
}
//利用測(cè)試類測(cè)試得到結(jié)果正常脐雪,如下:
Person{lastName='張三', age=12, boss=true, bir=Fri Dec 01 00:00:00 CST 2017, maps={k1=v1, k2=v2}, lists=[a, b, c], dog=Dog{name='xiaobai', age=12}}
@ImportResource:導(dǎo)入Spring的配置文件,讓配置文件里面的內(nèi)容生效恢共;
Spring Boot里面沒有Spring的配置文件战秋,我們自己編寫的配置文件,也不能自動(dòng)識(shí)別讨韭;想讓Spring的配置文件生效脂信,加載進(jìn)來;@ImportResource標(biāo)注在一個(gè)配置類上
1.創(chuàng)建一個(gè)service包并在其中創(chuàng)建一個(gè)HelloService類透硝,新建一個(gè)spring的配置文件:bean.xml
bean.xml:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<!--向spring容器中添加helloService組件-->
<bean id="helloService" class="com.byls.springbootdemo.service.HelloService"></bean>
</beans>
2.在主函數(shù)入口類中加入@ImportResource標(biāo)簽,如果不加bean將注入失敗
package com.byls.springbootdemo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ImportResource;
/**
* springboot主程序入口類
*/
@ImportResource(locations = {"classpath:bean.xml"})//如果不加bean將注入失敗
@SpringBootApplication
public class SpringbootDemoApplication {
public static void main(String[] args) {
SpringApplication.run(SpringbootDemoApplication.class, args);
}
}
測(cè)試類:
package com.byls.springbootdemo;
import com.byls.springbootdemo.bean.Person;
import com.sun.glass.ui.Application;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.context.ApplicationContext;
import org.springframework.test.context.junit4.SpringRunner;
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringbootDemoApplicationTests {
@Autowired
private ApplicationContext ioc; //spring容器對(duì)象
@Test
public void testHelloService(){
//判斷容器中是否包含某個(gè)bean 包含為true 反之為false
boolean flag = ioc.containsBean("helloService");
System.out.println(flag);
}
}
運(yùn)行測(cè)試結(jié)果為true狰闪,bean注入成功。
不管是哪種注解濒生,用起來都比較繁瑣埋泵,所以:
SpringBoot推薦給容器中添加組件的方式;推薦使用全注解的方式
1.創(chuàng)建配置類(使用@Configuration標(biāo)簽) -------> 相當(dāng)于是配置文件
2.使用@Bean標(biāo)簽往容器中添加組件
package com.byls.springbootdemo.config;
import com.byls.springbootdemo.service.HelloService;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 配置類
*/
@Configuration//指定這是一個(gè)配置類,用于替代之前的配置文件
public class MyAppConfig {
//將方法的返回值添加到容器中丽声,容器中組件的id就是方法的返回值
@Bean
public HelloService helloService(){
return new HelloService();
}
}
返回spring主程序類注釋掉@ImportResource(locations = {"classpath:bean.xml"})運(yùn)行測(cè)試方法
得到值依然為true礁蔗,helloService注入成功。(這種方法相比于前面兩種會(huì)比較簡(jiǎn)單)
Ⅶ.配置文件的占位符
1.常用的幾個(gè)隨機(jī)數(shù)
${random.value}雁社、
${random.int}浴井、
${random.long}
${random.int(10)}、
${random.int[1024,65536]}
2.占位符的使用,在原先的著配置文件中修改如下
person:
lastName: 張三${random.int(10)}
age: ${random.int}
boss: true
bir: 2017/12/01
maps: {k1: v1,k2: v2}
lists:
- zs
- ls
dog:
name: ${person.lastName}_dog
age: 10
#${}中可以是原先預(yù)設(shè)好的值如:${person.last-name} 也可以是沒有預(yù)設(shè)的值霉撵,沒有預(yù)設(shè)的值需要在后面加“ :默認(rèn)值 ”
#如果不加默認(rèn)值輸出時(shí)將原樣輸出
#運(yùn)行測(cè)試類方法得到數(shù)據(jù)為:
#Person{lastName='張三4', age=-141504158, boss=true, bir=Fri Dec 01 00:00:00 CST 2017, #maps={k1=v1, k2=v2}, lists=[zs, ls], dog=Dog{name='張三6_dog', age=10}}
Ⅷ.springboot的Profile
簡(jiǎn)介:一個(gè)項(xiàng)目的不同時(shí)期需要有不同的配置磺浙,比如開發(fā)階段要有開發(fā)階段的配置,測(cè)試階段要有測(cè)試階段的配置那么我們?cè)谥髋渲梦募帉懙臅r(shí)候徒坡,文件名可以是 application-{profile//標(biāo)識(shí)}.properties/yml
默認(rèn)使用application.properties的配置屠缭;
1.多profile表示的properties文件
2.yml支持多文檔塊方式
(測(cè)試前要將application.properties配置文件注釋掉)
幾種激活指定profile的方式:
??1、在配置文件中指定 spring.profiles.active=dev
??2崭参、命令行:java -jar spring-boot-02-config-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev呵曹;可以直接在測(cè)試的時(shí)候,配置傳入命令行參數(shù)
??3何暮、虛擬機(jī)參數(shù)-Dspring.profiles.active=dev
Ⅸ.配置文件加載位置
springboot 啟動(dòng)會(huì)掃描以下位置的application.properties或者application.yml文件作為Spring boot的默認(rèn)配置文件
–file:./config/
–file:./
–classpath:/config/
–classpath:/
優(yōu)先級(jí)由高到底奄喂,高優(yōu)先級(jí)的配置會(huì)覆蓋低優(yōu)先級(jí)的配置;
SpringBoot會(huì)從這四個(gè)位置全部加載主配置文件海洼;互補(bǔ)配置(共同作用跨新,一個(gè)文件沒有另一個(gè)有的會(huì)一起都會(huì)產(chǎn)生作用);
我們還可以通過spring.config.location來改變默認(rèn)的配置文件位置
項(xiàng)目打包好以后坏逢,我們可以使用命令行參數(shù)的形式域帐,啟動(dòng)項(xiàng)目的時(shí)候來指定配置文件的新位置;指定配置文件和默認(rèn)加載的這些配置文件共同起作用形成互補(bǔ)配置是整;
java -jar spring-boot-02-config-02-0.0.1-SNAPSHOT.jar --spring.config.location=G:/application.properties
X.springboot的外部配置加載順序
SpringBoot也可以從以下位置加載配置肖揣; 優(yōu)先級(jí)從高到低;高優(yōu)先級(jí)的配置覆蓋低優(yōu)先級(jí)的配置浮入,所有的配置會(huì)形成互補(bǔ)配置
1.命令行參數(shù)所有的配置都可以在命令行上進(jìn)行指定
java -jar spring-boot-02-config-02-0.0.1-SNAPSHOT.jar --server.port=8087 --server.context-path=/abc多個(gè)配置用空格分開龙优; --配置項(xiàng)=值
2.來自java:comp/env的JNDI屬性
3.Java系統(tǒng)屬性(System.getProperties())
4.操作系統(tǒng)環(huán)境變量
5.RandomValuePropertySource配置的random.*屬性值
==由jar包外向jar包內(nèi)進(jìn)行尋找;優(yōu)先加載帶profile==
6.jar包外部的application-{profile}.properties或application.yml(帶spring.profile)配置文件
7.jar包內(nèi)部的application-{profile}.properties或application.yml(帶spring.profile)配置文件
==再來加載不帶profile==
8.jar包外部的application.properties或application.yml(不帶spring.profile)配置文件
9.jar包內(nèi)部的application.properties或application.yml(不帶spring.profile)配置文件
10.@Configuration注解類上的@PropertySource
11.通過SpringApplication.setDefaultProperties指定的默認(rèn)屬性
所有支持的配置加載來源事秀;
參考官方文檔
Ⅺ.springboot的自動(dòng)配置原理(難彤断,重點(diǎn))
尚硅谷視頻講解傳送門
1)、SpringBoot啟動(dòng)的時(shí)候加載主配置類易迹,開啟了自動(dòng)配置功能
??@EnableAutoConfiguration
2)宰衙、@EnableAutoConfiguration 作用:
?利用EnableAutoConfigurationImportSelector給容器中導(dǎo)入一些組件?
?可以查看selectImports()方法的內(nèi)容睹欲;
?List<String> configurations = getCandidateConfigurations(annotationMetadata, ?attributes);獲取候選的配置
?SpringFactoriesLoader.loadFactoryNames()
?掃描所有jar包類路徑下 META-INF/spring.factories
?把掃描到的這些文件的內(nèi)容包裝成properties對(duì)象
?從properties中獲取到EnableAutoConfiguration.class類(類名)對(duì)應(yīng)的值供炼,然后把他們添加在容器中
將 類路徑下 META-INF/spring.factories 里面配置的所有EnableAutoConfiguration的值加入到了容器中;
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,\
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration,\
org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,\
org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration,\
org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration,\
org.springframework.boot.autoconfigure.cassandra.CassandraAutoConfiguration,\
org.springframework.boot.autoconfigure.cloud.CloudAutoConfiguration,\
org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration,\
org.springframework.boot.autoconfigure.context.MessageSourceAutoConfiguration,\
org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration,\
org.springframework.boot.autoconfigure.couchbase.CouchbaseAutoConfiguration,\
org.springframework.boot.autoconfigure.dao.PersistenceExceptionTranslationAutoConfiguration,\
org.springframework.boot.autoconfigure.data.cassandra.CassandraDataAutoConfiguration,\
org.springframework.boot.autoconfigure.data.cassandra.CassandraRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.couchbase.CouchbaseDataAutoConfiguration,\
org.springframework.boot.autoconfigure.data.couchbase.CouchbaseRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.elasticsearch.ElasticsearchAutoConfiguration,\
org.springframework.boot.autoconfigure.data.elasticsearch.ElasticsearchDataAutoConfiguration,\
org.springframework.boot.autoconfigure.data.elasticsearch.ElasticsearchRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.jpa.JpaRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.ldap.LdapDataAutoConfiguration,\
org.springframework.boot.autoconfigure.data.ldap.LdapRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.mongo.MongoDataAutoConfiguration,\
org.springframework.boot.autoconfigure.data.mongo.MongoRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.neo4j.Neo4jDataAutoConfiguration,\
org.springframework.boot.autoconfigure.data.neo4j.Neo4jRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.solr.SolrRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration,\
org.springframework.boot.autoconfigure.data.redis.RedisRepositoriesAutoConfiguration,\
org.springframework.boot.autoconfigure.data.rest.RepositoryRestMvcAutoConfiguration,\
org.springframework.boot.autoconfigure.data.web.SpringDataWebAutoConfiguration,\
org.springframework.boot.autoconfigure.elasticsearch.jest.JestAutoConfiguration,\
org.springframework.boot.autoconfigure.freemarker.FreeMarkerAutoConfiguration,\
org.springframework.boot.autoconfigure.gson.GsonAutoConfiguration,\
org.springframework.boot.autoconfigure.h2.H2ConsoleAutoConfiguration,\
org.springframework.boot.autoconfigure.hateoas.HypermediaAutoConfiguration,\
org.springframework.boot.autoconfigure.hazelcast.HazelcastAutoConfiguration,\
org.springframework.boot.autoconfigure.hazelcast.HazelcastJpaDependencyAutoConfiguration,\
org.springframework.boot.autoconfigure.info.ProjectInfoAutoConfiguration,\
org.springframework.boot.autoconfigure.integration.IntegrationAutoConfiguration,\
org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration,\
org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,\
org.springframework.boot.autoconfigure.jdbc.JdbcTemplateAutoConfiguration,\
org.springframework.boot.autoconfigure.jdbc.JndiDataSourceAutoConfiguration,\
org.springframework.boot.autoconfigure.jdbc.XADataSourceAutoConfiguration,\
org.springframework.boot.autoconfigure.jdbc.DataSourceTransactionManagerAutoConfiguration,\
org.springframework.boot.autoconfigure.jms.JmsAutoConfiguration,\
org.springframework.boot.autoconfigure.jmx.JmxAutoConfiguration,\
org.springframework.boot.autoconfigure.jms.JndiConnectionFactoryAutoConfiguration,\
org.springframework.boot.autoconfigure.jms.activemq.ActiveMQAutoConfiguration,\
org.springframework.boot.autoconfigure.jms.artemis.ArtemisAutoConfiguration,\
org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration,\
org.springframework.boot.autoconfigure.groovy.template.GroovyTemplateAutoConfiguration,\
org.springframework.boot.autoconfigure.jersey.JerseyAutoConfiguration,\
org.springframework.boot.autoconfigure.jooq.JooqAutoConfiguration,\
org.springframework.boot.autoconfigure.kafka.KafkaAutoConfiguration,\
org.springframework.boot.autoconfigure.ldap.embedded.EmbeddedLdapAutoConfiguration,\
org.springframework.boot.autoconfigure.ldap.LdapAutoConfiguration,\
org.springframework.boot.autoconfigure.liquibase.LiquibaseAutoConfiguration,\
org.springframework.boot.autoconfigure.mail.MailSenderAutoConfiguration,\
org.springframework.boot.autoconfigure.mail.MailSenderValidatorAutoConfiguration,\
org.springframework.boot.autoconfigure.mobile.DeviceResolverAutoConfiguration,\
org.springframework.boot.autoconfigure.mobile.DeviceDelegatingViewResolverAutoConfiguration,\
org.springframework.boot.autoconfigure.mobile.SitePreferenceAutoConfiguration,\
org.springframework.boot.autoconfigure.mongo.embedded.EmbeddedMongoAutoConfiguration,\
org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration,\
org.springframework.boot.autoconfigure.mustache.MustacheAutoConfiguration,\
org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration,\
org.springframework.boot.autoconfigure.reactor.ReactorAutoConfiguration,\
org.springframework.boot.autoconfigure.security.SecurityAutoConfiguration,\
org.springframework.boot.autoconfigure.security.SecurityFilterAutoConfiguration,\
org.springframework.boot.autoconfigure.security.FallbackWebSecurityAutoConfiguration,\
org.springframework.boot.autoconfigure.security.oauth2.OAuth2AutoConfiguration,\
org.springframework.boot.autoconfigure.sendgrid.SendGridAutoConfiguration,\
org.springframework.boot.autoconfigure.session.SessionAutoConfiguration,\
org.springframework.boot.autoconfigure.social.SocialWebAutoConfiguration,\
org.springframework.boot.autoconfigure.social.FacebookAutoConfiguration,\
org.springframework.boot.autoconfigure.social.LinkedInAutoConfiguration,\
org.springframework.boot.autoconfigure.social.TwitterAutoConfiguration,\
org.springframework.boot.autoconfigure.solr.SolrAutoConfiguration,\
org.springframework.boot.autoconfigure.thymeleaf.ThymeleafAutoConfiguration,\
org.springframework.boot.autoconfigure.transaction.TransactionAutoConfiguration,\
org.springframework.boot.autoconfigure.transaction.jta.JtaAutoConfiguration,\
org.springframework.boot.autoconfigure.validation.ValidationAutoConfiguration,\
org.springframework.boot.autoconfigure.web.DispatcherServletAutoConfiguration,\
org.springframework.boot.autoconfigure.web.EmbeddedServletContainerAutoConfiguration,\
org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration,\
org.springframework.boot.autoconfigure.web.HttpEncodingAutoConfiguration,\
org.springframework.boot.autoconfigure.web.HttpMessageConvertersAutoConfiguration,\
org.springframework.boot.autoconfigure.web.MultipartAutoConfiguration,\
org.springframework.boot.autoconfigure.web.ServerPropertiesAutoConfiguration,\
org.springframework.boot.autoconfigure.web.WebClientAutoConfiguration,\
org.springframework.boot.autoconfigure.web.WebMvcAutoConfiguration,\
org.springframework.boot.autoconfigure.websocket.WebSocketAutoConfiguration,\
org.springframework.boot.autoconfigure.websocket.WebSocketMessagingAutoConfiguration,\
org.springframework.boot.autoconfigure.webservices.WebServicesAutoConfiguration
每一個(gè)這樣的 xxxAutoConfiguration類都是容器中的一個(gè)組件,都加入到容器中劲蜻;用他們來做自動(dòng)配置陆淀;
3)、每一個(gè)自動(dòng)配置類進(jìn)行自動(dòng)配置功能先嬉;
4)轧苫、以HttpEncodingAutoConfiguration(Http編碼自動(dòng)配置)為例解釋自動(dòng)配置原理;
@Configuration //表示這是一個(gè)配置類疫蔓,以前編寫的配置文件一樣含懊,也可以給容器中添加組件
@EnableConfigurationProperties(HttpEncodingProperties.class) //啟動(dòng)指定類的ConfigurationProperties功能;將配置文件中對(duì)應(yīng)的值和HttpEncodingProperties綁定起來衅胀;并把HttpEncodingProperties加入到ioc容器中
@ConditionalOnWebApplication //Spring底層@Conditional注解(Spring注解版)岔乔,根據(jù)不同的條件,如果滿足指定的條件滚躯,整個(gè)配置類里面的配置就會(huì)生效雏门; 判斷當(dāng)前應(yīng)用是否是web應(yīng)用,如果是掸掏,當(dāng)前配置類生效
@ConditionalOnClass(CharacterEncodingFilter.class) //判斷當(dāng)前項(xiàng)目有沒有這個(gè)類CharacterEncodingFilter茁影;SpringMVC中進(jìn)行亂碼解決的過濾器;
@ConditionalOnProperty(prefix = "spring.http.encoding", value = "enabled", matchIfMissing = true) //判斷配置文件中是否存在某個(gè)配置 spring.http.encoding.enabled丧凤;如果不存在募闲,判斷也是成立的
//即使我們配置文件中不配置pring.http.encoding.enabled=true,也是默認(rèn)生效的愿待;
public class HttpEncodingAutoConfiguration {
//他已經(jīng)和SpringBoot的配置文件映射了
private final HttpEncodingProperties properties;
//只有一個(gè)有參構(gòu)造器的情況下浩螺,參數(shù)的值就會(huì)從容器中拿
public HttpEncodingAutoConfiguration(HttpEncodingProperties properties) {
this.properties = properties;
}
@Bean //給容器中添加一個(gè)組件,這個(gè)組件的某些值需要從properties中獲取
@ConditionalOnMissingBean(CharacterEncodingFilter.class) //判斷容器沒有這個(gè)組件仍侥?
public CharacterEncodingFilter characterEncodingFilter() {
CharacterEncodingFilter filter = new OrderedCharacterEncodingFilter();
filter.setEncoding(this.properties.getCharset().name());
filter.setForceRequestEncoding(this.properties.shouldForce(Type.REQUEST));
filter.setForceResponseEncoding(this.properties.shouldForce(Type.RESPONSE));
return filter;
}
根據(jù)當(dāng)前不同的條件判斷要出,決定這個(gè)配置類是否生效?
一但這個(gè)配置類生效访圃;這個(gè)配置類就會(huì)給容器中添加各種組件厨幻;這些組件的屬性是從對(duì)應(yīng)的properties類中獲取的相嵌,這些類里面的每一個(gè)屬性又是和配置文件綁定的腿时;
5)、所有在配置文件中能配置的屬性都是在xxxxProperties類中封裝者‘饭宾;配置文件能配置什么就可以參照某個(gè)功能對(duì)應(yīng)的這個(gè)屬性類
@ConfigurationProperties(prefix = "spring.http.encoding") //從配置文件中獲取指定的值和bean的屬性進(jìn)行綁定
public class HttpEncodingProperties {
public static final Charset DEFAULT_CHARSET = Charset.forName("UTF-8");
使用精髓
1)批糟、SpringBoot啟動(dòng)會(huì)加載大量的自動(dòng)配置類
2)、我們看我們需要的功能有沒有SpringBoot默認(rèn)寫好的自動(dòng)配置類看铆;
3)徽鼎、我們?cè)賮砜催@個(gè)自動(dòng)配置類中到底配置了哪些組件;(只要我們要用的組件有,我們就不需要再來配置了)
4)否淤、給容器中自動(dòng)配置類添加組件的時(shí)候悄但,會(huì)從properties類中獲取某些屬性。我們就可以在配置文件中指定這些屬性的值石抡;
xxxxAutoConfigurartion:自動(dòng)配置類檐嚣;
給容器中添加組件
xxxxProperties:封裝配置文件中相關(guān)屬性;
自動(dòng)配置報(bào)告
1啰扛、@Conditional派生注解(Spring注解版原生的@Conditional作用)
作用:必須是@Conditional指定的條件成立嚎京,才給容器中添加組件,配置配里面的所有內(nèi)容才生效隐解;
自動(dòng)配置類必須在一定的條件下才能生效鞍帝;
我們?cè)趺粗滥男┳詣?dòng)配置類生效;
我們可以通過啟用 debug=true屬性(配置文件中)煞茫;來讓控制臺(tái)打印自動(dòng)配置報(bào)告帕涌,這樣我們就可以很方便的知道哪些自動(dòng)配置類生效;
控制臺(tái)效果:
=========================
AUTO-CONFIGURATION REPORT
=========================
Positive matches:(自動(dòng)配置類啟用的)
-----------------
DispatcherServletAutoConfiguration matched:
- @ConditionalOnClass found required class 'org.springframework.web.servlet.DispatcherServlet'; @ConditionalOnMissingClass did not find unwanted class (OnClassCondition)
- @ConditionalOnWebApplication (required) found StandardServletEnvironment (OnWebApplicationCondition)
***********************************這里還有很多省略了 ***********************************
Negative matches:(沒有啟動(dòng)续徽,沒有匹配成功的自動(dòng)配置類)
-----------------
ActiveMQAutoConfiguration:
Did not match:
- @ConditionalOnClass did not find required classes 'javax.jms.ConnectionFactory', 'org.apache.activemq.ActiveMQConnectionFactory' (OnClassCondition)
AopAutoConfiguration:
Did not match:
- @ConditionalOnClass did not find required classes 'org.aspectj.lang.annotation.Aspect', 'org.aspectj.lang.reflect.Advice' (OnClassCondition)
***********************************這里還有很多省略了 ***********************************