在 Spring Boot 中以编程方式配置数据源(Configure DataSource Programmatically in Spring Boot)

Spring Boot 编程配置数据源

最新推荐文章于 2025-11-25 12:51:57 发布

原创最新推荐文章于 2025-11-25 12:51:57 发布 · 720 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #java

java 专栏收录该内容

116 篇文章

订阅专栏

在 Spring Boot 中，数据源配置是基础部分，尤其是在处理数据库时。Spring Boot 提供了多种配置数据源的方法，包括使用 Spring 应用程序的 application.properties 或 application.yml 文件。在某些情况下，您可能需要以编程方式配置数据源，例如当数据库连接详细信息是动态的或需要在运行时确定时。

关键术语

DataSource：它是 JDBC（Java 数据库连接）API 提供的用于与数据库建立连接的接口。它提供了获取和释放数据库连接的方法。
DataSourceBuilder：它是 Spring Boot 提供的一个实用程序类，可以帮助以编程方式构建 DataSource 对象。它可以设置驱动程序类名称、URL、用户名和密码等属性。
DriverClassName：此属性用于指定 DataSource 的 JDBC 驱动类名。需要根据所使用的数据库加载相应的 JDBC 驱动类。
URL：它可以定义为统一资源定位符。它是一个可以指定资源位置的字符串。在配置数据源的上下文中，URL 通常表示 JDBC 连接 URL，其中包含数据库服务器地址、端口和数据库名称等详细信息。
用户名和密码：这些是身份验证所需的凭据，可以与数据库服务器建立连接。用户名和密码用于访问连接 URL 中指定的数据库。

在 Spring Boot 中以编程方式理解数据源的配置

以编程方式配置数据源涉及在 Spring Boot 应用程序上下文中手动创建和配置数据源 bean，而不是依赖于外部配置文件。它可以提供更大的灵活性，并更好地控制数据源的配置。

例子

public DataSource getDataSource() {
DataSourceBuilder dataSourceBuilder = DataSourceBuilder.create();
dataSourceBuilder.driverClassName("org.postgresql.Driver");
dataSourceBuilder.url("jdbc:postgresql://localhost:5432/mydatabase");
dataSourceBuilder.username("username");
dataSourceBuilder.password("password");
return dataSourceBuilder.build();
}

在这个例子中，

我们创建可以用@Configuration注释的DataSourceConfig类。
在类内部，我们可以定义用@Bean注释的方法，该方法可以返回应用程序的DataSource对象。
我们可以使用DataSourceBuilder来创建DataSource对象并设置其属性，例如驱动程序类名称、用户名和密码。

在 Spring Boot 应用程序中手动实现 DataSource Bean 的项目

我们可以演示如何在 Spring 应用程序中以编程方式配置 DataSource。

步骤 1：使用 Spring STS IDE 创建 Spring 项目，并将下面提到的依赖项包含到项目中。

依赖项：

Spring Web
Lombok
Spring Data JPA
MySQL Driver

项目创建成功完成后，它将如下图所示：

步骤 2：创建名为 dataConfig 的新包，在同一个包中，创建名为 DataSourceConfig 的 java 类。

转到src > org.example.springdatasourceconfig > dataConfig > DataSourceConfig并输入以下代码。

DataSourceConfig.java

package org.example.springdatasourceconfig.dataConfig;

import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.sql.DataSource;

@Configuration
public class DataSourceConfig {

@Bean
public DataSource getDataSource() {
DataSourceBuilder dataSourceBuilder = DataSourceBuilder.create();
dataSourceBuilder.driverClassName("com.mysql.cj.jdbc.Driver");
dataSourceBuilder.url("jdbc:mysql://localhost:3306/example?useSSL=false&serverTimezone=UTC");
dataSourceBuilder.username("root");
dataSourceBuilder.password("");
return dataSourceBuilder.build();
}
}

步骤 3：创建名为控制器的新包，在同一个包中，创建名为HomeController的 Java 类。

转到src > org.example.springdatasourceconfig > controller > HomeController并输入以下代码：

HomeController.java

package org.example.springdatasourceconfig.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.sql.DataSource;

@RestController
public class HomeController {

private final DataSource dataSource;

@Autowired
public HomeController(DataSource dataSource) {
this.dataSource = dataSource;
}

@GetMapping("/")
public String home() {
return "Hello from Spring Boot! DataSource: " + dataSource.toString();
}
}

步骤4：打开主类并编写以下代码：

package org.example.springdatasourceconfig;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class SpringDatasourceConfigApplication {

public static void main(String[] args) {
SpringApplication.run(SpringDatasourceConfigApplication.class, args);
}
}

pom.xml：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.2.4</version>
<relativePath/> 
</parent>
<groupId>org.example</groupId>
<artifactId>spring-datasource-config</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>spring-datasource-config</name>
<description>spring-datasource-config</description>
<properties>
<java.version>17</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.28</version>
</dependency>

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</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>

<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>

</project>

步骤5：项目成功完成后，将应用程序作为Spring项目运行。参考下面的输出图像以便更好地理解。