0
0

Spring 加强版 ORM 框架 Spring Data 入门

概述

Spring 中有多种操作数据库的方式，通常来说我们优先选择的是 MyBatis，如果业务比较简单我们还会使用 JdbcTemplate，另外据说国外使用 spring-data-jpa 比较多？

最近发现了 Spring 中另一款操作关系型数据库的框架，相对 JdbcTemplate 来说使用上又简化了一些，它也是 Spring Data 大家族中的一员，即 spring-data-jdbc，分享给大家。

由于 Spring Data 内容较多，分为上下两篇介绍，本篇我们先介绍一些 Spring Data 的基础知识，下篇再介绍 spring-data-jdbc。

模块划分

Spring Data 大家族中有一些每个模块都要遵守的规范，这些规范定义在 spring-data-commons 模块中，理解这些规范后，切换到具体的实现模块能很快上手。这些模块之间的关系可以用下面的图来表示。
在这里插入图片描述

核心概念

Spring Data 的实现借鉴了领域驱动设计 DDD 的设计原则，规范中的核心概念是 Repository，它表示一个管理 Domain 的仓库，所有的数据库操作都要经过 Repository。
在这里插入图片描述

Domain 则表示数据库表在 Java 中的映射，每个 Domain 都必须有一个唯一的 ID 标识，可以通过 

@Id

注解标识。例如，我们有一个关系型数据库表 

user

，结构如下：

createtableuser(
    id          bigintunsignedauto_incrementprimarykey,
    username    varchar(20)null,
    password    varchar(20)null);

可以使用如下的类表示。

@DatapublicclassUser{@IdprivateLong id;privateString username;privateString password;}

Repository 作为一个接口，接收具体的 Domain 类型和 Domain 的 ID 类型作为泛型参数。接口定义如下。

publicinterfaceRepository<T, ID>{}

自定义 Repository 接口

Repository

Repository

只是一个标记接口，对于开发者来说需要提供一个 

Repository

的子接口，然后再定义一些操作数据库的方法。例如，针对上面的 Domain 

User

我们可以定义一个这样的 

Repository

。

publicinterfaceUserRepositoryextendsRepository<User,Long>{Optional<User>findById(Long id);}

Spring Data 实现模块会根据特定的语法规则将方法解析为具体的查询方式，例如对于 

spring-data-jdbc

模块来说，上面的 

findById

可以解析为如下 SQL。

select id,username,password fromuserwhere id = ?

如果多个 Domain 相同的操作比较多，我们还可以将方法定义到一个 

BaseRepository

中，示例如下。

@NoRepositoryBeanpublicinterfaceBaseRepository<T, ID>extendsRepository<T, ID>{Optional<T>findById(ID id);}publicinterfaceUserRepositoryextendsBaseRepository<User,Long>{}

创建 Repository 实例

Spring Data 实现模块会为我们定义的接口创建代理对象并将这个代理对象注册为 bean，为了避免将 

BaseRepository

注册为 bean，我们需要为自定义的 

BaseRepository

添加注解 

@NoRepositoryBean

。

最后，我们还需要使用 

@EnableXXXRepository

注解开启接口注册为 bean 的功能，以 spring-data-jdbc 为例，如下。

@EnableJdbcRepositories(basePackages ="com.zzuhkp.repository")@ConfigurationpublicclassJdbcConfig{}

basePackages

属性指定 repository 的接口位置，默认为注解所在类的包。

CrudRepository

Spring Data 为我们预置了一些 

Repository

的子接口，最常用的是 

CrudRepository

，它定义了增删改查的基本方法，接口定义如下。

@NoRepositoryBeanpublicinterfaceCrudRepository<T, ID>extendsRepository<T, ID>{<SextendsT>Ssave(S entity);<SextendsT>Iterable<S>saveAll(Iterable<S> entities);Optional<T>findById(ID id);booleanexistsById(ID id);Iterable<T>findAll();Iterable<T>findAllById(Iterable<ID> ids);longcount();voiddeleteById(ID id);voiddelete(T entity);voiddeleteAll(Iterable<?extendsT> entities);voiddeleteAll();}

其中 

save

和 

saveAll

方法根据是否为新记录进行添加或更新操作。

PagingAndSortingRepository

如果我们需要进行分页查询或排序，我们还可以继承 

PagingAndSortingRepository

接口，这个接口的定义如下。

@NoRepositoryBeanpublicinterfacePagingAndSortingRepository<T, ID>extendsCrudRepository<T, ID>{Iterable<T>findAll(Sort sort);Page<T>findAll(Pageable pageable);}

