springboot嵌入式数据库实践-H2内嵌数据库(文件、内存)

news2024/9/22 17:20:31

本文章记录笔者的嵌入式数据库简单实现，

记录简要的配置过程。自用文章，仅作参考。

本文章记录笔者的嵌入式数据库简单实现，

记录简要的配置过程。自用文章，仅作参考。

嵌入式数据库

-------------------------------具体操作步骤------------------------------

1.导入依赖(Maven)

2.配置文件(application.properties)

A.文件数据库（本文示例）

B.内存数据库

C.DB_CLOSE_DELAY=-1（建议设置）对上述两者的影响：

D.主键生成策略(更详细的内容请自行查阅)

3.代码实现

A.创建实体类（创建数据库表）

B.创建持久层

4.配置完成，本次仅为简单的示例。

5.测试

在配置类下，编写如下代码，并运行

6.查看数据库

我们可以使用IDEA内置的数据库控制台查看数据库内容，打开数据库源和驱动程序编辑

嵌入式数据库

嵌入式数据库是一种轻量级的数据库管理系统，它被设计为直接嵌入到应用程序中运行，而不是作为独立的数据库服务器运行。

-------------------------------具体操作步骤------------------------------

1.导入依赖(Maven)

2.配置文件(application.properties)

spring.application.name=embedded_databases
# 文件数据库
spring.datasource.url=jdbc:h2:file:./data/embedded;DB_CLOSE_DELAY=-1

# 内存数据库
#spring.datasource.url=jdbc:h2:mem:embedded;DB_CLOSE_DELAY=-1


# 主键生成策略
spring.jpa.hibernate.ddl-auto=create

以下两种数据库存储形式自行选择

A.文件数据库（本文示例）

顾名思义，数据保存在文件中。

B.内存数据库

顾名思义，数据保存在内存中。

C.DB_CLOSE_DELAY=-1（建议设置）对上述两者的影响：

文件数据库：即使文件数据库被关闭，DB_CLOSE_DELAY=-1 会保持数据库的打开状态直到 JVM 进程结束，确保数据不会丢失。即使你保存到文件中，通常仍然会使用这个设置以避免频繁关闭和重新打开数据库。
内存数据库：如果你使用的是内存数据库（例如 jdbc:h2:mem:testdb），则 DB_CLOSE_DELAY 设置会影响数据库的生命周期。通常，内存数据库会在 JVM 结束时自动丢弃数据。对于内存数据库，DB_CLOSE_DELAY=-1 设置不会有实际作用，因为内存数据库本质上不会保存到磁盘。

D.主键生成策略(更详细的内容请自行查阅)

create：
每次应用启动时，会根据实体类创建新的数据库表结构。如果数据库中已经存在表，会先删除旧表再创建新表。这在开发阶段很有用，但在生产环境中使用可能会导致数据丢失。

create-drop：
在应用启动时创建数据库表结构，在应用关闭时删除这些表。同样适用于开发阶段，不适合生产环境。

update：
会根据实体类的变化更新数据库表结构。如果有新的实体类或实体类的属性发生了变化，会尝试对数据库表进行相应的修改。这在开发阶段可以避免频繁删除和创建表，但也需要谨慎使用，以免意外修改生产数据库。

validate：
不会对数据库表结构进行任何修改，只是验证实体类与数据库表结构是否匹配。如果不匹配，会在启动时抛出错误。这在生产环境中可以用于确保数据库结构与应用程序的预期一致。

none：
不执行任何数据库模式操作。完全由开发人员手动管理数据库表结构的创建和修改。在生产环境中通常使用这个值，以避免意外的数据库结构更改。

create适合开发测试环境，故作为本次选择。

3.代码实现

A.创建实体类（创建数据库表）

import jakarta.persistence.*;
import lombok.NoArgsConstructor;

/**
* 实体类，映射到数据库的表.
* @author Al Elijah
* create date: 2024/8/23
*/
@Entity
@Table(name = "MY_USER")
@Data
@NoArgsConstructor
public class MyUser {
    // 主键
    @Id
    // 主键生成策略（主键自增）
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    Integer id;

    String name;
    String password;

    public MyUser(String name, String password) {
        this.name = name;
        this.password = password;
    }
}

代码分析：

@Entity注解用于将一个普通的 Java 类标记为一个 JPA（Java Persistence API）实体类。这意味着这个类的对象可以被持久化到数据库中。当使用 JPA 框架时，框架会识别带有@Entity注解的类，并将其映射到数据库中的一张表。
@Table(name = "MY_USER")明确指定了这个实体类对应的数据库表名为MY_USER。这在以下情况下很有用：
- 当希望表名与类名不同时，可以通过这个注解进行自定义。
- 遵循特定的数据库命名规范，或者避免与数据库中的其他表名冲突。
@Id注解用于标识一个类中的属性作为数据库表的主键。主键是表中用于唯一标识每一行记录的字段。通过将一个属性标记为@Id，告诉 JPA（Java Persistence API）框架在进行数据库操作时，这个属性对应表中的主键列。
@GeneratedValue(strategy = GenerationType.IDENTITY)注解
- 主键生成策略，strategy = GenerationType.IDENTITY表示使用数据库的自增主键生成策略。更多策略请关注官方文档。

B.创建持久层

import org.h2.engine.User;
import org.springframework.data.repository.CrudRepository;

/**
* 持久层.
* @author Al Elijah
* create date: 2024/8/23
*/
@org.springframework.stereotype.Repository
public interface Repository extends CrudRepository<MyUser, Integer> {
    
}

CruRepository<T, ID> T-实体类， ID-id数据类型

注意：此处不声明任何方法，是因为extends CrudRepository可以继承基本的数库剧操作方法，包括插入(save)和查找(find)，因此无需手动声明。

4.配置完成，本次仅为简单的示例。

5.测试

在配置类下，编写如下代码，并运行

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import xyz.ascion_hub.embedded_databases.UserRepository.Repository;
import xyz.ascion_hub.embedded_databases.mapper.MyUser;

@Slf4j
@SpringBootTest
class EmbeddedDatabasesApplicationTests {

    @Autowired
    Repository repository;
    @Test
    void contextLoads() {
        MyUser myUser = new MyUser("Al Elijah", "Al Elijah");
        repository.save(myUser);
        // 获取ID一定要在save方法之后，否则结果的null
        Integer id = myUser.getId();
        // 断言查询结果不为空
        assert repository.findById(id).isPresent();

    }

}

执行结果如下：