Spring Boot H2 数据库

18 Mar 2025 | 8 分钟阅读

什么是内存数据库

内存数据库依赖于系统内存而不是磁盘空间来存储数据。由于内存访问速度比磁盘访问速度快。当我们不需要持久化数据时，我们使用内存数据库。内存数据库是一个嵌入式数据库。默认情况下，内存数据库是易失性的，当我们重新启动应用程序时，所有存储的数据都会丢失。

广泛使用的内存数据库有 H2, HSQLDB (HyperSQL Database), 和 Apache Derby. 它会自动创建配置。

持久性数据库与内存数据库

持久性数据库将数据保存在物理内存中。即使数据库服务器重新启动，数据也将可用。一些流行的持久性数据库包括 Oracle, MySQL, Postgres, 等。

对于内存数据库，数据存储在系统内存中。程序关闭时会丢失数据。它对 POC（概念验证）很有用，而不是用于生产应用程序。广泛使用的内存数据库是 H2。

什么是 H2 数据库

H2 是一个 嵌入式、开源 和内存数据库。它是一个用 Java 编写的关系数据库管理系统。它是一个 客户端/服务器 应用程序。它通常用于 单元测试。它将数据存储在内存中，而不是将数据持久保存在磁盘上。

优点

零配置
易于使用。
它轻巧且快速。
它提供了简单的配置来在真实数据库和内存数据库之间切换。
它支持标准 SQL 和 JDBC API。
它提供了一个 Web 控制台来维护数据库。

配置 H2 数据库

如果我们想在应用程序中使用 H2 数据库，我们需要在 pom.xml 文件中添加以下依赖项

<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>runtime</scope>
</dependency>

添加依赖项后，我们需要配置 H2 数据库的 数据源 URL、驱动程序类名、用户名 和密码。Spring Boot 提供了一种在 application.properties 文件中配置这些属性的简便方法。

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect

在 spring.datasource.url 属性中，mem 是内存数据库的名称，testdb 是 H2 提供的模式名称，默认情况下。我们也可以定义我们自己的模式和数据库。默认用户名是 sa，空白密码表示空密码。如果我们想更改用户名和密码，我们可以覆盖这些值。

在 H2 数据库中持久化数据

如果我们想在 H2 数据库中持久化数据，我们应该将数据存储在文件中。为了实现同样的目的，我们需要更改数据源 URL 属性。

#persist the data
spring.datasource.url=jdbc:h2:file:/data/sampledata
spring.datasource.url=jdbc:h2:C:/data/sampledata

在上面的属性中，sampledata 是文件名。

创建模式并填充数据

我们可以通过在 resource 文件夹 (src/main/resource) 中创建一个 SQL 文件来定义模式。

schema.sql

DROP TABLE IF EXISTS CITY;
CREATE TABLE CITY (
City_code INT AUTO_INCREMENT  PRIMARY KEY,
city_name VARCHAR(50) NOT NULL,
city_pincode INT(8) NOT NULL
);

我们可以通过在 resource 文件夹 (src/main/resource) 中创建一个 SQL 文件来填充表中的数据。

data.sql

INSERT INTO CITY VALUES (11, 'Delhi', 110001);  
INSERT INTO CITY VALUES (12, 'Kanpur', 208001);  
INSERT INTO CITY VALUES (13, 'Lucknow', 226001);  

Spring Boot 会自动拾取 data.sql 文件并在应用程序启动期间针对 H2 数据库运行它。

H2 控制台

默认情况下，H2 数据库的控制台视图已禁用。在访问 H2 数据库之前，我们必须使用以下属性启用它。

#enabling the H2 console
spring.h2.console.enabled=true

启用 H2 控制台后，我们现在可以通过调用 URL https://:8080/h2-console 在浏览器中访问 H2 控制台。下图显示了 H2 数据库的控制台视图。

在上面的截图，我们定义了自己的名为 javatpoint 的数据库。

Spring Boot H2 示例

让我们设置一个带有 H2 数据库的 Spring Boot 应用程序。