Sort

声明方式如下。

Sort sort1 =Sort.by("username").ascending().and(Sort.by("password").descending());Sort.TypedSort<User> sort =Sort.sort(User.class);Sort sort2 = sort.by(User::getUsername).ascending().and(sort.by(User::getPassword).descending());

Pageable

声明方式如下。

Pageable page =PageRequest.of(0,10, sort1);

📢 注意：

Pageable

的页码是从 0 开始的。

@RepositoryDefinition

如果我们不想继承 Spring Data 提供的接口，我们还可以在自己的接口上标注 

@RepositoryDefinition

注解指定 Domain 类型和 ID 类型。如下所示。

@RepositoryDefinition(domainClass =User.class, idClass =Long.class)publicinterfaceUserRepository{Optional<User>findById(Long id);}

自定义 Repository 接口实现

上面定义的 Repository 接口方法都必须借助 Spring Data 自身的实现，Spring Data 还允许我们定义自己的 Repository 实现。

首先定义一个接口。

packagecom.zzuhkp.demo.repository;publicinterfaceCustomizedUserRepository{intsave(User entity);}

然后定义 Repository 实现。

packagecom.zzuhkp.demo.repository;@ComponentpublicclassCustomizedUserRepositoryImpl<T>implementsCustomizedUserRepository{@AutowiredprivateJdbcTemplate jdbcTemplate;@Overridepublicintsave(User entity){String sql ="insert into user(username,password) values(?,?)";String username = entity.getUsername();String password = entity.getPassword();return jdbcTemplate.update(sql, username, password);}}

然后我们的 Repository 继承自定义的 

CustomizedUserRepository

接口即可。

publicinterfaceUserRepositoryextendsRepository<User,Long>,CustomizedUserRepository{}

📢 注意：Spring Data 只会在自定义 Repository 接口所在包下面查找名称为 

XxxImpl

的实现，如果有多个实现会使用名称为 

xxxImpl

的 bean。如果不想使用 

Impl

后缀，可以通过 

@EnableXXXRepository.repositoryImplementationPostfix

注解属性修改。

@EnableJdbcRepositories(repositoryImplementationPostfix ="Impl")@ConfigurationpublicclassJdbcConfig{}

自定义 Repository 方法

Spring Data 实现模块有两种方式根据方法确认具体的数据库操作，第一种是解析 

Repository

方法名，第二种是解析 

Repository

方法上的注解。不同的 Spring Data 实现模块使用的注解可能有所不同，但是对于方法名的解析是类似的。

语法规则

Repository 的方法名可以分为 subject 部分和 predicate 部分，例如 

find...by...

中的 

find

后面的部分表示要查询的 subject，

by

后面的部分表示查询条件 predicate。

find

后还可以跟 

distinct

、

top

、

first

等词语限制查询结果，

by

后面可以紧跟 Domain 类的属性名和一些修饰词进行限定。下面是一些示例，可以很容易看明白。

