Spring Boot 3.x Data(一)-SQL数据源配置

系列文章目录


前言

Spring Boot集成了许多数据技术,包括SQLNoSQL

一、SQL数据库

Spring框架为使用SQL数据库提供了广泛的支持,从使用JdbcTemplate的直接JDBC访问到完成“对象关系映射”技术(如Hibernate)。
Spring Data提供了一个额外的功能:直接从接口创建Repository,并使用约定从方法名生成查询。

配置数据源

Java中javax.sql.DataSource接口提供了处理数据库连接的标准方法。“DataSource”使用URL和一些凭证来建立数据库连接。

嵌入式数据库支持

使用内存内嵌入式数据库开发应用程序通常很方便。显然,内存中的数据库不提供持久存储。您需要在应用程序启动时填充数据库,并准备在应用程序结束时丢弃数据。

Spring Boot可以自动配置嵌入式的H2、HSQL和Derby数据库。你不需要提供任何连接url。你只需要包含要使用的嵌入式数据库的构建依赖项。如果类路径上有多个嵌入式数据库,则设置spring.datasource.embedded-database-connection 配置属性,用于控制使用哪一个。将该属性设置为none将禁用嵌入式数据库的自动配置。

如果你在测试中使用此特性,你可能会注意到,无论你使用多少应用程序上下文,整个测试套件都会重用相同的数据库。
如果你想确保每个上下文都有一个单独的嵌入式数据库,你应该设置spring.datasource.generate-unique-nametrue

要自动配置嵌入式数据库,需要依赖spring-jdbc。例如,典型的POM依赖如下:

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.hsqldb</groupId>
            <artifactId>hsqldb</artifactId>
            <scope>runtime</scope>
        </dependency>

如果出于某种原因,为嵌入式数据库配置了连接URL,请注意确保禁用了数据库的自动关闭功能。 如果你使用H2,你应该使用DB_CLOSE_ON_EXIT=FALSE来完成,如果使用HSQLDB,应该确保没有使用shutdown=true。禁用数据库的自动关闭功能可以让Spring Boot在数据库关闭时控制,从而确保一旦不再需要对数据库的访问就会发生这种情况。

hsqldb url 配置示例:

spring:
  datasource:
    username: hsqldb
    password: hsqldb
    url: jdbc:hsqldb:mem://localhost/test;shutdown=true
    driver-class-name: org.hsqldb.jdbcDriver
    schema: classpath:schema.sql
    data: classpath:data.sql
    initialization-mode: always
    continue-on-error: true

DataSource配置

数据源配置由spring.datasource.*中的外部配置属性控制。例如,你可以在application.properties中声明以下部分:

spring:
  datasource:
    url: "jdbc:mysql://localhost/test"
    username: "dbuser"
    password: "dbpass"

你至少应该通过设置spring.datasource.url属性来指定URL。否则,Spring Boot会尝试自动配置嵌入式数据库。

Spring Boot可以从URL推导出大多数数据库的JDBC驱动程序类, 如果需要指定特定的类,可以使用spring.datasource.driver-class-name属性。

要创建一个DataSource池,我们需要能够验证一个有效的Driver类是否可用,因此我们在做任何事情之前要检查这个类。换句话说,如果你设置了spring.datasource.driver-class-name=com.mysql.jdbc.Driver,那么这个类必须是可加载的。

有关更多支持的选项,请参阅DataSourceProperties。对于特定的数据连接池,可以使用spring.datasource.hikari.*, spring.datasource.tomcat.*, spring.datasource.dbcp2.*, 和 spring.datasource.oracleucp.* 配置进行微调。
例如,如果你使用Tomcat连接池,你可以自定义许多附加设置,如下面的示例所示:

spring:
  datasource:
    tomcat:
      max-wait: 10000
      max-active: 50
      test-on-borrow: true

支持的连接池