步骤1： 打开Spring Initializr http://start.spring.io。

步骤 2： 选择 Spring Boot 版本 2.3.0.M1。

步骤 2：提供Group 名称。我们提供了 com.javatpoint。

步骤 3： 提供 Artifact Id。我们提供了 spring-boot-h2-database-example.

步骤 5： 添加依赖项 Spring Web, Spring Data JPA, 和 H2 数据库。

步骤 6： 单击 Generate 按钮。当我们单击 Generate 按钮时，它会将项目打包成一个 Jar 文件并将其下载到本地系统。

步骤 7： 解压 Jar 文件并将其粘贴到 STS 工作区中。

步骤 8： 导入项目文件夹到 STS 中。

文件 -> 导入 -> 现有 Maven 项目 -> 浏览 -> 选择文件夹 spring-boot-h2-database-example -> 完成

它需要一些时间来导入。

步骤 9： 在文件夹 src/main/java 中创建一个名为 com.javatpoint.model 的包。

步骤 10： 在包 com.javatpoint.model 中创建一个模型类。我们创建了一个名为 Student 的模型类。在 Books 类中，我们做了以下操作

定义四个变量 id, age, name, 和
生成 Getters 和 Setters。
右键单击该文件 -> Source -> Generate Getters and Setters.
使用注解 @Entity 将类标记为 Entity。
使用注解 @Table 将类标记为 Table 名称。
使用注解 @Column 将每个变量定义为 Column。

Student.java

package com.javatpoint.model;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Table;
//mark class as an Entity 
@Entity
//defining class name as Table name
@Table
public class Student 
{
//mark id as primary key
@Id
//defining id as column name
@Column
private int id;
//defining name as column name
@Column
private String name;
//defining age as column name
@Column
private int age;
//defining email as column name
@Column
private String email;
public int getId() 
{
return id;
}
public void setId(int id) 
{
this.id = id;
}
public String getName() 
{
return name;
}
public void setName(String name) 
{
this.name = name;
}
public int getAge() 
{
return age;
}
public void setAge(int age) 
{
this.age = age;
}
public String getEmail() 
{
return email;
}
public void setEmail(String email) 
{
this.email = email;
}
}

步骤 11： 在文件夹 src/main/java 中创建一个名为 com.javatpoint.controller 的包。

步骤 12： 在包 com.javatpoint.controller 中创建一个 Controller 类。我们创建了一个名为 StudentController 的控制器类。在 StudentController 类中，我们做了以下操作

使用注解 @RestController 将类标记为 RestController。
使用注解 @Autowired 自动连接 StudentService 类。
定义以下方法
- getAllStudent(): 它返回所有学生的列表。
- getStudent(): 它返回我们在路径变量中指定的学生详细信息。我们使用注解 @PathVariable 传递了 id 作为参数。该注解表明方法参数应该绑定到 URI 模板变量。
- deleteStudent(): 它删除我们在路径变量中指定的特定学生。
- saveStudent(): 它保存学生的详细信息。注解 @RequestBody 表明方法参数应该绑定到 Web 请求的正文。

StudentController.java

package com.javatpoint.controller;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import com.javatpoint.model.Student;
import com.javatpoint.service.StudentService;
//creating RestController
@RestController
public class StudentController 
{
//autowired the StudentService class
@Autowired
StudentService studentService;
//creating a get mapping that retrieves all the students detail from the database 
@GetMapping("/student")
private List<Student> getAllStudent() 
{
return studentService.getAllStudent();
}
//creating a get mapping that retrieves the detail of a specific student
@GetMapping("/student/{id}")
private Student getStudent(@PathVariable("id") int id) 
{
return studentService.getStudentById(id);
}
//creating a delete mapping that deletes a specific student
@DeleteMapping("/student/{id}")
private void deleteStudent(@PathVariable("id") int id) 
{
studentService.delete(id);
}
//creating post mapping that post the student detail in the database
@PostMapping("/student")
private int saveStudent(@RequestBody Student student) 
{
studentService.saveOrUpdate(student);
return student.getId();
}
}

