返回资讯中心
外部精选
软件工程
#开发者实时流

博客作者用 JDBI 替换 Spring petclinic 项目的 Spring Data

来源标题:Dissecting Spring petclinic (Part 2 – Bending the persistence)

一位博主在 Spring petclinic 项目的第二篇系列文章中,将 Spring Data 替换为更接近纯 SQL 的 JDBI,并用简单的 POJO 表示持久化数据。作者同时指出项目现有测试存在问题,例如难以看出测试所安排的数据、触发的功能和预期的行为。该文是探讨 Spring 的系列博客第二篇。

Hacker News 最新ejboy2026/11/15 · 3 天前30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

这是关于 Spring 系列博客的第二篇。在阅读本文之前,请先阅读我的开篇博文和之前的几篇。

这一次,我用 JDBI 替换了 Spring Data——它更接近纯 SQL,并配合一些简单的 POJO 来表示持久化数据。

在探索 petclinic 项目时,我意识到在大多数测试里,我并不能立刻看出到底在测什么。我用本系列第一篇中写到的方法解决了这个问题。我也意识到,出于若干原因,我认为现有的测试并不算好。虽然我改进了其中一些顾虑,但仍有一些遗留问题。比如,一个好的测试应当清楚地表明:准备了什么数据、触发了什么功能、期望得到什么行为。理想情况下,数据的准备应当直接写在测试里,以保持推理的局部性,并让测试彼此独立。我们来看一个现有的测试。

你可以在 OwnerControllerTest 里找到这样一个测试:

void testShowOwner() throws Exception {
 var httpResponse = get("http://localhost:" + port + "/owners/" + TEST_OWNER_ID);
 assertEquals(200, httpResponse.statusCode());
 assertThat(httpResponse.body().toString()).containsSubsequence("<tr>","<th>","Name","</th>","<td>","<b>","George Franklin", ...
 assertThat(httpResponse.body().toString()).containsSubsequence("<thead>","<tr>","<th>","Visit Date","</th>","<th>","Description","</th>","</tr>","</thead>","<tr>","<td>","2024-10-10", ....

我们先忽略一点:实际的断言(是我写的,不是 petclinic 作者写的)本可以更有表达力、更简洁。问题是:为什么这个测试里的 GET 请求就应当让 George Franklin 出现在 owners 页面上?我们可以试着找出引用的这个 “TEST_OWNER_ID” 是什么。但它只会把我们引向一个顶层声明,没有任何进一步的信息。实际情况是,我把这个类里的代码改差了——因为之前有一些类作用域的初始化代码,它实际上明确说明了每个测试之前初始化了哪些数据。好的一面是,我删掉了很多样板代码。好吧。既然我在对项目做第一批改动时脑子里就有这样的想法,我就把所有测试都改成了使用真实数据库——然后我意识到,其实一个 SQL 文件里已经有一组默认数据了。这是 Spring 替你做的那些魔法般的、难以探索的事情之一。你在测试里根本找不到“为什么这个测试会创建这些数据”的答案。这里有一篇不错的文章讲了这个话题,以及如何显式覆盖它等等,但问题依然成立:一个为了便利而牺牲实际可读性和可探索性的特性。

注意:这个说法并非 Spring 独有,很多工具都有类似的机制,只是文件名稍有不同,或者放在不同的位置。

这不仅是对 Spring Data 常见的批评,也是我在很多 Spring 项目里都遇到过的问题:默认情况下,大多数项目一开始都用 Spring Data。然后,大多数项目(如果不是全部的话)都保留了它。再然后,它们全都让我和我的同事一次又一次地因为数据长什么样、如何组织、如何访问的隐式性而痛苦挣扎。在很多项目里,当实体之间相互引用时,我们不得不发挥创造力来解决 eager/lazy 加载问题。

那么,让我们看看这里是不是只是“技术不够”的问题,并弄清楚是否存在一种更简单的方案。让我们彻底移除 Spring Data,换上一个非常简单的映射库,比如 JDBI。

现在,为了更接近我认为那些测试中的理想方案,我需要把旧代码的某些方面找回来——局部仓库引用,以及向其中添加内容和清空内容的能力。既然目标是替换现有的实现,我就在这里加了一层接口,并为所有现有实体类型创建了独立于 Spring 的仓库类(嗯,几乎独立,PageableImpl 这个类很方便)。

第一个坑是:用过去的好代码本来很简单的一件事——如何彻底禁用现有的持久化并切换到新的内存实现?本可以是 val ownerRepository = InMemoryRepository() 而不是 val ownerRepository = SpringDataOwnerRepository()。但后者并不存在。我们只有一个接口,而实现是由容器创建的,不在我们的控制之中。这里有一篇 StackOverflow 帖子,长篇大论地讲述了项目这个看似简单的改动。现在,当真正的实现被禁用后,测试会抱怨找不到 bean 定义,所以我们必须以某种方式提供新的实现。这里又是一大段关于 Spring 介入时这个话题可以展开的内容——我只需引用上面几行代码里的那一行,来说明理想方案可能是什么样。

此外。还有一个东西,可以在本地配合数据库轻松启动应用,只需一个 main 方法:MysqlTestApplication.java。它位于测试源码中,以便使用 Testcontainers 来运行数据库。当我在这个标注了 @Configuration 的类里覆盖 bean 时,这些定义会影响整个源码集的其余部分——例如,我试着只禁用 Spring Data 相关的东西,并用 @Bean 声明定义我的内存实现,结果我的 OwnerControllerTest 突然因为重复的 bean 定义错误而失败。是的,我技术上知道为什么会这样。但这只是又一个例子,说明本该自然独立运作的东西被不必要地纠缠在一起。再次,让我们把它和原版在简单性和健壮性方面做个比较。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →