【SpringBoot1.x】SpringBoot1.x 配置

SpringBoot1.x 配置

文章源码

配置文件

SpringBoot 使用一个全局的配置文件，配置文件名是固定的。

application.properties、application.yml都是配置文件。

配置文件的作用：修改 SpringBoot 自动配置的默认值，SpringBoot 在底层都给我们自动配置好。

YAML 语法

YAML（YAML Ain't Markup Language），它是一个标记语言，又不是一个标记语言。yaml 文件以数据为中心，比 json、xml 等更适合做配置文件。

基本语法

k: v 表示一对键值对，空格必须有。

以空格的缩进来控制层级关系，只要是左对齐的一列数据，都是同一个层级的。属性和值对大小写敏感。

server:
  port: 8081
  path: /hello

值的写法

字面量，比如数字，字符串，布尔等普通的值：

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

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

name: "zhangsan 
 lisi"

'' 单引号；会转义特殊字符，特殊字符最终只是一个普通的字符串数据

name: 'zhangsan 
 lisi'

对象，即键值对：

对象还是 k: v 的方式

friends:
  lastName: zhangsan
  age: 20

等效的行内写法

friends: {lastName: zhangsan, age: 20}

数组，即 List、Set：

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

pets:
  ‐ cat
  ‐ dog
  ‐ pig

等效的行内写法

pets: [cat, dog, pig]

配置文件 值注入

先写实体类：

/**
 * @Author : parzulpan
 * @Time : 2020-12
 * @Desc : 人实体类
 *
 * 将配置文件中配置的每一个属性的值，映射到这个组件中
 * @ConfigurationProperties： 告诉 SpringBoot 将本类中的所有属性和配置文件中相关的配置进行绑定
 * prefix = "person" 配置文件中哪个下面的所有属性进行一一映射
 *
 */

@Component
@ConfigurationProperties(prefix = "person") // 默认从全局配置文件中获取值
public class Person {
    private String name;
    private Integer age;
    private Boolean boss;
    private Date date;

    private Map<String, Object> maps;
    private List<Object> lists;
    private Dog dog;

    // getter setter toString
}

在写配置文件之前，需要先导入配置文件处理器，这样配置文件进行绑定就会有提示。

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>

再写配置文件：

server:
  port: 8081

person:
  name: hello
  age: 18
  boss: true
  date: 2020/01/01
  maps: {k1: v1, k2: 12}
  lists:
    - ll
    - aa
  dog:
    name: xx
    age: 1

测试：

@RunWith(SpringRunner.class)
@SpringBootTest
public class ConfigApplicationTests {

    @Autowired
    Person person;

    @Test
    public void contextLoads() {
        System.out.println(person);
    }
}

@Value & @ConfigurationProperties

这两个注解的区别：

	@ConfigurationProperties	@Value
功能	批量注入配置文件中的属性	一个个指定
松散绑定（松散语法）	支持	不支持
SpEL	不支持	支持
JSR303数据校验 @Validated	支持	不支持
复杂类型封装	支持	不支持

配置文件 yml 还是 properties 他们都能获取到值。

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

如果说，我们专门编写了一个 JavaBean 来和配置文件进行映射，我们就直接使用 @ConfigurationProperties。

@PropertySource & @ImportResource & @Bean

@PropertySource 加载指定的配置文件

@PropertySource(value = {"classpath:person.properties"})
@Component
@ConfigurationProperties(prefix = "person")
public class Person{}

@ImportResource 导入 Spring 的配置文件，让配置文件里面的内容生效。SpringBoot 里面没有 Spring 的配置文件，我们自己编写的配置文件，也不能自动识别。想让Spring的配置文件生效，加载到容器中，可以用 @ImportResource 标注在一个配置类上。

@ImportResource(locations = {"classpath:beans.xml"})
@SpringBootApplication
public class ConfigApplication {}

但是这种写法太繁琐，SpringBoot 推荐给容器中添加组件的方式是使用全注解的方式。步骤为：

• 为 Spring 配置文件写一个配置类 @Configuration

• 使用 @Bean 给容器中添加组件

  @Configuration
  public class MyAppConfig {
      //将方法的返回值添加到容器中；容器中这个组件默认的 id 就是方法名
      @Bean
      public HelloService helloService(){
      System.out.println("配置类@Bean给容器中添加组件了...");
          return new HelloService();
      }
  }
  

• 可以测试容器是否含有组件

      @Autowired
      ApplicationContext ioc;
      
      public void testHasHelloService() {
          boolean helloService = ioc.containsBean("helloService");
          System.out.println(helloService);
      }
  

配置文件 占位符

随机数：