步骤 13： 在文件夹 src/main/java 中创建一个名为 com.javatpoint.service 的包。

步骤 14： 创建一个 Service 类。我们在包 com.javatpoint.service 中创建了一个名为 StudentService 的服务类。

StudentService.java

package com.javatpoint.service;
import java.util.ArrayList;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.javatpoint.model.Student;
import com.javatpoint.repository.StudentRepository;
@Service
public class StudentService 
{
@Autowired
StudentRepository studentRepository;
//getting all student records
public List<Student> getAllStudent() 
{
List<Student> students = new ArrayList<Student>();
studentRepository.findAll().forEach(student -> students.add(student));
return students;
}
//getting a specific record
public Student getStudentById(int id) 
{
return studentRepository.findById(id).get();
}
public void saveOrUpdate(Student student) 
{
studentRepository.save(student);
}
//deleting a specific record
public void delete(int id) 
{
studentRepository.deleteById(id);
}
}

步骤 15： 在文件夹 src/main/java 中创建一个名为 com.javatpoint.repository 的包。

步骤 16： 创建一个 Repository 接口。我们在包 com.javatpoint.repository 中创建了一个名为 StudentRepository 的存储库接口。它扩展了 Crud Repository 接口。

StudentRepository.java

package com.javatpoint.repository;
import org.springframework.data.repository.CrudRepository;
import com.javatpoint.model.Student;
public interface StudentRepository extends CrudRepository<Student, Integer>
{
}

现在我们将配置 URL、驱动程序类名、用户名 和密码，在 application.properties 文件中。

步骤 17： 打开 application.properties 文件并配置以下属性。

application.properties

spring.datasource.url=jdbc:h2:mem:javatpoint
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
#enabling the H2 console
spring.h2.console.enabled=true

注意：不要忘记启用 H2 控制台。

创建所有类和包后，项目目录如下所示。

现在我们将运行该应用程序。

步骤 18： 打开 SpringBootH2DatabaseExampleApplication.java 文件并将其作为 Java 应用程序运行。

SpringBootH2DatabaseExampleApplication.java

package com.javatpoint;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class SpringBootH2DatabaseExampleApplication 
{
public static void main(String[] args) 
{
SpringApplication.run(SpringBootH2DatabaseExampleApplication.class, args);
}
}

在下一步中，我们将使用 REST 客户端 Postman 来发送 POST 和 GET 请求。如果您的系统尚未安装 Postman，请按照以下步骤操作

从 https://www.getpostman.com/downloads/ 下载 Postman 或在浏览器中添加 Google Chrome 扩展 https://bit.ly/1HCOCwF。
启动 Postman 并 Signup。创建一个用户名。我们创建了一个名为 javatpoint 的用户，并单击了提交

步骤 19： 打开 Postman 并执行以下操作

选择 POST
调用 URL https://:8080/student。
选择 Body
选择 Content-Type JSON (application/json)。
插入数据。我们在正文中插入了以下数据

{
    "id": "001",
    "age": "23",
    "name": "Amit",
    "email": "amit@yahoo.co.in"
} 

单击发送

当请求成功执行时，它会显示 状态：200 OK。这意味着记录已成功插入数据库中。

同样，我们插入了以下数据。

{
    "id": "002",
    "age": "24",
    "name": "Vadik",
    "email": "vadik@yahoo.co.in"
} 
{
    "id": "003",
    "age": "21",
    "name": "Prateek",
    "email": "prateek@yahoo.co.in"
} 
{
    "id": "004",
    "age": "25",
    "name": "Harsh",
    "email": "harsh@yahoo.co.in"
} 
{
    "id": "005",
    "age": "24",
    "name": "Swarit",
    "email": "Swarit@yahoo.co.in"
} 

让我们访问 H2 控制台以查看数据。

步骤 20： 打开浏览器并调用 URL https://:8080/h2-console。单击 Connect 按钮，如下所示。