在 Spring 4 后才引入了 @Conditional 等條件注解，它是 Spring Boot 中實(shí)現(xiàn)自動(dòng)配置的最大功臣！

那么問(wèn)題來(lái)了：如果我們還在使用 Spring 3.x 的老版本，這時(shí)候要怎么實(shí)現(xiàn)一個(gè)自動(dòng)配置呢？

需求和問(wèn)題

核心的訴求

1. 現(xiàn)存系統(tǒng)，不打算重構(gòu)
2. Spring 版本為 3.x，也不打算升級(jí)版本和引入 Spring Boot
3. 期望能夠在少改代碼的前提下實(shí)現(xiàn)功能增強(qiáng)

比如說(shuō)：

1. 希望能夠給全站統(tǒng)一添加上日志記錄（如：RPC 框架 Web 調(diào)用的摘要信息、數(shù)據(jù)庫(kù)訪問(wèn)層的摘要信息），這個(gè)其實(shí)是個(gè)通用的功能。
2. 我們引用了一些基礎(chǔ)設(shè)施，并想對(duì)這些基礎(chǔ)設(shè)施的功能作進(jìn)一步的增強(qiáng)，這時(shí)候就應(yīng)該從框架的層面來(lái)解決這個(gè)問(wèn)題。

面臨的問(wèn)題

• 3.x 的 Spring 沒(méi)有條件注解

因?yàn)闆](méi)有條件注解，所以我們不清楚在什么時(shí)候 需要/不需要 配置這些東西

• 無(wú)法自動(dòng)定位需要加載的自動(dòng)配置
  

此時(shí)我們沒(méi)有辦法像 Spring Boot 的自動(dòng)配置那樣讓框架自動(dòng)加載我們的配置，我們要使用一些別的手段讓 Spring 可以加載到我們定制的這些功能。

核心解決思路

條件判斷

• 通過(guò) BeanFactoryPostProcessor 進(jìn)行判斷

Spring 為我們提供了一個(gè)擴(kuò)展點(diǎn)，我們可以通過(guò) BeanFactoryPostProcessor 來(lái)解決條件判斷的問(wèn)題，它可以讓我們?cè)?BeanFactory 定義完之后、Bean 的初始化之前對(duì)我們這些 Bean 的定義做一些后置的處理?？梢栽谶@個(gè)時(shí)候?qū)ξ覀兊?Bean 定義做判斷，看看當(dāng)前 存在/缺少 哪些 Bean 的定義，還可以增加一些 Bean 的定義 —— 加入一些自己定制的 Bean。

配置加載

• 編寫 Java Config 類
• 引入配置類
  • 通過(guò) component-scan
  • 通過(guò) XML 文件 import

可以考慮編寫自己的 Java Config 類，并把它加到 component-scan 里面，然后想辦法讓現(xiàn)在系統(tǒng)的 component-scan 包含我們編寫的 Java Config 類；也可以編寫 XML 文件，如果當(dāng)前系統(tǒng)使用 XML 的方式，那么它加載的路徑上是否可以加載我們的 XML 文件，如果不行就可以使用手動(dòng) import 這個(gè)文件。

Spring 提供的兩個(gè)擴(kuò)展點(diǎn)

BeanPostProcessor

• 針對(duì) Bean 實(shí)例
• 在 Bean 創(chuàng)建后提供定制邏輯回調(diào)

BeanFactoryPostProcessor

• 針對(duì) Bean 定義
• 在容器創(chuàng)建 Bean 前獲取配置元數(shù)據(jù)
• Java Config 中需要定義為 static 方法（如果不定義，Spring 在啟動(dòng)時(shí)會(huì)報(bào)一個(gè) warning，你可嘗試一下）

關(guān)于 Bean 的一些定制

既然上面提到了 Spring 的兩個(gè)擴(kuò)展點(diǎn)，這里就延展一下關(guān)于 Bean 的一些定制的方式。

Lifecycle Callback

InitializingBean / @PostConstruct / init-method

