Spring Boot 3JPA枚举类型持久化

【Spring Boot 3】【JPA】枚举类型持久化

  • 背景
  • 介绍
  • 开发环境
  • 开发步骤及源码
  • 工程目录结构
  • 总结

背景

软件开发是一门实践性科学,对大多数人来说,学习一种新技术不是一开始就去深究其原理,而是先从做出一个可工作的DEMO入手。但在我个人学习和工作经历中,每次学习新技术总是要花费或多或少的时间、检索不止一篇资料才能得出一个可工作的DEMO,这占用了我大量的时间精力。因此本文旨在通过一篇文章即能还原出可工作的、甚至可用于生产的DEMO,期望初学者能尽快地迈过0到1的这一步骤,并在此基础上不断深化对相关知识的理解。
为达以上目的,本文会将开发环境、工程目录结构、开发步骤及源码尽量全面地展现出来,文字描述能简则简,能用代码注释的绝不在正文中再啰嗦一遍,正文仅对必要且关键的信息做重点描述。

介绍

本文介绍开发Spring Boot应用时使用JPA处理枚举类型持久化的三种方法:

  • 使用 @Enumerated(EnumType.ORDINAL) 注解,存储枚举类型实例的定义顺序(从0开始递增),这也是JPA处理枚举类型的默认行为;
  • 使用 @Enumerated(EnumType.STRING) 注解,存储枚举类型实例的 name 属性,即 name() 方法返回值;
  • 自定义实现 jakarta.persistence.AttributeConverter 接口的转换类:
    • convertToDatabaseColumn 方法将枚举转换成存储到数据库中的数据;
    • convertToEntityAttribute 方法将从数据库中查询到的数据转换成枚举。

开发环境

分类 名称 版本
操作系统 Windows Windows 11
JDK Oracle JDK 21.0.1
IDE IntelliJ IDEA 2023.2.4
构建工具 Apache Maven 3.9.3
数据库 MySQL 8.0.33

开发步骤及源码

1> 创建Maven工程,添加依赖。

    <properties>
        <flyway.version>10.4.1</flyway.version>
        <spring-boot.version>3.2.2</spring-boot.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
            <version>${spring-boot.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <arti