Spring Boot使用以下算法来选择特定的实现:

  1. 我们更喜欢HikariCP的性能和并发性。如果HikariCP可用,我们总是选择它。
  2. 否则,如果Tomcat池数据源可用,我们就使用它。
  3. 否则,如果Commons DBCP2可用,我们就使用它。
  4. 如果没有HikariCP、Tomcat和DBCP2可用,如果Oracle UCP可用,我们使用它。

如果你使用spring-boot-starter-jdbcspring-boot-starter-data-jpa Starter,你将自动获得对HikariCP的依赖。

你可以完全绕过该算法,并通过设置spring.datasource.type属性指定要使用的连接池。如果在Tomcat容器中运行应用程序,这一点尤其重要,因为默认情况下提供了tomcat-jdbc
在这里插入图片描述
可以使用DataSourceBuilder手动配置其他连接池。如果你定义了自己的DataSource bean,则不会发生自动配置。DataSourceBuilder支持以下连接池:

  • HikariCP
  • Tomcat pooling Datasource
  • Commons DBCP2
  • Oracle UCP & OracleDataSource
  • Spring Framework’s SimpleDriverDataSource
  • H2 JdbcDataSource
  • PostgreSQL PGSimpleDataSource

连接到JNDI数据源

如果你将Spring Boot应用程序部署到应用程序服务器,你可能希望通过使用应用程序服务器的内置特性配置和管理数据源,并通过使用JNDI访问它。
spring.datasource.jndi-name属性可以用作spring.datasource.url的替代,spring.datasource.usernamespring.datasource.password 属性 从特定的JNDI位置访问数据源。
下面的例子展示如何访问JBoss定义的数据源:

spring:
  datasource:
    jndi-name: "java:jboss/datasources/customers"

自定义数据源配置

要配置你自己的数据源,请在你的配置中定义该类型的@Bean。 Spring Boot在任何需要的地方重用“DataSource”,包括数据库初始化。

下面的例子展示了如何在bean中定义数据源:

@Configuration(proxyBeanMethods = false)
public class MyDataSourceConfiguration {

    @Bean
    @ConfigurationProperties(prefix = "app.datasource")
    public SomeDataSource dataSource() {
        return new SomeDataSource();
    }

}

下面的例子展示了如何通过设置属性来定义数据源:

app:
  datasource:
    url: "jdbc:h2:mem:mydb"
    username: "sa"
    pool-size: 30

假设SomeDataSource具有URL、用户名和连接池大小的常规JavaBean属性,那么在DataSource对其他组件可用之前,这些设置将被自动绑定。Spring Boot还提供了一个实用工具构建类,称为DataSourceBuilder,可用于创建一个标准数据源(如果它在类路径上)。构建器可以根据类路径上可用的内容检测要使用的对象。它还基于JDBC URL自动检测驱动程序。下面的例子展示了如何使用DataSourceBuilder创建一个数据源:

@Configuration(proxyBeanMethods = false)
public class MyDataSourceConfiguration {

    @Bean
    @ConfigurationProperties("app.datasource")
    public DataSource dataSource() {
        return DataSourceBuilder.create().build();
    }

下面的例子展示了如何通过设置属性来定义JDBC数据源:

app:
  datasource:
    url: "jdbc:mysql://localhost/test"
    username: "dbuser"
    password: "dbpass"
    pool-size: 30

然而,这里有一个陷阱。由于没有公开数据库连接池的实际类型,因此在自定义DataSource的元数据中没有生成键,IDE中也没有可用的键选择,因为DataSource接口没有公开属性。
另外,如果类路径上碰巧有Hikari,这个基本设置就不起作用了,因为Hikari没有url属性(但有一个jdbcUrl属性)。在这种情况下,你必须重写你的配置如下:

app:
  datasource:
    jdbc-url: "jdbc:mysql://localhost/test"
    username: "dbuser"
    password: "dbpass"
    pool-size: 30

下面的例子展示了如何使用DataSourceBuilder创建HikariDataSource:

@Configuration(proxyBeanMethods = false)
public class MyDataSourceConfiguration {

