SpringBoot的配置

1. 配置文件

SpringBoot使用一个全局的配置文件,以下二选一,且配置文件名字是固定的.

  • application.properties
  • application.yml

作用 : 修改springboot的默认配置

存放目录 : /src/main/resources目录或者类路径/config

YAML (YAML Ain’t Markup Language)

标记语言 :

以前的配置文件大多使用 xxx.properties 文件

而 yml 以数据为中心,比 json , xml 等更适合做配置文件

几种类型配置文件实例 : 配置服务器的端口

  1. xml文件
<server>
    <port>8080</port>
</server>
  1. properties文件
server.port=8080
  1. yml文件
server:
  port: 8080

三种相比较而言,yml文件比较简洁,不需要花时间在开关闭标签和 = 号


2. YAML的基本语法

1. 基本语法

key:(空格)v : 表示一对键值对(空格必须有)

以空格的缩进来控制层级关系,只要是左对齐的一列数据,都是同一个层级的.

server:
	port: 8081
	path: hello

属性和值也是大小写敏感的

2. 值的写法

字面量 : 普通的值(数字,字符串,布尔)

key: value : 字面直接来写

字符串默认不用加双引号或者单引号

“” : 双引号 : 不会转义字符串里面的特殊字符,特殊字符会作为本身想表示的意思

例如 :

name: “zhangsan \n lisi” 输出 : “zhaungsan 换行 lisi”

‘’ : 单引号 : 回转仪字符串里面的特殊字符,特殊字符最终只是一个普通的字符串数据

例如 :

name: “zhangsan \n lisi” 输出 : “zhaungsan \n lisi”

对象 : 属性写在下面一行

person: lastName: zhangsan age: 20

行内写法 :

person: {lastName: zhangsan,age: 20}

数组 : List Set

用 "- xxx"表示数组中的一个元素

animals: - dog - cat - pig

行内写法 :

animals: [dog,cat,pig]

3. 配置文件值的注入

1. 使用@ConfigurationProperties进行注入
1. 使用yaml配置

配置文件

person:
  lastName: zhangsan
  age: 18
  isBoss: false
  birth: 2018/2/12
  maps: {k1: v1,k2: v2}
  dog:
    name: xiaogou
    age: 12
  lists:
    - lisi
    - zhaoliu

JavaBean

/**
 *  将配置文件的属性映射到组件中
 *  @ConfigurationProperties : 告诉springboot将奔雷的所有属性和配置文件的相关的配置进行绑定
 *  prefix="person" 配置文件中的哪个进行对应
 *  使用 @ConfigurationProperties 必须标注该类为组件类
 */
@Component
@ConfigurationProperties(prefix="person")
public class Person {

    private String lastName;
    private Integer age;
    private boolean isBoss;
    private Date birth;

    private Map<String,Object> maps;
    private List<Object> lists;
    private Dog dog;
    
    //省略getter setter
}

public class Dog {

    private String name;
    private Integer age;
	
    //省略getter setter

}

测试

@Autowired
Person person;

@Test
public void contextLoads() {
    System.out.println(person);
}
测试结果 :
Person{lastName='111', age=21, boss=true, birth=Sun Dec 14 00:00:00 CST 2222, map={k1=v1, k2=v2}, list=[王五, 李四, 张三], dog=com.lfy.bean.Dog@1436a7ab}

期间在pom.xml中添加配置文件处理器 , 使其在配置文件中写属性值时有提示

<!-- 配置文件处理器 配置在属性与组件类进行映射时自动提示 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>
2.使用Properties进行配置

java springboot设置secure属性_spring

配置文件

person.last-name=张三
person.age=21
person.boss=false
person.birth=1997/12/14
person.maps.k1=v1
person.maps.k2=v2
person.lists=a1,a2,a3
person.dog.name=dog
person.dog.age=15
3. 配置文件注入值校验
@Component
@Validated
@ConfigurationProperties(prefix="person")
public class Person {
    //格式必须为email格式
    @Email
    private String email;

如果不是email格式,则出错

***************************
APPLICATION FAILED TO START
***************************

Description:

Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'person' to com.lfy.bean.Person failed:

    Property: person.email
    Value: lifanyu
    Origin: class path resource [application.properties]:7:14
    Reason: 不是一个合法的电子邮件地址
2. 使用@value进行配置
@Component
public class Person {