${random.value}、${random.int}、${random.long}
${random.int(10)}、${random.int[1024,65536]}

占位符获取之前配置的值，如果没有可以是用 : 指定默认值

person.last‐name=张三${random.uuid}
person.age=${random.int}
person.birth=2017/12/15
person.boss=false
person.maps.k1=v1
person.maps.k2=14
person.lists=a,b,c
person.dog.name=${person.hello:hello}_dog
person.dog.age=15

Profile 文件

Profile 是 Spring 对不同环境提供不同配置功能的支持，可以通过激活、
指定参数等方式快速切换环境。

多 Profile 文件方式

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

默认使用 application.properties 的配置。

application.properties

server.port=8080
spring.profiles.active=dev  # 指定使用那个环境

---

application-dev.properties

server.port=8081

---

application-prod.properties

server.port=8082

运行主配置类，会显示 Tomcat started on port(s): 8081 (http)

多文档块方式

yml 支持多文档块方式。

server:
  port: 8091
spring:
  profiles:
    active: dev

---

server:
  port: 8092
spring:
  profiles: dev
person:
  name: 哈哈
  age: 18
  boss: true
  date: 2020/01/01
  maps: {k1: v1, k2: 12}
  lists:
    - ll
    - aa
  dog:
    name: xx
    age: 1

---

server:
  port: 8093
spring:
  profiles: prod

运行主配置类，会显示 tomcat started on port(s): 8092 (http)

其他方式

可以直接在测试的时候，配置传入命令行参数

java -jar spring-boot-02-config-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev

配置文件 加载位置

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

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

以上优先级由高到底，高优先级的配置会覆盖低优先级的配置。SpringBoot 会从这四个位置全部加载主配置文件，以互补配置（高优先级没有的，就用低优先级的）的方式。

还可以通过 spring.config.location 来改变默认的配置文件位置。

项目打包好以后，我们可以使用命令行参数的形式，启动项目的时候来指定配置文件的新位置。指定配置文件和默认加载的这些配置文件共同起作用形成互补配置。

java -jar config-0.0.1-SNAPSHOT.jar --spring.config.location=/parzulpan/config/application.properties

外部配置 加载顺序

SpringBoot 也可以从以下位置加载配置，它们优先级从高到低。高优先级的配置覆盖低优先级的配置，所有的配置会形成互补配置。

一 命令行参数

所有的配置都可以在命令行上进行指定

java -jar config-0.0.1-SNAPSHOT.jar --server.port=8087 --server.context-path=/abc

多个配置用空格分开，格式为 --配置项=值

二 来自 java:comp/env 的 JNDI 属性

三 Java 系统属性（System.getProperties()）

四 操作系统环境变量

五 RandomValuePropertySource 配置的 random.* 属性值

---

由 jar包 外向 jar包 内进行寻找；优先加载带 profile

六 jar包 外部的 application-{profile}.properties 或 application.yml(带spring.profile) 配置文件

七 jar包 内部的 application-{profile}.properties 或 application.yml(带spring.profile) 配置文件

---

由 jar包 外向 jar包 内进行寻找；再来加载不带 profile

八 jar包 外部的 application.properties 或 application.yml(不带spring.profile) 配置文件

九 jar包 内部的 application.properties 或 application.yml(不带spring.profile) 配置文件

---

十 @Configuration 注解类上的 @PropertySource

十一 通过 SpringApplication.setDefaultProperties 指定的默认属性

可以参考官方文档

自动配置原理

这个非常重要。

配置文件能配置的属性参照

• SpingBoot 启动的时候加载主配置类，开启了自定配置功能 @EnableAutoConfiguration

• @EnableAutoConfiguration 利用 EnableAutoConfigurationImportSelector 给容器导入一些组件，它继承自 AutoConfigurationImportSelector，它包含一个很重要的方法：

  @Override
  public String[] selectImports(AnnotationMetadata annotationMetadata) {
      if (!isEnabled(annotationMetadata)) {
          return NO_IMPORTS;
      }
      try {
          AutoConfigurationMetadata autoConfigurationMetadata = AutoConfigurationMetadataLoader
                  .loadMetadata(this.beanClassLoader);
          AnnotationAttributes attributes = getAttributes(annotationMetadata);
          List<String> configurations = getCandidateConfigurations(annotationMetadata, attributes);   // 获取候选的配置
          // ...
      }
      catch (IOException ex) {
          throw new IllegalStateException(ex);
      }
  }
  

  protected List<String> getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes) {
      List<String> configurations = SpringFactoriesLoader.loadFactoryNames(getSpringFactoriesLoaderFactoryClass(),
              getBeanClassLoader());
      Assert.notEmpty(configurations, "No auto configuration classes found in META-INF/spring.factories. If you "
              + "are using a custom packaging, make sure that file is correct.");
      return configurations;
  }
  

