20191127 Spring Boot官方文档学习（4.10）

4.10。使用SQL数据库

从使用JdbcTemplate直接的JDBC访问到完整的“对象关系映射”技术（例如Hibernate），Spring框架为使用SQL数据库提供了广泛的支持。 Spring Data提供了更高级别的功能：直接从接口创建Repository实现，并使用约定从您的方法名称生成查询。

4.10.1。配置数据源

Java的javax.sql.DataSource接口提供了使用数据库连接的标准方法。传统上，“数据源”使用URL以及一些凭据来建立数据库连接。

嵌入式数据库支持

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

Spring Boot可以自动配置嵌入式H2，HSQL和Derby数据库。您无需提供任何连接URL。您只需要包含要使用的嵌入式数据库的构建依赖项即可。

如果您在测试中使用此功能，则可能会注意到，整个测试套件将重复使用同一数据库，而不管您使用的应用程序上下文有多少。如果要确保每个上下文都有一个单独的嵌入式数据库，则应设置spring.datasource.generate-unique-name为true。

例如，典型的POM依赖关系如下：

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

您需要依赖spring-jdbc才能自动配置嵌入式数据库。在此示例中，它通过spring-boot-starter-data-jpa引入。

如果出于某种原因确实为嵌入式数据库配置了连接URL，请确保禁用了数据库的自动关闭功能。如果您使用H2，则应该DB_CLOSE_ON_EXIT=FALSE这样做。如果使用HSQLDB，则应确保未使用shutdown=true。通过禁用数据库的自动关闭功能，Spring Boot可以控制何时关闭数据库，从而确保一旦不再需要访问数据库时就可以执行该操作。

连接到数据库

数据库连接也可以通过使用pooling DataSource进行自动配置。Spring Boot使用以下算法来选择特定的实现：

我们更喜欢HikariCP的性能和并发性。如果有HikariCP，我们总是选择它。

否则，如果Tomcat pooling DataSource可用，我们将使用它。

如果HikariCP和Tomcat pooling 数据源均不可用，并且Commons DBCP2可用，我们将使用它。

如果使用spring-boot-starter-jdbc或spring-boot-starter-data-jpa“启动器”，则会自动获得对的依赖HikariCP。

您可以完全绕过该算法，并通过设置spring.datasource.type属性来指定要使用的连接池。如果您在tomcat-jdbc默认情况下提供的Tomcat容器中运行应用程序，则这一点尤其重要。

其他连接池始终可以手动配置。如果定义自己的DataSource bean，则不会进行自动配置。

DataSource配置由spring.datasource.*中的外部配置属性控制。例如，您可以在application.properties中声明以下部分：

spring.datasource.url=jdbc:mysql://localhost/test
spring.datasource.username=dbuser
spring.datasource.password=dbpass
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

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

您通常不需要指定driver-class-name，因为Spring Boot可以从url推导大多数数据库。

对于要创建的pooling DataSource，我们需要验证有效的Driver类是否可用，因此我们在进行任何操作之前都要进行检查。换句话说，如果您设置spring.datasource.driver-class-name=com.mysql.jdbc.Driver，则该类必须是可加载的。

请参阅DataSourceProperties以获取更多受支持的选项。这些是不管实际实现如何都起作用的标准选项。它也有可能微调特定实现的设置，使用各自的前缀（spring.datasource.hikari.*，spring.datasource.tomcat.*，和spring.datasource.dbcp2.*）。有关更多详细信息，请参阅所用连接池实现的文档。

例如，如果使用Tomcat连接池，则可以自定义许多其他设置，如以下示例所示：

# Number of ms to wait before throwing an exception if no connection is available.
spring.datasource.tomcat.max-wait=10000
# Maximum number of active connections that can be allocated from this pool at the same time.
spring.datasource.tomcat.max-active=50
# Validate the connection before borrowing it from the pool.
spring.datasource.tomcat.test-on-borrow=true

参考源码：

org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

连接到JNDI数据源

如果您将Spring Boot应用程序部署到Application Server，则可能要使用Application Server的内置功能来配置和管理DataSource，并使用JNDI对其进行访问。

spring.datasource.jndi-name属性可以被用来替代spring.datasource.url，spring.datasource.username和spring.datasource.password属性来从一个特定的JNDI位置访问DataSource。例如，application.properties以下部分显示了如何访问JBoss AS定义的 DataSource：

spring.datasource.jndi-name=java:jboss/datasources/customers

4.10.2。使用JdbcTemplate

