记录一些注解。

@Configuration

要点
（1）使用@Configuration标注的类是配置类，其本身也是组件，因为它本身就被@Component标注。
（2）配置类里面使用@Bean标注在方法上给容器注册组件，默认也是单实例的。
（3）proxyBeansMethods：代理bean的方法，默认是true。

模式

  • Full: @Configuration(_proxyBeanMethods = true)_
  • Lite: @Configuration(_proxyBeanMethods = false)_

在Full模式下，SpringBoot容器中再也不会保留配置类的代理对象，
在外面无限次调用组件都会产生新的对象，用于解决组件依赖。
在Lite模式下，SpringBoot总会检查配置类的成员组件是否在容器中，
如果在则直接使用容器中的组件，保持组件单实例，耗费性能。

场景
Full模式：配置类组件之间有依赖关系，方法会被调用得到之前单实例组件。
Lite模式：配置类组件之间无依赖关系，加速容器启动过程，减少判断。

示例
获取bean工具类：

  1. @Component
  2. public class SpringContextUtil implements ApplicationContextAware {
  4.     private static ApplicationContext applicationContext;
  6.     @Override
  7.     public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
  8.         SpringContextUtil.applicationContext = applicationContext;
  9.     }
  11.     public static ApplicationContext getApplicationContext() {
  12.         return applicationContext;
  13.     }
  15.     public static Object getBean(String name) {
  16.         return getApplicationContext().getBean(name);
  17.     }
  19.     public static <T> T getBean(Class<T> clazz)  {
  20.         return getApplicationContext().getBean(clazz);
  21.     }
  23.     public static <T> T getBean(String name, Class<T> clazz) {
  24.         return getApplicationContext().getBean(name, clazz);
  25.     }
  26. }

Lite配置类：

  1. @Configuration(proxyBeanMethods = true)
  2. public class LiteConfig {
  4.     class Lite extends Object { }
  6.     @Bean
  7.     public Lite lite() {
  8.         return new Lite();
  9.     }
  10. }

Full配置类：

  1. @Configuration(proxyBeanMethods = false)
  2. public class FullConfig {
  4.     class Full extends Object { }
  6.     @Bean
  7.     public Full full() {
  8.         return new Full();
  9.     }
  10. }

测试类：

  1. @SpringBootTest
  2. class KHighnessApplicationTest {
  3.     private final static Logger log = LoggerFactory.getLogger(KHighnessApplication.class);
  5.     @Test
  6.     public void fullMode() {
  7.         FullConfig fullConfig = SpringContextUtil.getBean(FullConfig.class);
  8.         Object obj1 = fullConfig.full();
  9.         Object obj2 = fullConfig.full();
  10.         log.info("Full模式下是否单例 => [{}]", obj1 == obj2);
  11.     }
  13.     @Test
  14.     public void liteMode() {
  15.         LiteConfig liteConfig = SpringContextUtil.getBean(LiteConfig.class);
  16.         Object obj1 = liteConfig.lite();
  17.         Object obj2 = liteConfig.lite();
  18.         log.info("Lite模式下是否单例 => [{}]", obj1 == obj2);
  19.     }
  21. }

liteMode测试结果：

  1. Lite模式下是否单例 => [true]

fullMode测试结果：

  1. Full模式下是否单例 => [false]

@PropertySource

功能
加载指定的配置文件到spring的environment中

  • 与@Value组合使用，将自定义属性文件中的属性变量注入到当前类的使用@Value标注的成员变量中
  • 与ConfugrationProperties组合使用，将文件与Java类绑定，将属性文件中的变量值注入到Java类的成员变量中

示例
在classpath下新建config文件夹，并新建highness.properties文件

  1. highness.name=KHighness
  2. highness.age=19
  3. highness.birth=2001-09-11

新建配置类KhighnessConfig：

  1. import org.springframework.boot.context.properties.ConfigurationProperties;
  2. import org.springframework.context.annotation.PropertySource;
  3. import org.springframework.format.annotation.DateTimeFormat;
  4. import org.springframework.stereotype.Component;
  6. import java.util.Date;
  8. /**
  9.  * @author KHighness
  10.  * @since 2021-04-14
  11.  */
  13. @Component
  14. @PropertySource(value = {"config/highness.properties"})
  15. @ConfigurationProperties(prefix = "highness")
  16. public class KHighnessConfig {
  18.     private String name;
  20.     private Integer age;
  22.     @DateTimeFormat(pattern = "yyyy-MM-dd")
  23.     private Date birth;
  25.     public String getName() {
  26.         return name;
  27.     }
  29.     public void setName(String name) {
  30.         this.name = name;
  31.     }
  33.     public Integer getAge() {
  34.         return age;
  35.     }
  37.     public void setAge(Integer age) {
  38.         this.age = age;
  39.     }
  41.     public Date getBirth() {
  42.         return birth;
  43.     }
  45.     public void setBirth(Date birth) {
  46.         this.birth = birth;
  47.     }
  49.     @Override
  50.     public String toString() {
  51.         return "KHighnessConfig[" +
  52.                 "name='" + name + '\'' +
  53.                 ", age=" + age +
  54.                 ", birth=" + birth +
  55.                 ']';
  56.     }
  57. }

新建命令行启动器OutputPropsRunner：

  1. import org.slf4j.Logger;
  2. import org.slf4j.LoggerFactory;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.boot.CommandLineRunner;
  5. import org.springframework.stereotype.Component;
  6. import top.parak.config.KHighnessConfig;
  8. /**
  9.  * @author KHighness
  10.  * @since 2021-04-14
  11.  */
  13. @Component
  14. public class OutputPropsRunner implements CommandLineRunner {
  16.     private static final Logger log = LoggerFactory.getLogger(OutputPropsRunner.class);
  18.     @Autowired
  19.     private KHighnessConfig kHighnessConfig;
  21.     @Override
  22.     public void run(String... args) throws Exception {
  23.         log.info(kHighnessConfig.toString());
  24.     }
  25. }

启动SpringBootApplication，可以看到有如下日志打印：

  1. KHighnessConfig[name='KHighness', age=19, birth=Tue Sep 11 00:00:00 CST 2001]