publicinterfaceUserRepositoryextendsPagingAndSortingRepository<User,Long>{// 查询第一个满足条件的 UserUserfindFirstByUsername(String username);// 查询前 10 个满足条件的 UserList<User>findTop10ByUsernameOrderByIdAsc(String username);// 根据用户名查询用户，忽略用户名大小写List<User>findDistinctByUsernameIgnoreCase(String username);}

关键字比较多，不同的实现模块可能支持的关键字有所不同，对于 

spring-data-jdbc

来说可以参考 Spring Data Repository 方法关键字 查询支持的关键字。

接入 Spring Data 时， Intellij Idea 还会有代码提示，如果你还在用 eclipse，不妨试试 Idea ？
在这里插入图片描述

特殊参数

PagingAndSortingRepository

接口方法支持 

Pageable

和 

Sort

作为方法参数，如果不想进行分页或者排序，可以传入 

Pageable.unpaged()

或 

Sort.unsorted()

。

返回类型

Spring Data Repository 支持多种方法的返回值，具体如下。

  • 基本类型及其包装类型。
  • Domain 具体类型以及 Optional<Domain>。。
  • 集合/迭代类型：List<Domain>、Set<Domain>、Iterable<Domain>，Stream<Domain>，除此之外还支持 Spring Data 内置的 Streamable<Domain> 类型。
  • 异步结果：Future、CompletableFuture、ListenableFuture，需要 @EnableAsync 开启异步，并在方法上添加 @Async 注解。

Spring Data 多模块

有时候，我们可能需要使用多个 Spring Data 的模块，例如操作关系型数据库我们可以使用 

spring-data-jpa

，操作 MongoDB 数据库我们可以使用 

spring-data-mongodb

，这个时候必须有一种方式能够区分不同类型的 

Repository

，具体来说有两种方式。

**1. 根据 

Respsitory

类型区分**

如果自定义的 Repository 实现了某个模块特有的接口，可以根据这个特有的接口创建代理。例如：

publicinterfaceUserRepositoryextendsJpaRepository<User,Long>{}

2. 根据 Domain 注解区分
不用的 Spring Data 模块在 Domain 类型上使用的注解有所不同，如果使用了某个模块特有的注解，也可以识别出 Repository 的类型。例如：

@Data@EntitypublicclassUser{@IdprivateLong id;privateString username;privateString password;}

@Entity

是 JPA 特有的注解，因此可以识别 

UserRepository

是 

spring-data-jpa

模块的 Repository。

3. basePackages 区分
有时候我们定义的 

Repository

接口可能没继承某个模块特有的注解，并且 Domain 类上混合使用了多个模块的注解，这个时候怎么办呢？

放大招，在 

@EnableXXXRepository

注解的 

basePackages

属性中指定 

Repository

所在的具体包名，这时候 Spring Data 就可以识别出 Repository 接口是哪个模块下的了。

@EnableJdbcRepositories(basePackages ="com.zzuhkp.repository")

事件发布

Repository 管理的 Domain 又被称为聚合根，聚合根可以发布一些 Domain 事件。

Spring Data 支持事件发布的注解是 

@DomainEvents

，可以在聚合根的方法上添加这个注解，当调用 

save

、

saveAll

、

delete

、

deleteAll

时会调用注解标注的方法。例如：

@DatapublicclassUser{privateLong id;@DomainEventsCollection<UserEvent>domainEvents(){System.out.println("发布事件");returnCollections.singleton(newUserEvent().setId(this.getId()));}}

如果发布事件时使用了一些资源，还可以使用 

@AfterDomainEventPublication

标注的方法在事件发布后清理一些资源。

@DatapublicclassUser{@AfterDomainEventPublicationvoidcallbackMethod(){System.out.println("事件已发布");}}

怎么接收这些事件呢？直接使用 Spring 提供的事件监听器即可。

@EventListenerpublicvoidevent(UserEvent event){System.out.println("接收到 UserEvent 事件");}

感觉这个特性用的应该不多，大家有个印象即可。

Spring Web 支持

Spring Data 提供了对 Spring MVC 的支持，可以通过 

@EnableSpringDataWebSupport

注解开启。提供的功能特性如下：

1. Domain 解析

开启 Spring Web 支持后 Spring Data 会注册一个 

DomainClassConverter

类型的转换器，将路径变量或请求参数转换为 handler 方法中的 Domain 参数值。

@GetMapping("/user/{id}")Userget(@PathVariable("id")User user){return user;}

2. Pageable、Sort 解析

开启 Spring Web 支持后 Spring Data 会为类型为 

Pageable

和 

Sort

的 handler 方法参数分别注册一个参数解析器，具体为 

PageableHandlerMethodArgumentResolver

和 

SortHandlerMethodArgumentResolver

。

@GetMapping("/user/list")List<User>list(Pageable pageable){returnnull;}

客户端传哪个参数才能解析呢？先看一个示例。

page=0&size=10&sort=username,asc&sort=password,desc,ignorecase
  • page 表示页码，从 0 开始；
  • size 表示页大小，默认为 10。
  • sort 用于排序，格式为 property(,asc|desc)(,ignorecase)， property 为属性名，asc 表示升序， desc 表示降序，ignorecase 表示忽略大小写。

总结

Spring Data 功能特性 = 通用功能 + 各模块独有功能，本篇主要总结了 Spring Data 的通用功能特性部分，这些基础知识适用于 Spring Data 的各模块，了解这些内容后，再学习具体模块能很快上手了。后面会对具体模块进行介绍。

标签： java spring orm
本文转载自: https://blog.csdn.net/zzuhkp/article/details/124910190
版权归原作者 大鹏cool 所有， 如有侵权，请联系我们删除。
登录后发布评论

“Spring 加强版 ORM 框架 Spring Data 入门”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

机器人技术在安全领域的重要作用

安全学习记录——网络篇（一）

图腾柱PFC：HP1010为您的电动两轮车之旅提供绿色，高效，安全的动力

单元测试数据库回滚问题

这才是单元测试，之前我们都错了

【C语言基础】：字符函数和字符串函数

ChatGPT-Next-Web SSRF漏洞+XSS漏洞复现(CVE-2023-49785)

文章导航