    @Bean
    @ConfigurationProperties("app.datasource")
    public HikariDataSource dataSource() {
        return DataSourceBuilder.create().type(HikariDataSource.class).build();
    }

}

你甚至可以进一步利用DataSourceProperties为你做的事情—也就是说,如果没有提供URL,则通过提供用户名和密码的默认嵌入式数据库。 你可以很容易地从任何DataSourceProperties对象的状态初始化一个DataSourceBuilder,所以你也可以注入Spring Boot自动创建的DataSource。 然而,这将把你的配置分成两个名称空间:spring.datasource上的url,username, password, type, 和 driver其余的在你自定义的命名空间上(app.datasource)。 为了避免这种情况,你可以在你的自定义名称空间上重新定义一个自定义DataSourceProperties,如下面的示例所示:

@Configuration(proxyBeanMethods = false)
public class MyDataSourceConfiguration {

    @Bean
    @Primary
    @ConfigurationProperties("app.datasource")
    public DataSourceProperties dataSourceProperties() {
        return new DataSourceProperties();
    }

    @Bean
    @ConfigurationProperties("app.datasource.configuration")
    public HikariDataSource dataSource(DataSourceProperties properties) {
        return properties.initializeDataSourceBuilder().type(HikariDataSource.class).build();
    }

}

这个设置与Spring Boot默认为你做的配置同步。

app:
  datasource:
    url: "jdbc:mysql://localhost/test"
    username: "dbuser"
    password: "dbpass"
    configuration:
      maximum-pool-size: 30

总结

数据源自动配置是Spring Boot自带的DataSourceAutoConfiguration

  • 2
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
在使用 Spring Boot Data JPA 模块时,我们可以通过配置实体类和数据源来自动生成表。具体步骤如下: 1. 添加 Spring Boot Data JPA 依赖: ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> ``` 2. 配置数据源和 JPA 属性,例如在 application.yml 文件中: ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/test?useSSL=false&useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai username: root password: root driver-class-name: com.mysql.cj.jdbc.Driver jpa: hibernate: ddl-auto: update show-sql: true ``` 其中,`ddl-auto` 属性用于定义 Hibernate 在启动时对数据库的操作,它有以下几个可选值: - `create`:每次启动时都重新创建表,这将删除所有的数据表并重新创建它们。这是一个非常危险的操作,因为它会永久删除所有的数据。 - `create-drop`:每次启动应用程序时都会创建并删除表。这是一个非常危险的操作,因为它会永久删除所有的数据。 - `update`:Hibernate 将会根据实体类的定义自动更新表。如果表不存在,则 Hibernate 会创建该表。如果表已经存在,则 Hibernate 会根据实体类的定义更新表结构,但是不会删除任何数据。 - `validate`:Hibernate 比较实体类和数据库表结构,如果不匹配,则会抛出异常,应用程序将不会启动。 - `none`:Hibernate 不会对数据库进行任何操作。 3. 定义实体类,例如: ```java @Entity @Table(name = "user") public class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; @Column(nullable = false) private String name; @Column(nullable = false) private Integer age; // 省略 getter 和 setter 方法 } ``` 其中,`@Entity` 注解用于将 User 类标记为 JPA 实体,`@Table` 注解用于指定数据库表的名称。`@Id` 和 `@GeneratedValue` 注解用于定义主键和自动生成主键的策略。 4. 运行应用程序,Hibernate 将会自动根据实体类定义生成对应的数据表。如果 `ddl-auto` 属性值为 `update`,则 Hibernate 会根据实体类定义更新表结构。如果表不存在,则 Hibernate 会创建该表。如果表已经存在,则 Hibernate 会根据实体类的定义更新表结构,但不会删除任何数据。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

laopeng301

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值