    /***
     *  <bean>
     *      <property name="xxx" value="字面量/
     									${key}从环境变量中取值,配置文件中取值/
     									#{SpEL}">
     		</property>
     *  </bean>
     */
    @Value("Lisi")
    private String lastName;
    @Value("#{10*2}")
    private Integer age;
    @Value("${person.isBoss}")
3. @Value和@ConfigurationProperties对比

@Value

@ConfigurationProperties

功能

一个个指定

批量注入配置文件中的属性

松散绑定

不支持

支持

SpEL

支持

不支持

JSR303数据校验

不支持

支持

复杂类型的封装

不支持

支持

如果只是在某个业务逻辑下需要获取一下配置文件的某项值,使用@Value

例如 :

// 只在 controller 中使用一下 name
@RestController
public class HelloController {

    @Value("${person.last-name}")
    private String name;

    @RequestMapping("hello")
    public String sayHello(){
        return "Hello "+ name;
    }
}

java springboot设置secure属性_springboot_02

如果专门编写了一个Javabean来和配置文件进行映射,就直接使用@ConfigurationProperties


4. 两个配置

@PropertySource

@PropertySource : 加载指定的配置文件

@Component
@Validated
@ConfigurationProperties(prefix="person")
//@PropertySource(value={"classpath:person.properties"})    默认加载主配置文件
@PropertySource(value={"classpath:person.properties"})
public class Person {
    private String lastName;
    private Integer age;
    private boolean isBoss;
    private Date birth;
@ImportResource

@ImportResource : 加载spring的配置文件,使其生效

SpringBoot里面没有spring的配置文件,我们自己编写配置文件,需要在配置类中添加@ImportResource注解使配置文件生效.

在配置类中添加

@ImportResource(locations={"classpath:Beans.xml"})
@SpringBootApplication
public class Springboot03ConfigApplication {
    public static void main(String[] args) {
        SpringApplication.run(Springboot03ConfigApplication.class, args);
    }
}
官方推荐添加组件方式

官方推荐的方式是全注解的

配置类 ---- Spring配置文件

/** * @Configuration 指明是一个配置类 * * 方法的返回值将会放入容器中: * 方法的名字作为bean的id */ @Configuration public class MyAppConfig { @Bean public HelloService helloService(){ return new HelloService(); } } //springboot的测试类 @RunWith(SpringRunner.class) @SpringBootTest public class SpringBoot02ApplicationTests { @Autowired org.springframework.context.ApplicationContext ioc; @Test public void testHelloService(){ boolean b = ioc.containsBean("helloService"); System.out.println(b); } }


5. 配置文件占位符

1. 随机数(RandomaValuePropertySource)
${random.value}, ${random.int}, ${random.long}
2. 属性配置占位符前面配置过的值
  • 可以在配置文件中引用前面配置过的属性
  • ${app.name:默认值} 来指定,如果找不到使用默认值
3. 示例
person.last-name=张三${random.uuid}
person.age=${random.int}
person.isBoss=false
person.dog.name=${person.last-name}_dog
person.dog.age=${person.age:14}

6. Profile

1. 多Profile文件

我们在主配置文件编写的时候,文件名可以是 : application-{profile}.properties/yml

默认使用 application.properties,然后在里面配置 spring.profiles.active=prod 激活指定profile

java springboot设置secure属性_配置_03

java springboot设置secure属性_springboot_04

2. yml支持多文档块的方式
server:
  port: 8080
spring:
  profiles:
    active: dev
---
server:
     port: 8081
spring:
  profiles: dev
---
server:
     port: 8082
spring:
  profiles: prod
3. 激活指定的profile
1. 多profile文件

在主配置(application.properties)文件中加入:

spring.profiles.active=prod
2. 在yml中加入:
spring:
  profiles:
    active: dev
3. 命令行

先打成jar包

然后使用cmd运行

命令为 : java -jar spring-boot-02-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev

4. 在idea中修改jvm参数

java springboot设置secure属性_加载_05

java springboot设置secure属性_加载_06


6. 配置文件加载位置

SpringBoot启动会扫描以下位置的application.properties或者application.yml文件作为Springboot的默认配置文件.