這部分是關(guān)于初始化的，可以在 Bean 的初始化之后做一些定制，這里有三種方式：

• 實(shí)現(xiàn) InitializingBean 接口
• 使用 @PostConstruct 注解
• 在 Bean 定義的 XML 文件里給它指定一個(gè) init-method；亦或者在使用 @Bean 注解時(shí)指定 init-method

這些都可以讓我們這個(gè) Bean 在創(chuàng)建之后去調(diào)用特定的方法。

DisposableBean / @PreDestroy / destroy-method

這部分是在 Bean 回收的時(shí)候，我們?cè)撟龅囊恍┎僮??？梢灾付ㄟ@個(gè) Bean 在銷毀的時(shí)候，如果：

• 它實(shí)現(xiàn)了 DisposableBean 這個(gè)接口，那么 Spring 會(huì)去調(diào)用它相應(yīng)的方法
• 也可以將 @PreDestroy 注解加在某個(gè)方法上，那么會(huì)在銷毀時(shí)調(diào)用這個(gè)方法
• 在 Bean 定義的 XML 文件里給它指定一個(gè) destroy-method；亦或者在使用 @Bean 注解時(shí)指定 destroy-method，那么會(huì)在銷毀時(shí)調(diào)用這個(gè)方法

XxxAware 接口

• ApplicationContextAware
  

可以把整個(gè) ApplicationContext 通過(guò)接口進(jìn)行注入，在這個(gè) Bean 里我們就可以獲得一個(gè)完整的 ApplicationContext。

• BeanFactoryAware

與 ApplicationContextAware 類似。

• BeanNameAware

可以把 Bean 的名字注入到這個(gè)實(shí)例中來(lái)。

如果對(duì)源碼感興趣，可見：org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean\
如果當(dāng)前 Bean 存在 close 或 shutdown 方法名的方法時(shí)，會(huì)被 Spring 視為 destroy-method，在銷毀時(shí)會(huì)進(jìn)行調(diào)用。

一些常用操作

判斷類是否存在

• ClassUitls.isPresent()

調(diào)用 Spring 提供的 ClassUitls.isPresent() 來(lái)判斷一個(gè)類是否存在當(dāng)前 Class Path 下。

判斷 Bean 是否已定義

• ListableBeanFactory.containsBeanDefinition()：判斷 Bean 是否已定義。
• ListableBeanFactory.getBeanNamesForType()：可以查看某些類型的 Bean 都有哪些名字已經(jīng)被定義了。

注冊(cè) Bean 定義

• BeanDefinitionRegistry.registerBeanDefinition()
  • GenericBeanDefinition
• BeanFactory.registerSingleton()

擼起袖子加油干

理論就科普完了，下面就開始實(shí)踐。

在當(dāng)前的例子中，我們假定一下當(dāng)前環(huán)境為：沒(méi)有使用 Spring Boot 以及高版本的 Spring。

Step 1：模擬低版本的 Spring 環(huán)境

這里只是簡(jiǎn)單地引入了 spring-context 依賴，并沒(méi)有真正的使用 Spring 3.x 的版本，但也沒(méi)有使用 Spring 4 以上的一些特性。

<dependencies>
 <dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-context</artifactId>
 </dependency>
 <dependency>
  <groupId>org.projectlombok</groupId>
  <artifactId>lombok</artifactId>
 </dependency>
 <dependency>
  <groupId>io.github.y0ngb1n.samples</groupId>
  <artifactId>custom-starter-core</artifactId>
  <scope>provided</scope>
 </dependency>
</dependencies>

Step 2：以實(shí)現(xiàn) BeanFactoryPostProcessor 接口為例

@Slf4j
public class GreetingBeanFactoryPostProcessor implements BeanFactoryPostProcessor {

