Spring Data JDBC示例与使用自定义 ID 插入记录

r囧r小猫 2023-09-26 11:27 19阅读 0赞

### 什么是春季数据 JDBC ###

**[弹簧数据 JDBC][JDBC] 项目属于弹簧数据系列，并为基于 JDBC 的数据访问层提供抽象**。它提供了易于使用的对象关系映射 （ORM） 框架来处理数据库。这意味着，春季数据JDBC支持使用实体对象和存储库。但是，它减少了JPA支持的**[弹簧数据JPA][JPA]**引入的许多复杂性。

为了使数据访问层尽可能简单，它省略了一些JPA功能，如延迟加载，实体缓存等。因此，它可以毫不费力地用于我们打算对实体执行纯 JDBC 操作的地方。

与任何其他春季项目一样，可以通过添加自己的初学者依赖项，在春季启动中启用春季数据JDBC。

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jdbc</artifactId>
    </dependency>

或者，如果您正在使用Spring应用程序，则可以像下面一样添加其依赖项。只需确保您使用的是最新版本。

<dependency>
        <groupId>org.springframework.data</groupId>
        <artifactId>spring-data-jdbc</artifactId>
        <version>{version}</version>
    </dependency>

由于它不是休眠支持的JPA实现，因此春季数据JDBC中没有实体。但是，我们可以将任何普通旧 Java 对象 （POJO） 指定为实体，并将其用于存储库。在下一节中，我们将了解如何执行此操作。

### 春季数据 JDBC 示例 ###

本节介绍春季数据 JDBC 的示例。我们将创建一个 Java POJO 以将其映射到表，并编写一个简单的 CRUD 存储库接口。

#### 创建数据库表 ####

与休眠和 JPA 组合不同，弹簧数据 JDBC 不会自动生成数据库表。因此，我们需要手动创建它们*或使用数据.sql*文件或 liquibase 来生成数据库架构。

接下来是为我们的示例创建 Student 表的命令。

create table student
    (
        student_id bigint auto_increment,
        first_name varchar(20) null,
        last_name  varchar(20) null,
        year       int         null,
        constraint student_id
            unique (student_id)
    );
    
    alter table student
        add primary key (student_id);

#### 使用POJO 作为实体 ####

如上所述，**春季数据JDBC可以将任何POJO映射到数据库表**，如果，

*  POJO 的名称与表的名称相同。否则，它将使用`@Table`批注来引用实际的表名。
 *  POJO 有一个主键，该主键注释为`@Id` 。
 *  POJO 中的所有持久化字段都具有与数据库表列相同的命名。否则，我们可以使用*@Column*注释来提供列名。

对于我们创建的表，我们将创建一个学生 java bean 并在主键上使用`@Id`。

package com.amitph.spring.tutorials.springdatajdbc.repo;
    
    import lombok.Data;
    import org.springframework.data.annotation.Id;
    import org.springframework.data.relational.core.mapping.Table;
    
    @Data
    @Table("student")
    public class Student {
        @Id
        private Long studentId;
        private String firstName;
        private String lastName;
        private Integer year;
    }

由于POJO的名称和数据库表是相同的，我们可以省略`@Table`注释，这是为了演示目的而添加的。我们使用龙目岛`@Data`注释来生成默认的获取器和设置器。但是，**访问方法和参数化构造函数对于映射到数据库表的 POJO 不是必需的**。

#### 写入存储库接口 ####

弹簧数据 JDBC 框架支持存储库，就像弹簧数据 JPA 一样。但是，我们很快就会讨论一些差异。此外，它还支持**[查询方法][Link 1]**和[@Query批注][Query]。

我们将为学生创建一个存储库界面，这是*Crud存储库*的子界面。

package com.amitph.spring.tutorials.springdatajdbc.repo;
    
    import org.springframework.data.repository.CrudRepository;
    import org.springframework.stereotype.Repository;
    
    import java.util.List;
    
    @Repository
    public interface StudentRepository extends CrudRepository<Student, Long> {
        List<Student> findByLastName(String lastName);
    }

Spring Data 动态提供查询方法的实现。此外，如果我们想要分页或排序结果，我们可以使用*PagingAndSortingRepository*。