  • file: ./config/
  • file: ./
  • classpath:/config/
  • classpath:/

优先级由高到低,高优先级的配置会覆盖低优先级的配置.

SpringBoot会从这四个部分全部加载主配置文件 : 互补配置.

例子 :

配置一 : classpath:/

java springboot设置secure属性_springboot_07

配置二 : classpath:/config/

java springboot设置secure属性_配置文件_08

配置三 : file:./

java springboot设置secure属性_spring_09

配置四 : file: ./config/

java springboot设置secure属性_配置_10

配置五 : spring.config.location 方式

在配置文件中通过 spring.config.location 指定默认加载位置.

我们还可以通过spring.config.location来改变默认的配置文件位置,项目打包之后,我们可以使用命令行参数的形式启动项目来指定配置文件的新位置,指定配置文件和默认加载的这些配置文件共同起作用形成互补配置.

例子 :

先打包

然后通过命令行输入 :

java -jar spring-boot-02-0.0.1-SNAPSHOT.jar --spring.config.location=C:\Users\15099\Desktop\application.properties

完成改变默认位置.


7. 外部配置加载顺序

SpringBoot也可以在以下位置加载配置 : 优先级从高到低

高优先级的配置覆盖低优先级的配置

所有配置会形成互补配置

  1. 命令行参数

java -jar spring-boot-02-config-SNAPSHOT.jar --server.port=8087 --server.context-path=/abc

多个配置用空格分开 : 配置项 = 值

  1. 来自 java:comp/env 的 JNDI 属性
  2. java系统属性(System.)
  3. 操作系统环境变量
  4. RandomValuePropertySource 配置的 random.* 属性值

由 jar 包外向 jar 包内寻找. 由带 profile 的向不带 profile 的加载

例如 :

java springboot设置secure属性_配置_11

  1. jar包外部的 application-{profile}.properties 或者 application.yml (带spring.profile)配置文件
  2. jar包内部的 application-{profile}.properties 或者 application.yml (带spring.profile)配置文件
  3. jar包外部的 application.properties 或者 application.yml (不带spring.profile)配置文件
  4. jar包内部的 application.properties 或者 application.yml (不带spring.profile)配置文件
  5. @Configuration 注解类上的 @propertySource
  6. 通过 SpringApplication.setDefaultProperties指定的默认属性

8. 自动配置原理

配置文件写什么? 怎么写?

自动配置原理 :

  1. springboot启动的时候加载主配置类,开启了自动配置功能@EnableAutoConfiguration
  2. @EnableAutoConfiguration作用 :

利用selector

  1. SpringBoot启动的时候加载主配置类,开启了自动配置功能 @EnableAutoConfiguration
  2. @EnableAutoConfiguration 作用:
  • 利用EnableAutoConfigurationImportSelector给容器中导入一些组件?
  • 可以查看selectImports()方法的内容;
  • List configurations = getCandidateConfigurations(annotationMetadata, attributes);获取候选的配置
SpringFactoriesLoader.loadFactoryNames()
扫描所有jar包类路径下  META-INF/spring.factories
把扫描到的这些文件的内容包装成properties对象
从properties中获取到EnableAutoConfiguration.class类(类名)对应的值,然后把他们添加在容器中
**==将 类路径下  META-INF/spring.factories 里面配置的所有EnableAutoConfiguration的值加入到了容器中;==**
 