• loadFactoryNames 方法，会扫描所有 jar包 类路径下的 META‐INF/spring.factories，把扫描到的这些文件的包装成 properties 对象，从中获取到 EnableAutoConfiguration.class 类对应的值，然后把它们添加到容器中。可以看到 spring.factories 如下，每一个这样的 xxxAutoConfiguration 类都是容器中的一个组件，都加入到容器中，用它们来做自动配置。

  # Auto Configure
  org.springframework.boot.autoconfigure.EnableAutoConfiguration=
  org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,
  # 省略...
  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
  

HttpEncodingAutoConfiguration 为例

它为 Http 编码自动配置。

其源码为：

// 表示这是一个配置类，即可以向容器中添加组件。
@Configuration

// 启动指定类的 ConfigurationProperties 功能，即将配置文件中对应的值和 HttpEncodingProperties 绑定起来，
// 并把 HttpEncodingProperties 添加到 IOC 容器中。
@EnableConfigurationProperties(HttpEncodingProperties.class)

// @Conditional 的扩展注解，可以设置不同条件，如果满足指定的条件，整个配置类就会生效。这里的条件是判断当前应用是否是 Web 应用。
@ConditionalOnWebApplication

// @Conditional 的扩展注解，这里的条件是判断当前应用是否有这个类，即 SpringMVC 配置中解决乱码的过滤器。
@ConditionalOnClass(CharacterEncodingFilter.class)

// @Conditional 的扩展注解，这里的条件是判断配置文件中是否存在某个配置 spring.http.encoding.enabled，如果不存在，判断也是成立的。即使我们配置文件中不配置 pring.http.encoding.enabled=true，也是默认生效的。
@ConditionalOnProperty(prefix = "spring.http.encoding", value = "enabled", matchIfMissing = true)
public class HttpEncodingAutoConfiguration {

    // 已经和 SpringBoot 的配置文件映射了
    private final HttpEncodingProperties properties;

    // 只有一个有参构造器的情况下，参数的值就会从容器中拿
    public HttpEncodingAutoConfiguration(HttpEncodingProperties properties) {
        this.properties = properties;
    }

    // 给容器中添加一个组件，这个组件的某些值需要从 properties 中获取
    @Bean
    // @Conditional 的扩展注解，这里的条件是判断容器有没有这个组件
    @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;
    }
}

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

所有在配置文件中能配置的属性都是在 xxxxProperties 类中封装着，配置文件能配置什么就可以参照某个功能对应的这个属性类。

@ConfigurationProperties(prefix = "spring.http.encoding")
public class HttpEncodingProperties {

    public static final Charset DEFAULT_CHARSET = Charset.forName("UTF-8");
    private Charset charset = DEFAULT_CHARSET;
    private Boolean force;
    private Boolean forceRequest;
    private Boolean forceResponse;
    // ...
}

自动配置原理总结

• SpingBoot 启动会加载大量的自动配置类
• 开发时，可以看需要的功能有没有 SpringBoot 默认写好的自动配置类
• 如果有默认的自动配置类，可以再看这个自动配置类中到底配置了哪些组件
• 给容器中自动配置类添加组件的时候，会从相应的 xxxxProperties 类中获取某些属性。我们就可以在配置文件中指定这些属性的值。
• 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 存在指定项

我们知道，自动配置类必须在一定的条件下才能生效，那么怎么知道哪些自动配置类生效呢？

可以通过启用 debug=true 属性，来让控制台打印自动配置报告，这样我们就可以很方便的知道哪些自动配置类生效。

# 自动配置类启用的
Positive matches:
-----------------

   DispatcherServletAutoConfiguration matched:
      - @ConditionalOnClass found required class 'org.springframework.web.servlet.DispatcherServlet'; @ConditionalOnMissingClass did not find unwanted class (OnClassCondition)
      - @ConditionalOnWebApplication (required) found 'session' scope (OnWebApplicationCondition)

   DispatcherServletAutoConfiguration.DispatcherServletConfiguration matched:
      - @ConditionalOnClass found required class 'javax.servlet.ServletRegistration'; @ConditionalOnMissingClass did not find unwanted class (OnClassCondition)
      - Default DispatcherServlet did not find dispatcher servlet beans (DispatcherServletAutoConfiguration.DefaultDispatcherServletCondition)

# 没有启动，没有匹配成功的自动配置类
Negative matches:
-----------------

   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)

练习和总结