### 使用弹簧数据 JDBC 命名查询 ###

为了生成自定义查询，我们可以派生存储库查询方法。但是，如果我们愿意，我们也可以编写本机查询。

需要注意的一点是，与 JPA 不同，春季数据 JDBC 不支持 JPQL 查询。因此，我们需要编写带有*@Query注释的*数据库本机SQL语句。

接下来是将命名查询与春季数据 JDBC 结合使用的示例。

@Query("select * from student where last_name = :lName")
    List<Student> findByLastName(@Param("lName") String lastName);

如示例所示，我们可以使用*@Param*注释将参数传递给查询。

### *@Id*春季数据 JDBC 中的生成 ###

*@Id*字段表示实体的主键，它是强制性的。当表的主列自动递增时，序列中的下一个值将用于插入新记录。

因此，当我们将POJO实例传递给方法时，如果`repository.save()`

*  *@ID字段为空 – POJO* 作为新记录插入到表中，具有下一个自动递增值。
 *  *@Id POJO 中的字段不为空* – 该操作被视为 *UPDATE*，如果在现有记录中找不到给定的主键，则会引发异常。

因此，**默认情况下，我们不能使用自定义或预定义的主键插入记录**。但是，我们接下来将看到一个解决方法。

#### 使用自定义 ID 插入记录 ####

为了**在Spring数据JDBC中插入具有自定义或预定义ID的新记录**，我们可以实现*持久化*接口，这迫使您实现*isNew（）*方法。根据此方法返回的布尔值，该记录将被视为新记录或更新记录。

package com.amitph.spring.tutorials.springdatajdbc.repo;
    
    import com.fasterxml.jackson.annotation.JsonIgnore;
    import lombok.Data;
    import org.springframework.data.annotation.Id;
    import org.springframework.data.annotation.Transient;
    import org.springframework.data.domain.Persistable;
    import org.springframework.data.relational.core.mapping.Table;
    
    @Data
    @Table("student")
    public class Student implements Persistable<Long> {
        @Id
        private Long studentId;
        private String firstName;
        private String lastName;
        private Integer year;
    
        @Transient
        @JsonIgnore
        private Boolean isInsert;
    
        @Override
        @JsonIgnore
        public Long getId() {
            return studentId;
        }
    
        @Override
        @JsonIgnore
        public boolean isNew() {
            return isInsert;
        }
    }

请注意，我们已将新的布尔标志标记为*@Transient*。因此，此字段将不会保留在数据库表中。

现在，我们可以**插入具有自定义ID的新记录**

Student student = new Student();
    student.setFirstName("fName");
    student.setFirstName("lName");
    student.setFirstName("2023");
            
    student.setStudentId(123L);
    student.setIsInsert(true);
    repository.save(student);

请注意，我们将瞬态字段设置为 *true*。因此，该记录将被视为新记录，并且将入，前提是 Id 值尚不存在。

同样，我们**可以通过提供自定义 Id 来更新现有记录**。

student.setStudentId(123L);
    student.setIsInsert(false);
    repository.save(student);

### 总结 ###

本教程详细介绍了**春季数据JDBC**，这是一个基于JDBC的对象关系映射（ORM）框架。该框架旨在通过减少JPA提供的大多数复杂功能来提供易于使用的轻量级数据访问层。

我们了解到，我们可以使用任何Java POJO映射到数据库表，并使用存储库和查询方法来让Spring Data生成低级查询。此外，我们还介绍了实际示例来理解这些概念。

有关弹簧和弹簧靴的更多信息，请访问[弹簧教程][Link 2]。有关所用示例的完整源代码，请访问我们的 [Github 存储库][Github]。

[JDBC]: https://github.com/spring-projects/spring-data-jdbc
[JPA]: https://www.amitph.com/hands-on-spring-data-jpa/
[Link 1]: https://www.amitph.com/spring-data-jpa-query-methods/
[Query]: https://www.amitph.com/spring-data-jpa-query-methods/#7_Named_Queries_Query
[Link 2]: https://www.amitph.com/spring/
[Github]: https://github.com/amitrp/spring-examples/tree/main/spring-data-jdbc