1. 概述
Spring Boot使得使用不同的数据库系统变得非常容易，没有手动依赖管理的麻烦。
更具体地说，Spring Data JPA启动器提供了与多个DataSource实现无缝集成所需的所有功能。
在本教程中，我们将学习如何将Spring Boot与HSQLDB集成。
2. Maven依赖
为了演示将Spring Boot与HSQLDB集成有多么容易，我们将创建一个简单的JPA Repository层，该层使用内存中的HSQLDB数据库对客户实体执行CRUD操作。
这是我们将用于启动和运行示例Repository层的Spring Boot启动器：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
<version>2.2.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.hsqldb</groupId>
<artifactId>hsqldb</artifactId>
<version>2.4.0</version>
<scope>runtime</scope>
</dependency>
请注意，我们还包含了HSQLDB依赖项。如果没有它，Spring Boot会尝试通过HikariCP自动为我们配置一个DataSource bean和一个JDBC连接池。
因此，如果我们没有在pom.xml文件中指定有效的DataSource依赖项，我们的构建将失败。
此外，让我们确保在Maven Central上检查最新版本的spring-boot-starter-data-jpa。
3. 连接到HSQLDB数据库
为了练习我们的演示Repository层，我们将使用内存数据库。但是也可以使用基于文件的数据库。我们将在以下各节探讨这些方法中的每一种。。
3.1 运行外部HSQLDB服务器
让我们来看看如何运行外部HSQLDB服务器并创建基于文件的数据库。总的来说，安装HSQLDB和运行服务器非常简单。
以下是我们应该遵循的步骤：
- 首先，我们将下载HSQLDB并将其解压缩到一个文件夹中
- 由于HSQLDB没有提供开箱即用的默认数据库，因此我们将创建一个名为“testdb”的数据库作为演示使用
- 启动命令提示符并进入到HSQLDB的data文件夹
-
在data文件夹中，我们将运行以下命令：
java -cp ../lib/hsqldb.jar org.hsqldb.server.Server --database.0 file.testdb --dbname0.testdb - 上面的命令将启动HSQLDB服务器并创建我们的数据库，其源文件将存储在data文件夹中
- 我们可以通过转到data文件夹来确保数据库确实已创建，该文件夹应包含一组名为“testdb.lck”、“testdb.log”、“testdb.properties”和“testdb.script”的文件(文件的数量取决于我们正在创建的数据库类型)
数据库设置完成后，我们需要创建一个到它的连接。
要在Windows上执行此操作，让我们转到数据库bin文件夹并运行runManagerSwing.bat文件。这将打开HSQLDB数据库管理器的初始屏幕，我们可以在其中输入连接凭据：
- Type：HSQL数据库引擎
- URL：jdbc:hsqldb:hsql://localhost/testdb
- User：“SA”(系统管理员)
- Password：保留为空
在Linux/Unix/Mac上，我们可以使用NetBeans、Eclipse或IntelliJ IDEA通过IDE的可视化工具使用相同的凭据创建数据库连接。
在上述任何工具中，都可以通过在数据库管理器或IDE中执行SQL脚本来直接创建数据库表。
连接到数据库后，我们可以创建一个customers表：
CREATE TABLE customers
(
id INT NOT NULL,
name VARCHAR(45),
email VARCHAR(45),
PRIMARY KEY (ID)
);
通过几个简单的步骤，我们创建了一个包含customers表的基于文件的HSQLDB数据库。
3.2 application.properties文件
如果我们希望从Spring Boot连接到上面配置的基于文件的数据库，以下是我们应该包含在application.properties文件中的设置：
spring.datasource.driver-class-name=org.hsqldb.jdbc.JDBCDriver
spring.datasource.url=jdbc:hsqldb:hsql://localhost/testdb
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.hibernate.ddl-auto=update
或者，如果我们使用内存数据库，则配置如下：
spring.datasource.driver-class-name=org.hsqldb.jdbc.JDBCDriver
spring.datasource.url=jdbc:hsqldb:mem:testdb;DB_CLOSE_DELAY=-1
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.hibernate.ddl-auto=create
请注意附加到数据库URL末尾的DB_CLOSE_DELAY=-1参数。当使用内存数据库时，我们需要指定它，这样JPA实现(即Hibernate)在应用程序运行时不会关闭数据库。
4. 客户实体
设置数据库连接配置后，接下来我们需要定义Customer实体：
@Entity
@Table(name = "customers")
public class Customer {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private long id;
private String name;
private String email;
// standard constructors / setters / getters / toString
}
5. Repository
此外，我们需要实现一个轻量的持久层，它允许我们在Customer JPA实体上拥有基本的CRUD功能。
我们可以通过扩展CrudRepository接口轻松实现这一层：
@Repository
public interface CustomerRepository extends CrudRepository<Customer, Long> {}
6. 测试Repository
最后，我们应该确保Spring Boot确实可以连接到HSQLDB。我们可以通过仅测试Repository层来轻松完成此操作。
让我们开始测试Repository的findById()和findAll()方法：
@RunWith(SpringRunner.class)
@SpringBootTest
public class CustomerRepositoryTest {
@Autowired
private CustomerRepository customerRepository;
@Test
public void whenFindingCustomerById_thenCorrect() {
customerRepository.save(new Customer("John", "john@domain.com"));
assertThat(customerRepository.findById(1L)).isInstanceOf(Optional.class);
}
@Test
public void whenFindingAllCustomers_thenCorrect() {
customerRepository.save(new Customer("John", "john@domain.com"));
customerRepository.save(new Customer("Julie", "julie@domain.com"));
assertThat(customerRepository.findAll()).isInstanceOf(List.class);
}
}
最后，让我们测试一下save()方法：
@Test
public void whenSavingCustomer_thenCorrect() {
customerRepository.save(new Customer("Bob", "bob@domain.com"));
Customer customer = customerRepository.findById(1L).orElseGet(() -> new Customer("john", "john@domain.com"));
assertThat(customer.getName()).isEqualTo("Bob");
}
7. 总结
在本文中，我们学习了如何将Spring Boot与HSQLDB集成，以及如何在开发基本的JPA Repository层时使用基于文件或内存中的数据库。
与往常一样，本教程的完整源代码可在GitHub上获得。
Post Directory
