前言
在现代的Java开发中,Spring Boot已经成为了一个备受欢迎的框架。它以其简化开发流程、提高效率和强大的功能而闻名,使得开发人员能够更加专注于业务逻辑的实现而不必过多地关注配置问题。
然而,你是否曾经好奇过Spring Boot是如何做到自动配置的?为什么我们只需要简单的几行代码,就能够快速搭建一个可用的应用程序?在本博客中,我们将深入探索Spring Boot自动配置的原理,揭开其神秘面纱。
首先,我们将介绍Spring Boot的核心思想和设计原则,以便更好地理解自动配置的背后逻辑。接着,我们将深入研究Spring Boot自动配置的机制,包括条件注解、自动配置类和加载顺序等方面。通过这些详细的解析,我们将揭示Spring Boot是如何根据应用程序的依赖和配置信息,自动完成各种功能的初始化和配置。
一、Spring Boot是如何做到自动配置的?
Spring Boot实现自动配置的核心思想是基于约定优于配置的原则。它通过一系列的机制和规则,根据应用程序的依赖和配置信息,自动完成各种功能的初始化和配置。
下面是Spring Boot实现自动配置的主要机制:
-
条件注解(Conditional Annotations):Spring Boot使用条件注解来根据特定条件来决定是否应用某个配置。条件注解是基于Spring框架的@Conditional注解扩展而来,它可以根据一些条件判断来决定是否加载某个配置类或Bean。
-
自动配置类(Auto-Configuration Classes):Spring Boot提供了大量的自动配置类,这些类都以
AutoConfiguration
作为后缀命名,例如DataSourceAutoConfiguration
。这些自动配置类通过条件注解和配置信息来判断是否需要进行自动配置。当满足条件时,自动配置类将会注册相应的Beans和配置。 -
配置文件(Properties and YAML):Spring Boot使用属性文件(
application.properties
或application.yml
)来存储应用程序的配置信息。这些配置文件中定义了各种属性和值,Spring Boot可以根据这些配置信息来决定是否进行自动配置,并设置相应的默认值。 -
启动器(Starters):Spring Boot提供了一系列的启动器,它们是一组预定义的依赖项集合,可以简化项目的构建和配置。启动器会自动引入所需的依赖,并根据这些依赖来触发相应的自动配置。
-
条件属性(Conditional Properties):Spring Boot使用条件属性来进一步控制自动配置。条件属性允许你根据特定的属性值或环境条件来决定是否应用某个配置。
通过以上机制,Spring Boot可以根据应用程序的依赖和配置信息,在运行时自动进行初始化和配置,以提供一套合理的默认行为。开发人员可以根据需要进行自定义配置和扩展,同时也可以通过禁用某些自动配置来精确地控制应用程序的行为。
总结起来,Spring Boot实现自动配置的关键在于条件注解、自动配置类、配置文件和启动器等机制的结合运用,使得开发人员能够更加专注于业务逻辑的实现而不必过多地关注繁琐的配置细节。
二、为什么能简单配置?
Spring Boot的设计目标之一就是简化开发流程和减少样板代码,使得开发人员能够快速搭建可用的应用程序。以下是几个原因解释为什么只需要简单的几行代码就能够实现这一点:
-
自动配置:Spring Boot利用自动配置机制,根据应用程序的依赖和配置信息,自动完成各种功能的初始化和配置。通过默认的自动配置,开发人员可以省去很多手动配置的步骤,只需要引入相关的依赖并添加必要的配置属性,就能够获得一个可用的应用程序。
-
启动器:Spring Boot提供了一系列的启动器(starters),它们是预定义的依赖项集合。启动器会自动引入所需的依赖,并触发相应的自动配置。开发人员只需要引入适当的启动器,就能够获取所需的功能和依赖,而不需要手动添加每个依赖的配置。
-
约定优于配置:Spring Boot遵循约定优于配置的原则,即通过约定来减少配置。它有一套默认的约定,例如在标准的项目结构中放置Java类、资源文件等,使用注解进行自动配置等。这些约定可以让开发人员专注于业务逻辑的实现,而不必过多地关注配置细节。
-
开箱即用:Spring Boot提供了很多开箱即用的特性和功能,例如内嵌的Servlet容器、自动扫描和注册等。这些特性默认就是启用的,开发人员只需要进行必要的配置即可使用它们,无需手动编写大量的代码。
-
统一的配置方式:Spring Boot采用了统一的配置方式,即通过属性文件(
application.properties
或application.yml
)来存储应用程序的配置信息。开发人员可以在配置文件中设置各种属性和值,Spring Boot会根据这些配置信息进行自动配置,并提供默认的属性值。这种统一的配置方式使得配置更加简洁明了。
总之,Spring Boot通过自动配置、启动器、约定优于配置和统一的配置方式等机制,使得开发人员只需要简单的几行代码就能够快速搭建一个可用的应用程序。这样的设计理念大大提高了开发效率,减少了繁琐的配置工作,让开发人员能够更专注于业务逻辑的实现。
三、前期准备
1、新建项目
本次案例需要新建两个项目,一个是使用c3p0实现自动装配,最后打包在其他项目引入使用我们自己写的自动装配。
2、导入依赖
1)c3p0-spring-boot-starter
<dependencies>
<!-- 添加Spring自动配置的依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-autoconfigure</artifactId>
<version>2.7.17</version>
</dependency>
<!-- 这个依赖将配置类的属性注入到元数据中,这样在 idea 中
就可以提供良好的代码提示功能-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-autoconfigure-processor</artifactId>
<version>2.7.17</version>
</dependency>
<!-- c3p0连接池 -->
<!-- https://mvnrepository.com/artifact/c3p0/c3p0 -->
<dependency>
<groupId>c3p0</groupId>
<artifactId>c3p0</artifactId>
<version>0.9.1.2</version>
</dependency>
</dependencies>
这是一个Java项目的Maven依赖配置文件,主要包含了Spring Boot自动配置、c3p0连接池等依赖项。Spring Boot自动配置可以让开发者更方便地构建Spring应用程序,而c3p0连接池则提供了数据库连接池的功能,方便应用程序与数据库进行数据交互。
2)ch08
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!-- c3p0的starter -->
<dependency>
<groupId>org.c3p0.spring.boot</groupId>
<artifactId>c3p0-spring-boot-starter</artifactId>
<version>1.0</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring-boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<source>11</source>
<target>11</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
<configuration>
<mainClass>edu.nf.ch08.Ch08Application</mainClass>
<skip>true</skip>
</configuration>
<executions>
<execution>
<id>repackage</id>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
这是一个Java项目的Maven依赖配置文件,主要包含了Spring Boot、c3p0连接池(自己写的)和MySQL驱动等依赖项。这些依赖将用于构建一个使用Spring Boot框架、c3p0连接池和MySQL数据库的Java应用程序。
在dependencies部分,首先引入了spring-boot-starter依赖,它是Spring Boot的核心依赖,包含了Spring框架的基本功能模块。接着引入了spring-boot-starter-test依赖,它是用于编写测试的依赖,并且被设置为test作用域,表示只在测试阶段起作用。
然后引入了c3p0-spring-boot-starter依赖,它是c3p0连接池的Spring Boot集成依赖,可以快速配置和使用c3p0连接池。
最后引入了mysql-connector-java依赖,它是MySQL数据库的Java驱动程序。
在dependencyManagement部分,引入了spring-boot-dependencies依赖,用于管理Spring Boot的版本号。
在build部分,定义了Maven插件的配置。maven-compiler-plugin插件用于指定编译器的版本和编码方式。spring-boot-maven-plugin插件用于打包和运行Spring Boot应用程序。
需要注意的是,该配置文件中的${spring-boot.version}是一个变量,实际值需要根据具体情况进行替换。
四、实现 c3p0-spring-boot-starter
1、实现配置类 C3p0DataSourceProperties
@ConfigurationProperties(prefix = "spring.datasource.c3p0")
public class C3p0DataSourceProperties {
private String driverClassName;
private String url;
private String username;
private String password;
private Integer minPoolSize;
private Integer maxPoolSize;
private Integer initialPoolSize;
private Integer maxIdleTime;
public String getDriverClassName() {
return driverClassName;
}
public void setDriverClassName(String driverClassName) {
this.driverClassName = driverClassName;
}
public String getUrl() {
return url;
}
public void setUrl(String url) {
this.url = url;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public Integer getMinPoolSize() {
return minPoolSize;
}
public void setMinPoolSize(Integer minPoolSize) {
this.minPoolSize = minPoolSize;
}
public Integer getMaxPoolSize() {
return maxPoolSize;
}
public void setMaxPoolSize(Integer maxPoolSize) {
this.maxPoolSize = maxPoolSize;
}
public Integer getInitialPoolSize() {
return initialPoolSize;
}
public void setInitialPoolSize(Integer initialPoolSize) {
this.initialPoolSize = initialPoolSize;
}
public Integer getMaxIdleTime() {
return maxIdleTime;
}
public void setMaxIdleTime(Integer maxIdleTime) {
this.maxIdleTime = maxIdleTime;
}
}
这段代码是一个配置类,用于配置C3P0数据源的属性。通过
@ConfigurationProperties(prefix = "spring.datasource.c3p0")
注解,将配置文件中以spring.datasource.c3p0
为前缀的属性与该类的属性进行绑定。具体来说,这个配置类有以下属性:
driverClassName
: 数据库驱动类名url
: 数据库连接URLusername
: 数据库用户名password
: 数据库密码minPoolSize
: 连接池中的最小连接数maxPoolSize
: 连接池中的最大连接数initialPoolSize
: 初始化连接池时的连接数maxIdleTime
: 连接在连接池中闲置的最长时间通过提供对应的getter和setter方法,可以获取和设置这些属性的值。
使用该配置类,可以方便地管理和配置C3P0数据源的相关属性。在Spring Boot应用程序中,可以在
application.properties
或application.yml
配置文件中设置这些属性,然后通过@EnableConfigurationProperties(C3p0DataSourceProperties.class)
注解将配置类生效,并自动将属性值注入到其他需要使用数据源的组件中。
2、实现 C3p0DataSourceAutoConfigure
@Configuration
@ConditionalOnClass(ComboPooledDataSource.class)
@AutoConfigureBefore(DataSourceAutoConfiguration.class)
@EnableConfigurationProperties(C3p0DataSourceProperties.class)
public class C3p0DataSourceAutoConfigure {
private C3p0DataSourceProperties c3p0DataSourceProperties;
@Autowired
public void setC3p0DataSourceProperties(C3p0DataSourceProperties c3p0DataSourceProperties) {
this.c3p0DataSourceProperties = c3p0DataSourceProperties;
}
@Bean
// 这个条件注解标识当容器中存在这个bean的时候才会执行装配
// @ConditionalOnBean
// 这个条件注解标识当容器中不存在这个bean的时候才会执行装配
@ConditionalOnMissingBean
public DataSource dataSource() throws PropertyVetoException {
// 创建 c3p0 的数据源
ComboPooledDataSource dataSource = new ComboPooledDataSource();
// 将配置属性设置到 dataSource 中
dataSource.setDriverClass(c3p0DataSourceProperties.getDriverClassName());
dataSource.setJdbcUrl(c3p0DataSourceProperties.getUrl());
dataSource.setUser(c3p0DataSourceProperties.getUsername());
dataSource.setPassword(c3p0DataSourceProperties.getPassword());
dataSource.setMinPoolSize(c3p0DataSourceProperties.getMinPoolSize());
dataSource.setMaxPoolSize(c3p0DataSourceProperties.getMaxPoolSize());
dataSource.setInitialPoolSize(c3p0DataSourceProperties.getInitialPoolSize());
dataSource.setMaxIdleTime(c3p0DataSourceProperties.getMaxIdleTime());
return dataSource;
}
}
这段代码是一个自动配置类,用于将C3P0数据源配置为Spring Boot应用程序的默认数据源。
首先,通过
@Configuration
注解将该类标识为一个配置类。然后,通过@ConditionalOnClass(ComboPooledDataSource.class)
注解,当ComboPooledDataSource
类存在于类路径中时,才会进行自动配置。接下来,通过
@AutoConfigureBefore(DataSourceAutoConfiguration.class)
注解,保证在DataSourceAutoConfiguration
类之前进行自动配置。这样可以确保C3P0数据源会覆盖默认的数据源配置。通过
@EnableConfigurationProperties(C3p0DataSourceProperties.class)
注解,启用对C3p0DataSourceProperties
类的配置属性的支持。这样,在该自动配置类中就可以自动注入C3p0DataSourceProperties
类的实例。在该自动配置类中定义了一个
dataSource()
方法,用于创建并配置C3P0数据源。通过@Bean
注解,将该方法的返回值作为一个Spring Bean注册到容器中。在
dataSource()
方法中,首先创建了一个ComboPooledDataSource
实例,然后将C3p0DataSourceProperties
类中的属性值设置到数据源中。最后,返回创建的数据源。总结起来,这个自动配置类的作用是将C3P0数据源配置为Spring Boot应用程序的默认数据源,并将
C3p0DataSourceProperties
类中的属性值应用到数据源中。这样,其他使用数据源的组件就可以直接注入DataSource
类型的Bean,并使用C3P0数据源进行数据库访问。
3、配置META-INF下的配置文件
org.springframework.boot.autoconfigure.EnableAutoConfiguration = \
org.c3p0.spring.boot.autoconfigure.C3p0DataSourceAutoConfigure
这是
META-INF
目录下的spring.factories
文件,用于配置Spring Boot自动配置的类。在该文件中,
org.springframework.boot.autoconfigure.EnableAutoConfiguration
是一个键,后面的\
表示换行,而org.c3p0.spring.boot.autoconfigure.C3p0DataSourceAutoConfigure
是对应的值,表示需要自动配置的类是C3p0DataSourceAutoConfigure
。通过这种方式,Spring Boot会在启动时自动加载并应用
C3p0DataSourceAutoConfigure
类中的配置。这样,C3P0数据源的自动配置就会生效,将C3P0作为默认的数据源配置到Spring Boot应用程序中。
4、打包
将此maven项目打包,方便在后面的项目依赖此项目。
五、实现 ch08
1、配置 yml
spring:
datasource:
c3p0:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/psm
username: root
password: 123456
min-pool-size: 5
initial-pool-size: 5
max-pool-size: 20
max-idle-time: 5000
这是一个Spring Boot中配置c3p0数据源的示例。通过配置文件来设置c3p0连接池的相关属性,包括驱动类名、数据库URL、用户名、密码以及连接池的最小大小、初始大小、最大大小和最大空闲时间等。
在上述配置中,
spring.datasource.c3p0.driver-class-name
指定了MySQL数据库的驱动类名。spring.datasource.c3p0.url
指定了数据库的URL。spring.datasource.c3p0.username
和spring.datasource.c3p0.password
分别指定了数据库的用户名和密码。
spring.datasource.c3p0.min-pool-size
、spring.datasource.c3p0.initial-pool-size
和spring.datasource.c3p0.max-pool-size
分别指定了连接池的最小大小、初始大小和最大大小。
spring.datasource.c3p0.max-idle-time
指定了连接池中连接的最大空闲时间,单位为毫秒。这些配置项可以根据实际情况进行调整,以满足应用程序的需求。在应用程序启动时,Spring Boot会根据这些配置信息创建并管理c3p0连接池,从而实现对数据库的连接和操作。
注意:这是我们刚刚自己配置的,我们引入了我们自己写的c3p0的项目。
2、测试
@Autowired
private DataSource dataSource;
@Test
void contextLoads() throws SQLException {
ComboPooledDataSource ds = (ComboPooledDataSource) dataSource;
System.out.println(ds.getConnection());
System.out.println(ds.getDriverClass());
System.out.println(ds.getJdbcUrl());
System.out.println(ds.getMinPoolSize());
System.out.println(ds.getMaxPoolSize());
System.out.println(ds.getInitialPoolSize());
}
这段代码是一个在Spring Boot中使用c3p0数据源的示例。
首先,通过
@Autowired
注解将DataSource
对象注入到当前类中,表示将由Spring容器自动创建和管理数据源。然后,在
contextLoads()
方法中,将注入的DataSource
对象强制转换为ComboPooledDataSource
类型,以便获取c3p0特定的属性。接下来,通过调用
getConnection()
方法可以获取一个数据库连接,并使用System.out.println()
打印出连接对象。这样可以验证数据源配置是否正确,以及检查连接是否成功。然后,通过调用
getDriverClass()
、getJdbcUrl()
、getMinPoolSize()
、getMaxPoolSize()
和getInitialPoolSize()
等方法,分别获取c3p0数据源的驱动类名、JDBC URL、最小连接池大小、最大连接池大小和初始连接池大小,并通过System.out.println()
打印出来。这些操作可以帮助你验证数据源配置是否生效,以及获取连接池的相关属性信息。
运行结果:
六、springboot自动装配的原理是什么?
Spring Boot的自动装配是基于Spring框架的依赖注入和控制反转(IoC)机制实现的。
自动装配的原理如下:
-
组件扫描:Spring Boot会在启动时自动扫描应用程序的包及其子包,查找带有特定注解的类(如
@Component
、@Service
、@Repository
等)。 -
隐式Bean定义:当Spring Boot找到带有特定注解的类时,它会隐式地将这些类解析为Bean定义,即创建相应的Bean实例所需的元数据。
-
自动配置:Spring Boot根据应用程序的依赖关系和配置信息,通过条件化配置来自动决定需要创建哪些Bean。自动配置是通过使用
@Conditional
注解进行条件判断来实现的,例如判断某个类是否在类路径上、是否存在某个Bean等。 -
Bean创建和注入:根据Bean定义和自动配置的结果,Spring Boot会创建相应的Bean实例,并将其注入到需要依赖的地方。这是通过依赖注入(DI)机制实现的,可以使用
@Autowired
、@Inject
或构造函数等方式进行注入。
总结起来,Spring Boot的自动装配通过组件扫描、隐式Bean定义、自动配置和依赖注入等机制,实现了对应用程序中各个组件的自动发现、创建和注入,减少了手动配置的工作量,提高了开发效率。同时,Spring Boot还提供了一些默认的自动配置,可以根据应用程序的需求进行定制和扩展。