ApplicationContextInitializer钩子函数学习

ApplicationContextInitializer 是 Spring 提供的一个钩子，用于在 Spring 容器初始化的早期阶段进行自定义配置和操作。它是在 Spring Boot 启动过程中非常重要的一个接口，允许开发者在 Spring 容器刷新之前对环境（如配置、属性等）进行调整。

1. ApplicationContextInitializer 作用和位置：

ApplicationContextInitializer 主要用于在 Spring 容器（ApplicationContext）加载之前，修改和增强应用程序环境、属性或者配置等。它是在 Spring 容器完全初始化前的一个点进行的操作。

在 Spring Boot 中，ApplicationContextInitializer 的执行发生在 Spring 应用程序上下文刷新之前，具体来说，它位于以下几个重要生命周期步骤之间：

Spring Boot 启动 → SpringApplication 构建和环境准备 → ApplicationContextInitializer 执行 → ApplicationContext 初始化生命周期阶段： 在 Spring Boot 启动时，Spring 环境（ConfigurableEnvironment）被设置，并在应用上下文创建之前，ApplicationContextInitializer 会被调用。 2. ApplicationContextInitializer 生命周期中的作用： 2.1. Spring Boot 启动过程中的位置：

ApplicationContextInitializer 在 Spring Boot 启动过程中，处于环境准备和应用上下文创建之间的关键阶段。具体来说：

创建 SpringApplication 实例：SpringApplication 用于启动 Spring Boot 应用程序。ApplicationContextInitializer 执行：在 Spring Boot 初始化应用上下文之前，ApplicationContextInitializer 会被调用。创建 ApplicationContext 实例：应用上下文被创建后，初始化 Bean、加载配置等。应用启动完成：应用正式启动并开始处理请求。 2.2. 作用： 环境定制和修改：ApplicationContextInitializer 允许开发者修改和定制 Spring 环境（ConfigurableEnvironment），如动态修改系统属性、环境变量、配置文件的加载顺序等。属性配置：通过 ApplicationContextInitializer 可以在容器初始化之前配置不同的属性值，或修改某些默认设置（例如，改变 application.properties 的加载顺序或内容）。条件配置：可以根据特定条件修改 Spring 配置，例如在特定的环境下启用或禁用某些功能。设置属性：在 Spring 容器完全初始化前，可以通过 System.setProperty() 或者 environment.getProperty() 来修改环境的属性值。 3. 典型应用场景：

ApplicationContextInitializer 适合用于以下场景：

3.1. 修改环境属性或配置

比如，应用启动时需要根据某些外部条件修改环境属性（例如读取外部文件、系统环境变量等），可以使用 ApplicationContextInitializer 来进行配置：

public class MyEnvironmentInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> { @Override public void initialize(ConfigurableApplicationContext applicationContext) { // 获取当前环境 ConfigurableEnvironment environment = applicationContext.getEnvironment(); // 根据某些条件修改环境变量 String externalProperty = System.getenv("EXTERNAL_CONFIG"); if (externalProperty != null) { environment.getPropertySources().addFirst(new MapPropertySource("external-config", Map.of("my.property", externalProperty))); } } } 3.2. 实现动态的配置选择

可以根据不同的启动条件动态地选择加载不同的配置文件或配置源。

public class DynamicConfigInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> { @Override public void initialize(ConfigurableApplicationContext applicationContext) { ConfigurableEnvironment environment = applicationContext.getEnvironment(); String activeProfile = System.getProperty("app.profile"); if ("prod".equals(activeProfile)) { environment.setActiveProfiles("prod"); } else { environment.setActiveProfiles("dev"); } } } 3.3. 集成第三方库的配置

在使用一些第三方库时，如果需要在应用上下文创建之前进行某些初始化，可以通过 ApplicationContextInitializer 来做到。例如，有些第三方框架需要特定的配置才能正确工作。

3.4. 执行初始化操作

在 Spring 容器创建之前，执行一些操作，例如预加载数据、验证环境、初始化第三方资源等。

3.5. 修改 Spring Boot 默认行为

可以通过 ApplicationContextInitializer 来修改 Spring Boot 默认的行为，比如修改 Spring Boot 对外部配置的处理方式，或者定制化 Spring Boot 的行为。

public class CustomSpringBootInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> { @Override public void initialize(ConfigurableApplicationContext applicationContext) { // 修改 Spring Boot 默认的配置文件加载机制 System.setProperty("spring.config.location", "classpath:/custom-config/"); } } 4. 如何使用 ApplicationContextInitializer： 4.1. 通过 spring.factories 自动加载

在 META-INF/spring.factories 文件中定义：

org.springframework.context.ApplicationContextInitializer=com.example.MyApplicationContextInitializer

当应用启动时，Spring Boot 会自动加载 spring.factories 中列出的所有 ApplicationContextInitializer。

4.2. 通过 SpringApplication 显式添加

在启动类中使用 SpringApplication.addInitializers() 显式添加：

SpringApplication app = new SpringApplication(MyApplication.class); app.addInitializers(new MyCustomInitializer()); app.run(args); 5. ApplicationContextInitializer 与其他钩子的关系： ApplicationContextInitializer：用于在 Spring 容器完全初始化之前做一些环境配置修改。它发生在 Spring Boot 启动时，但在实际的应用上下文创建之前。ApplicationListener：监听不同的事件（如 ContextRefreshedEvent、ContextClosedEvent 等）。它通常用于 Spring 容器初始化后进行一些响应。CommandLineRunner 和 ApplicationRunner：这两个接口提供了一个回调机制，在 Spring 容器加载完毕之后执行应用启动逻辑。

ApplicationContextInitializer 是在应用启动的非常早期就会执行的，它比 ApplicationListener、CommandLineRunner 等其他钩子要早，因此非常适合用来进行环境和配置的定制。

---

总结： ApplicationContextInitializer 允许在 Spring 容器初始化之前进行配置和修改。它主要用于 环境配置、属性修改、条件配置、集成第三方库 等场景。在 Spring Boot 启动过程中，它是比其他钩子（如 CommandLineRunner、ApplicationListener）更早执行的阶段，适用于需要在应用启动时调整配置和环境的情况。