SpringBoot——自定义自动配置与起步依赖

SpringBoot为我们提供了灵活强大的自动配置与起步依赖功能，接下来我们参考其实现原理，实现专属于我们自己的自动配置与起步依赖。
不仅如此，我们对其稍作修改，让它适用于非SpringBoot环境，甚至是低版本的Spring Framework环境

1自动配置

在编写自己的自动配置之前，我们先来看一下SpringBoot自动配置类的实现原理。

SpringBoot可以根据CLASSPATH、配置项等条件自动进行常规配置，省去了我们自己手动把一模一样的配置复制来复制去的麻烦。这样大大提升了开发效率！
在这之前，我们已经看到过@SpringBootApplication注解了，查看这个注解，可以发现它上面添加了一个@EnableAutoConfiguration，基于这个注解就可以开启自动配置功能。
这两个注解上都有exclude属性，我们可以在其中排除一些不想启用的自动配置类。
如果不想启用自动配置功能，也可以在配置文件中配置spring.boot.enableautoconfiguration=false，关闭该功能。

1.1自动配置的实现原理

自动配置类其实就是添加了@Configuration的普通Java配置类，它利用Spring Framework 4.0加入的条件注解@Conditional来实现“根据特定条件启用相关配置类”，注解中传入的Condition类就是不同条件的判断逻辑。SpringBoot内置了很多条件注解，如下表所示：

?更多如图所示，就不一一列举了：

以@ConditionalOnClass注解为例，它的定义如下所示，@Target指明该注解可用于类型和方法定义，@Retention指明注解的信息在运行时也能获取到，而其中最关键的就是OnClassCondition条件类，里面是具体的条件计算逻辑：

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnClassCondition.class)
public @interface ConditionalOnClass {

	/**
	 * The classes that must be present. Since this annotation is parsed by loading class
	 * bytecode, it is safe to specify classes here that may ultimately not be on the
	 * classpath, only if this annotation is directly on the affected component and
	 * <b>not</b> if this annotation is used as a composed, meta-annotation. In order to
	 * use this annotation as a meta-annotation, only use the {@link #name} attribute.
	 * @return the classes that must be present
	 */
	Class<?>[] value() default {};

	/**
	 * The classes names that must be present.
	 * @return the class names that must be present.
	 */
	String[] name() default {};

}

了解了条件注解后，再来看看它们是如何与配置类结合使用的。以JdbcTemplateAutoConfiguration为例：

@AutoConfiguration(after = DataSourceAutoConfiguration.class)
@ConditionalOnClass({ DataSource.class, JdbcTemplate.class })
@ConditionalOnSingleCandidate(DataSource.class)
@EnableConfigurationProperties(JdbcProperties.class)
@Import({ DatabaseInitializationDependencyConfigurer.class, JdbcTemplateConfiguration.class,
		NamedParameterJdbcTemplateConfiguration.class })
public class JdbcTemplateAutoConfiguration {
}

可以看到这个配置类的生效条件是存在DataSource和JdbcTemplate类，且在上下文中只能有一个DataSource。此外，这个自动配置需要在DataSourceAutoConfiguration之后再配置（可以用@AutoConfigureBefore、@AutoConfigureAfter和@AutoConfigureOrder来控制自动配置的顺序）

2编写自已的自动配置

根据上面的描述，我们很容易想到，要编写自己的自动配置，只需要以下三个步骤：
（1）编写常规的配置类
（2）为配置类增加生效条件与顺序
（3）在/META-INF/spring.factories文件中添加自动配置类

2.1创建项目

在Spring Initializr中，创建一个Maven工程，添加如下依赖：

    <dependencies>
        <!--    添加自动配置所使用的包    -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
        </dependency>
        <!--    用户在写配置文件时，会有提示效果    -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

2.2编写一个简单的MyAutoConfigure类和配置类Bean

编写一个简单的MyAutoConfigure类，上面增加了@Configuration注解，表示这是一个配置类，这个配置类的生效条件是myconfig.ready属性的值为true，除此之外的值或者不存在该属性时MyAutoConfigure都不会生效。

/**
 * TODO 1、编写配置类并指定文件
 *
 * @author ss_419
 * @version 1.0
 * @date 2023/3/17 21:24
 */
@Configuration

@EnableConfigurationProperties(CommonBean.class)
@ConditionalOnProperty(name = "myconfig.ready",havingValue = "true")
public class MyAutoConfigure {
}

/**
 * TODO 2、创建配置类Bean
 *
 * @author ss_419
 * @version 1.0
 * @date 2023/3/17 22:40
 */
@ConfigurationProperties("myconfigbean")
@Data
public class MyConfigBean {
    private boolean ready;
    private String info;
}

2.3配置spring.factories文件

为了让SpringBoot能找到我们写的这个配置类，我们需要在src/resources目录中创建META-INF/spring.factories文件，其内容如下：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=org.pp.myspringbootstart.beans.MyAutoConfigure

2.4测试自动配置是否生效

@SpringBootTest
public class MyConfigurationEnableTest {

    @Autowired
    private ApplicationContext applicationContext;

    @Test
    void testPropertiesBeanAvailableTest() throws Exception {
        assertNotNull(applicationContext.getBean(MyConfigBean.class));
        assertTrue(applicationContext.containsBean("org.pp.myspringbootstart.beans.MyConfigBean"));
    }

    @Test
    void testPropertyValues(){
        MyConfigBean bean = applicationContext.getBean(MyConfigBean.class);
        assertTrue(bean.isReady());
        assertEquals("hello", bean.getInfo());
    }
}

本栏目推荐文章
• 蚂蚁爱购--靠谱的SpringBoot项目
• 实时数据流无忧：用 SpringBoot 和 SSE 打造动态前端更新的终极指南
• springBoot(基础部分)
• SpringBoot配置报错：Description: Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured. Reason: Failed to determine a suitable driver class
• 40 个 SpringBoot 常用注解：让生产力爆表！
• Springboot 全局日期时间格式处理
• SpringBoot中使用SpringEvent业务解耦神器实现监听发布事件同步异步执行任务
• SpringBoot3.x升级整合各依赖
• Springboot 项目集成 PageOffice V6 最简单代码
• SpringBoot中使用SpringRetry实现重试机制(重试调用第三方API)

SpringBootspringboot3 springboot2 springboot笔记 springboot starter springboot问题 springboot原理 springboot方案 springboot项目 springboot文件 springboot websocket