 @Override
 public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory)
  throws BeansException {

  // 判斷當(dāng)前 Class Path 下是否存在所需要的 GreetingApplicationRunner 這么一個(gè)類
  boolean hasClass = ClassUtils
   .isPresent("io.github.y0ngb1n.samples.greeting.GreetingApplicationRunner",
    GreetingBeanFactoryPostProcessor.class.getClassLoader());

  if (!hasClass) {
   // 類不存在
   log.info("GreetingApplicationRunner is NOT present in CLASSPATH.");
   return;
  }

  // 是否存在 id 為 greetingApplicationRunner 的 Bean 定義
  boolean hasDefinition = beanFactory.containsBeanDefinition("greetingApplicationRunner");
  if (hasDefinition) {
   // 當(dāng)前上下文已存在 greetingApplicationRunner
   log.info("We already have a greetingApplicationRunner bean registered.");
   return;
  }

  register(beanFactory);
 }

 private void register(ConfigurableListableBeanFactory beanFactory) {

  if (beanFactory instanceof BeanDefinitionRegistry) {
   GenericBeanDefinition beanDefinition = new GenericBeanDefinition();
   beanDefinition.setBeanClass(GreetingApplicationRunner.class);

   ((BeanDefinitionRegistry) beanFactory)
    .registerBeanDefinition("greetingApplicationRunner", beanDefinition);
  } else {

   beanFactory.registerSingleton("greetingApplicationRunner", new GreetingApplicationRunner());
  }
 }
}

注冊(cè)我們的 Bean（見 CustomStarterAutoConfiguration），如下有幾點(diǎn)是需要注意的：

• 這里的方法定義為 static
• 使用時(shí)，如果兩項(xiàng)目不是在同個(gè)包下，需要主動(dòng)將當(dāng)前類加入到項(xiàng)目的 component-scan 里

@Configuration
public class CustomStarterAutoConfiguration {

 @Bean
 public static GreetingBeanFactoryPostProcessor greetingBeanFactoryPostProcessor() {
  return new GreetingBeanFactoryPostProcessor();
 }
}

Step 3：驗(yàn)證該自動(dòng)配置是否生效

在其他項(xiàng)目中添加依賴：

<dependencies>
 ...
 <dependency>
  <groupId>io.github.y0ngb1n.samples</groupId>
  <artifactId>custom-starter-spring-lt4-autoconfigure</artifactId>
 </dependency>
 <dependency>
  <groupId>io.github.y0ngb1n.samples</groupId>
  <artifactId>custom-starter-core</artifactId>
 </dependency>
 ...
</dependencies>

啟動(dòng)項(xiàng)目并觀察日志（見 custom-starter-examples），驗(yàn)證自動(dòng)配置是否生效了：

 .  ____     _      __ _ _
 /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/ ___)| |_)| | | | | || (_| | ) ) ) )
 ' |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::    (v2.1.0.RELEASE)

2019-05-02 20:47:27.692 INFO 11460 --- [      main] i.g.y.s.d.AutoconfigureDemoApplication  : Starting AutoconfigureDemoApplication on HP with PID 11460 ...
2019-05-02 20:47:27.704 INFO 11460 --- [      main] i.g.y.s.d.AutoconfigureDemoApplication  : No active profile set, falling back to default profiles: default
2019-05-02 20:47:29.558 INFO 11460 --- [      main] i.g.y.s.g.GreetingApplicationRunner   : Initializing GreetingApplicationRunner.
2019-05-02 20:47:29.577 INFO 11460 --- [      main] i.g.y.s.d.AutoconfigureDemoApplication  : Started AutoconfigureDemoApplication in 3.951 seconds (JVM running for 14.351)
2019-05-02 20:47:29.578 INFO 11460 --- [      main] i.g.y.s.g.GreetingApplicationRunner   : Hello everyone! We all like Spring!

到這里，已成功在低版本的 Spring 中實(shí)現(xiàn)了類似自動(dòng)配置的功能。clap

代碼托管于 GitHub，歡迎 Star

參考鏈接

https://github.com/y0ngb1n/spring-boot-samples
https://github.com/digitalsonic/geektime-spring-family

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論