Spring的JdbcTemplate和NamedParameterJdbcTemplate类是自动配置的，您可以通过@Autowire将它们直接放入自己的bean中，如以下示例所示：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Component;
@Component
public class MyBean {
    private final JdbcTemplate jdbcTemplate;
    @Autowired
    public MyBean(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }
    // ...
}

您可以使用spring.jdbc.template.*属性来自定义模板的某些属性，如以下示例所示：

spring.jdbc.template.max-rows=500

NamedParameterJdbcTemplate重复使用相同的JdbcTemplate。如果JdbcTemplate定义了多个，并且不存在主要候选对象，NamedParameterJdbcTemplate则不会自动配置。

参考源码：

org.springframework.boot.autoconfigure.jdbc.JdbcTemplateAutoConfiguration

4.10.3。JPA和Spring Data JPA

Java Persistence API是一种标准技术，可让您将对象“映射”到关系数据库。spring-boot-starter-data-jpa POM提供了上手的快捷方式。它提供以下关键依赖性：

Hibernate：最流行的JPA实现之一。
Spring Data JPA：使基于JPA的repositories的实现变得容易。
Spring ORM：Spring Framework提供的核心ORM支持。

实体类

传统上，JPA“实体”类在persistence.xml文件中指定。在Spring Boot中，此文件不是必需的，而是使用“实体扫描”。默认情况下，将搜索主配置类（用@EnableAutoConfiguration或@SpringBootApplication注解的主程序类）下的所有软件包。

任何类标注了@Entity，@Embeddable或者@MappedSuperclass被认为是。典型的实体类类似于以下示例：

package com.example.myapp.domain;
import java.io.Serializable;
import javax.persistence.*;
@Entity
public class City implements Serializable {
    @Id
    @GeneratedValue
    private Long id;
    @Column(nullable = false)
    private String name;
    @Column(nullable = false)
    private String state;
    // ... additional members, often include @OneToMany mappings
    protected City() {
        // no-args constructor required by JPA spec
        // this one is protected since it shouldn't be used directly
    }
    public City(String name, String state) {
        this.name = name;
        this.state = state;
    }
    public String getName() {
        return this.name;
    }
    public String getState() {
        return this.state;
    }
    // ... etc
}

Spring Data JPA Repositories

Spring Data JPA Repositories是可以定义以访问数据的接口。JPA查询是根据您的方法名称自动创建的。例如，CityRepository接口可能声明了一个给定州查找所有城市的方法findAllByState(String state)。

对于更复杂的查询，可以对方法使用Spring Data的Query注解。

Spring Data Repositories通常从Repository或CrudRepository接口扩展。如果使用自动配置，则从包含主配置类（用@EnableAutoConfiguration或@SpringBootApplication注解的主配置类）的包中搜索Repositories。

以下示例显示了典型的Spring Data Repository接口定义：

package com.example.myapp.domain;
import org.springframework.data.domain.*;
import org.springframework.data.repository.*;
public interface CityRepository extends Repository<City, Long> {
    Page<City> findAll(Pageable pageable);
   City findByNameAndStateAllIgnoringCase(String name, String state);
}

Spring Data JPA存储库支持三种不同的引导模式：default，deferred和lazy。要启用deferred或lazy引导，请将spring.data.jpa.repositories.bootstrap-mode属性分别设置为deferred或lazy。当使用deferred或lazy引导时，自动配置的EntityManagerFactoryBuilder将使用上下文的AsyncTaskExecutor（如果有）作为引导执行器。如果存在多个，将使用命名为applicationTaskExecutor的。

更多信息参考Spring Data JPA文档。

创建和删除JPA数据库

默认情况下，仅当您使用嵌入式数据库（H2，HSQL或Derby）时，才会自动创建JPA数据库。您可以使用spring.jpa.*属性来显式配置JPA设置。例如，要创建和删除表，可以将以下行添加到application.properties中：

spring.jpa.hibernate.ddl-auto=create-drop

Hibernate自己的内部属性名称是（如果您记得更好的话）是hibernate.hbm2ddl.auto。您可以通过使用spring.jpa.properties.*（与其他Hibernate原生属性一起）设置它（将前缀添加到实体管理器之前先删除前缀）。下面的行显示了为Hibernate设置JPA属性的示例：

spring.jpa.properties.hibernate.globally_quoted_identifiers = true

在前面的示例中为Hibernate实体管理器将hibernate.globally_quoted_identifiers属性赋值true。

默认情况下，DDL执行（或验证）推迟到ApplicationContext开始执行之前。还有一个spring.jpa.generate-ddl标志，但是如果Hibernate自动配置处于活动状态，则不使用该标志，因为ddl-auto设置更细粒度。