 ```properties
 # Auto Configure
 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

每一个这样的 xxxAutoConfiguration类都是容器中的一个组件,都加入到容器中;用他们来做自动配置;

  1. 每一个自动配置类进行自动配置功能;
  2. 以**HttpEncodingAutoConfiguration(Http编码自动配置)**为例解释自动配置原理;
@Configuration   //表示这是一个配置类,以前编写的配置文件一样,也可以给容器中添加组件
 @EnableConfigurationProperties(HttpEncodingProperties.class)  //启动指定类的ConfigurationProperties功能;将配置文件中对应的值和HttpEncodingProperties绑定起来;并把HttpEncodingProperties加入到ioc容器中
 
 @ConditionalOnWebApplication //Spring底层@Conditional注解(Spring注解版),根据不同的条件,如果满足指定的条件,整个配置类里面的配置就会生效;    判断当前应用是否是web应用,如果是,当前配置类生效
 
 @ConditionalOnClass(CharacterEncodingFilter.class)  //判断当前项目有没有这个类CharacterEncodingFilter;SpringMVC中进行乱码解决的过滤器;
 
 @ConditionalOnProperty(prefix = "spring.http.encoding", value = "enabled", matchIfMissing = true)  //判断配置文件中是否存在某个配置  spring.http.encoding.enabled;如果不存在,判断也是成立的
 //即使我们配置文件中不配置pring.http.encoding.enabled=true,也是默认生效的;
 public class HttpEncodingAutoConfiguration {
   
     //他已经和SpringBoot的配置文件映射了
     private final HttpEncodingProperties properties;
   
    //只有一个有参构造器的情况下,参数的值就会从容器中拿
     public HttpEncodingAutoConfiguration(HttpEncodingProperties properties) {
         this.properties = properties;
     }
   
     @Bean   //给容器中添加一个组件,这个组件的某些值需要从properties中获取
     @ConditionalOnMissingBean(CharacterEncodingFilter.class) //判断容器没有这个组件?
     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;
     }

根据当前不同的条件判断,决定这个配置类是否生效?

一但这个配置类生效;这个配置类就会给容器中添加各种组件;这些组件的属性是从对应的properties类中获取的,这些类里面的每一个属性又是和配置文件绑定的;

  1. 所有在配置文件中能配置的属性都是在xxxxProperties类中封装者‘;配置文件能配置什么就可以参照某个功能对应的这个属性类
@ConfigurationProperties(prefix = "spring.http.encoding")  //从配置文件中获取指定的值和bean的属性进行绑定
public class HttpEncodingProperties {

public static final Charset DEFAULT_CHARSET = Charset.forName("UTF-8");

精髓:

1)、SpringBoot启动会加载大量的自动配置类

2)、我们看我们需要的功能有没有SpringBoot默认写好的自动配置类;

3)、我们再来看这个自动配置类中到底配置了哪些组件;(只要我们要用的组件有,我们就不需要再来配置了)

4)、给容器中自动配置类添加组件的时候,会从properties类中获取某些属性。我们就可以在配置文件中指定这些属性的值;

xxxxAutoConfigurartion:自动配置类;

给容器中添加组件

xxxxProperties:封装配置文件中相关属性;

细节 :

@Conditional派生注解

作用 : 必须是 @Conditional指定的条件成立,才能容器中添加组件,配置里面的所有内容生效.

@Conditional 扩展注解

作用(判断是否满足当前指定条件)

@ConditionalOnJava

系统的java版本是否符合要求

@ConditionalOnBean

容器中存在指定Bean

@ConditionalOnMissingBean

容器中不存在指定Bean

@ConditionalOnExpression

满足SpEL表达式指定

@ConditionalOnClass

系统中有指定的类

@ConditionalOnMissingClass

系统中没有指定的类

@ConditionalOnSingleCandidate

容器中只有一个指定的Bean,或者这个Bean是首选Bean

@ConditionalOnProperty

系统中指定的属性是否有指定的值

@ConditionalOnResource

类路径下是否存在指定资源文件

@ConditionalOnWebApplication

当前是web环境

@ConditionalOnNotWebApplication

当前不是web环境

@ConditionalOnJndi

JNDI存在指定项

根据当前不同的条件判断,决定这个配置类是否生效.

一旦这个配置类生效,则这个配置类就会给容器中添加各种组件,这些组件的属性是从对应的properties容器中获取的,这些类里面的每一个属性又是和配置文件绑定的.

我们可以通过在 application.properties 中编写启用 debug = true 来让控制台打印自动配置报告,这样我们就可以很方便的知道哪些自动配置是有效的.

============================
CONDITIONS EVALUATION REPORT
============================


Positive matches:(自动配置启用的)
-----------------

    CodecsAutoConfiguration matched:
- @ConditionalOnClass found required class 'org.springframework.http.codec.CodecConfigurer' (OnClassCondition)

    CodecsAutoConfiguration.JacksonCodecConfiguration matched:
- @ConditionalOnClass found required class 'com.fasterxml.jackson.databind.ObjectMapper' (OnClassCondition)

    CodecsAutoConfiguration.JacksonCodecConfiguration#jacksonCodecCustomizer matched:
- @ConditionalOnBean (types: com.fasterxml.jackson.databind.ObjectMapper; SearchStrategy: all) found bean 'jacksonObjectMapper' (OnBeanCondition)

    Negative matches:(自动配置中没有启用的)
-----------------

    ActiveMQAutoConfiguration:
Did not match:
- @ConditionalOnClass did not find required class 'javax.jms.ConnectionFactory' (OnClassCondition)

    AopAutoConfiguration:
Did not match:
- @ConditionalOnClass did not find required class 'org.aspectj.lang.annotation.Aspect' (OnClassCondition)

    ArtemisAutoConfiguration:
Did not match:
- @ConditionalOnClass did not find required class 'javax.jms.ConnectionFactory' (OnClassCondition)