ZetCode

Spring Boot HSQLDB

最后修改于 2023 年 7 月 16 日

Spring Boot HSQLDB 教程展示了如何在 Spring Boot 应用程序中使用 HSQLDB 数据库。

HSQLDB

HSQLDB 是一个完全用 Java 编写的开源关系数据库管理系统。它提供了一个小巧、快速、多线程、事务性的数据库引擎，具有内存和基于磁盘的表，并支持嵌入式和服务器模式。它包括一个强大的命令行 SQL 工具和简单的 GUI 查询工具。

Spring Boot HSQLDB 示例

以下示例是一个使用 HSQLDB 数据库的 Spring Boot Web 应用程序。

build.gradle
...
src
├── main
│   ├── java
│   │   └── com
│   │       └── zetcode
│   │           ├── Application.java
│   │           ├── controller
│   │           │   └── CityController.java
│   │           ├── model
│   │           │   └── City.java
│   │           └── service
│   │               ├── CityService.java
│   │               └── ICityService.java
│   └── resources
│       ├── application.yaml
│       ├── data-hsqldb.sql
│       ├── schema-hsqldb.sql
│       ├── static
│       │   ├── css
│       │   │   └── style.css
│       │   └── index.html
│       └── templates
│           └── showCities.mustache
└── test
    ├── java
    └── resources

这是项目结构。

build.gradle 
plugins {
    id 'org.springframework.boot' version '3.1.1'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

group = 'com.zetcode'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-mustache'
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'

    runtimeOnly 'org.hsqldb:hsqldb'
}

这是 Gradle 构建文件。spring-boot-starter-mustache 是一个用于使用 Mustache 构建 Spring MVC 应用程序的启动器。hsqldb 是 HSQLDB 的驱动程序。spring-boot-starter-jdbc 是一个用于在 Spring Boot 中使用 JDBC 的启动器。

com/zetcode/model/City.java 
package com.zetcode.model;

import java.util.Objects;

public class City {

    private Long id;

    private String name;
    private int population;

    public City() {
    }

    public City(String name, int population) {
        this.name = name;
        this.population = population;
    }

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getPopulation() {
        return population;
    }

    public void setPopulation(int population) {
        this.population = population;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        City city = (City) o;
        return population == city.population &&
                Objects.equals(name, city.name);
    }

    @Override
    public int hashCode() {
        return Objects.hash(name, population);
    }

    @Override
    public String toString() {

        var builder = new StringBuilder();
        builder.append("City{id=").append(id).append(", name=")
                .append(name).append(", population=")
                .append(population).append("}");

        return builder.toString();
    }
}

这是 City 类。它包含 id、name 和 population 字段。

resources/application.yml 
spring:
  main:
    banner-mode: off
  sql:
    init:
      platform: hsqldb

application.yml 是主要的 Spring Boot 配置文件。通过 banner-mode 属性，我们关闭了 Spring 横幅。平台值用于 SQL 初始化脚本：schema-${platform}.sql 和 data-${platform}.sql。

请注意，我们没有配置数据源；如果没有任何配置数据，Spring 会自动在内存模式下配置 HSQLDB。我们希望拥有一个内存数据库，所以我们让 Spring 进行自动配置。

resources/schema-hsqldb.sql 
CREATE TABLE cities(id BIGINT IDENTITY PRIMARY KEY,
    name VARCHAR(255), population INT);

此 SQL 脚本创建 cities 表。HSQLDB 使用 IDENTITY 子句创建自动递增的列。默认情况下，id 从零开始。

resources/data-hsqldb.sql 
INSERT INTO cities(name, population) VALUES('Bratislava', 432000);
INSERT INTO cities(name, population) VALUES('Budapest', 1759000);
INSERT INTO cities(name, population) VALUES('Prague', 1280000);
INSERT INTO cities(name, population) VALUES('Warsaw', 1748000);
INSERT INTO cities(name, population) VALUES('Los Angeles', 3971000);
INSERT INTO cities(name, population) VALUES('New York', 8550000);
INSERT INTO cities(name, population) VALUES('Edinburgh', 464000);
INSERT INTO cities(name, population) VALUES('Suzhou', 4327066);
INSERT INTO cities(name, population) VALUES('Zhengzhou', 4122087);
INSERT INTO cities(name, population) VALUES('Berlin', 3671000);

此脚本用数据填充表。这两个脚本都位于类路径的根目录。

com/zetcode/service/ICityService.java 
package com.zetcode.service;

import com.zetcode.model.City;
import java.util.List;

public interface ICityService {

    List<City> findAll();
}

ICityService 提供了一个契约方法，用于从数据源获取所有城市。

com/zetcode/service/CityService.java 
package com.zetcode.service;