在视图中打开EntityManager

如果您正在运行Web应用程序，则默认情况下，Spring Boot注册OpenEntityManagerInViewInterceptor以应用“在视图中打开EntityManager”模式，以允许在Web视图中进行延迟加载。如果你不希望这种行为，你应该在application.properties设置spring.jpa.open-in-view为false。

4.10.4。Spring Data JDBC

Spring Data包括对JDBC的repository支持，并将自动为CrudRepository上的方法生成SQL。对于更高级的查询，提供了@Query注解。

当必要的依赖项位于类路径上时，Spring Boot将自动配置Spring Data的JDBC repositories。可以将它们添加到您的项目中，而只需依赖于spring-boot-starter-data-jdbc。如有必要，您可以通过向应用程序中添加@EnableJdbcRepositories注解或JdbcConfiguration子类来控制Spring Data JDBC的配置。

有关Spring Data JDBC的完整详细信息，请参考参考文档。

4.10.5。使用H2的Web控制台

H2数据库提供了一个基于浏览器的控制台是Spring Boot自动为您配置。满足以下条件时，将自动配置控制台：

您正在开发基于servlet的Web应用程序。
com.h2database:h2 在类路径上。
您正在使用Spring Boot的开发人员工具。

如果您不使用Spring Boot的开发人员工具，但仍想使用H2的控制台，则可以将spring.h2.console.enabled属性配置为true。

H2控制台仅在开发期间使用，因此您应注意确保spring.h2.console.enabled=true不在生产环境中使用。

更改H2控制台的路径

默认情况下，控制台位于/h2-console。您可以使用spring.h2.console.path属性来自定义控制台的路径。

4.10.6。使用jOOQ

jOOQ面向对象查询（jOOQ）是Data Geekery的流行产品，它可以从数据库中生成Java代码，并允许您通过其流式API构建类型安全的SQL查询。商业版和开源版都可以与Spring Boot一起使用。

代码生成

为了使用jOOQ的类型安全查询，您需要从数据库架构中生成Java类。您可以按照jOOQ用户手册中的说明进行操作。如果您使用jooq-codegen-maven插件并且还使用spring-boot-starter-parent“父POM”，则可以安全地省略插件的<version>标签。您还可以使用Spring Boot定义的版本变量（例如h2.version）来声明插件的数据库依赖关系。以下清单显示了一个示例：

<plugin>
    <groupId>org.jooq</groupId>
    <artifactId>jooq-codegen-maven</artifactId>
    <executions>
        ...
    </executions>
    <dependencies>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <version>${h2.version}</version>
        </dependency>
    </dependencies>
    <configuration>
        <jdbc>
            <driver>org.h2.Driver</driver>
            <url>jdbc:h2:~/yourdatabase</url>
        </jdbc>
        <generator>
            ...
        </generator>
    </configuration>
</plugin>

使用DSLContext

jOOQ提供的流式API通过org.jooq.DSLContext接口开始。Spring Boot将自动配置DSLContext为Spring Bean并将其连接到您的应用程序DataSource。要使用DSLContext，可以使用@Autowire，如以下示例所示：

@Component
public class JooqExample implements CommandLineRunner {
    private final DSLContext create;
    @Autowired
    public JooqExample(DSLContext dslContext) {
        this.create = dslContext;
    }
}

jOOQ手册倾向于使用名为create的变量来保存DSLContext。

然后，您可以使用DSLContext构造查询，如以下示例所示：

public List<GregorianCalendar> authorsBornAfter1980() {
    return this.create.selectFrom(AUTHOR)
        .where(AUTHOR.DATE_OF_BIRTH.greaterThan(new GregorianCalendar(1980, 0, 1)))
        .fetch(AUTHOR.DATE_OF_BIRTH);
}

jOOQ SQL方言

除非配置了spring.jooq.sql-dialect属性，否则Spring Boot会确定要用于数据源的SQL方言。如果Spring Boot无法检测到方言，则使用DEFAULT。

Spring Boot只能自动配置开源版本的jOOQ支持的方言。

定制jOOQ

通过定义自己的@Bean定义（可以在jOOQ Configuration创建时使用）可以实现更高级的自定义。您可以为以下jOOQ类型定义bean：

ConnectionProvider
ExecutorProvider
TransactionProvider
RecordMapperProvider
RecordUnmapperProvider
RecordListenerProvider
ExecuteListenerProvider
VisitListenerProvider
TransactionListenerProvider

如果要完全控制jOOQ配置，也可以创建自己的org.jooq.Configuration @Bean。