import com.zetcode.model.City;
import org.springframework.jdbc.core.BeanPropertyRowMapper;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class CityService implements ICityService {

    private final JdbcTemplate jtm;

    public CityService(JdbcTemplate jtm) {
        this.jtm = jtm;
    }

    @Override
    public List<City> findAll() {

        String sql = "SELECT * FROM cities";

        return jtm.query(sql, new BeanPropertyRowMapper<>(City.class));
    }
}

CityService 包含 findAll 方法的实现。我们借助 JdbcTemplate 从 cities 表中检索所有城市。

private final JdbcTemplate jtm;

public CityService(JdbcTemplate jtm) {
    this.jtm = jtm;
}

JdbcTemplate 已注入。

String sql = "SELECT * FROM cities";

这是要执行的SQL。我们从 cities 表中选择所有城市。

return jtm.query(sql, new BeanPropertyRowMapper<>(City.class));

BeanPropertyRowMapper 将一行转换为指定映射目标类的新实例。

com/zetcode/controller/CityController.java 
package com.zetcode.controller;

import com.zetcode.model.City;
import com.zetcode.service.ICityService;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

@Controller
public class CityController {

    private final ICityService cityService;

    public CityController(ICityService cityService) {
        this.cityService = cityService;
    }

    @RequestMapping("/showCities")
    public ModelAndView showCities() {

        List<City> cities = cityService.findAll();

        System.out.println(cities);

        Map<String, Object> params = new HashMap<>();
        params.put("cities", cities);

        return new ModelAndView("showCities", params);
    }
}

这是 Spring Boot Web 应用程序的控制器类。控制器用 @Controller 注解进行装饰。/showCities 映射列出所有城市。

private final ICityService cityService;

public CityController(ICityService cityService) {
    this.cityService = cityService;
}

我们将 ICityService 注入到字段中。

@RequestMapping("/showCities")
public ModelAndView showCities() {

    List<City> cities = cityService.findAll();

    System.out.println(cities);

    Map<String, Object> params = new HashMap<>();
    params.put("cities", cities);

    return new ModelAndView("showCities", params);
}

此控制器方法提供城市列表。我们从城市服务中找到所有城市对象，并将结果列表放入参数中。Spring 将找到名为 showCities 的 Mustache 视图，并让引擎将模板与数据连接起来。

resources/static/css/style.css 
h2 {color: blue}

td:nth-child(3) {
    text-align: right;
}

style.css 是一个静态文件，位于 src/main/resources/static/css 目录中。它将 h2 标签设置为蓝色，并右对齐第三列的数据。

resources/static/index.html 
<!DOCTYPE html>
<html lang="en">
    <head>
        <title>Home page</title>
        <meta charset="UTF-8"/>
        <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
    </head>
    <body>
        <a href="showCities">Show cities</a>
    </body>
</html>

index.html 模板文件是应用程序的主页。它包含一个检索所有城市对象的链接。

resources/templates/showCities.mustache 
<!DOCTYPE html>
<html lang="en">
<head>
    <title>Cities</title>
    <link rel="stylesheet" href="css/style.css" />
    <meta charset="UTF-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
</head>
<body>

<h2>Cities</h2>

<table>
    <tr>
        <th>Id</th>
        <th>Name</th>
        <th>Population</th>
    </tr>
    {{#cities}}
        <tr>
            <td>{{id}}</td>
            <td>{{name}}</td>
            <td>{{population}}</td>
        </tr>
    {{/cities}}
</table>
</body>
</html>

showCities.mustache 是一个 Mustache 模板文件，其中包含要使用来自模型的数据填充的占位符。Mustache 使用 {{}} 语法。

<link rel="stylesheet" href="css/style.css" />

我们包含静态 CSS 文件。

{{#cities}}
    <tr>
        <td>{{id}}</td>
        <td>{{name}}</td>
        <td>{{population}}</td>
    </tr>
{{/cities}}

{{#cities}} 语法称为一个 section。Sections 根据当前上下文中键的值渲染一个或多个文本块。一个 section 以 {{#name}} 开头，以 {{/name}} 结尾。如果该值是一个非空列表，则该 section 将被显示多次。在每种情况下，section 的上下文将被设置为列表中的元素。

com/zetcode/Application.java 
package com.zetcode;

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

@SpringBootApplication
public class Application {

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

我们设置Spring Boot应用程序。 @SpringBootApplication 注解启用自动配置和组件扫描。

$ ./gradlew bootRun

我们运行应用程序并导航到 localhost:8080。

在本文中，我们创建了一个带有 HSQLDB 和 Mustache 的 Spring Boot Web 应用程序。

作者

我的名字是 Jan Bodnar，我是一位充满激情的程序员，拥有丰富的编程经验。自 2007 年以来，我一直在撰写编程文章。迄今为止，我撰写了 1,400 多篇文章和 8 本电子书。我拥有超过十年的编程教学经验。

列出 所有 Spring Boot 教程。