# 学会这款 [全新技术的 Java 脚手架](https://juejin.cn/post/7410333135119253543) ，从此面试不再怕！ ![Trump-mjga-logo\_cn.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/2bfb26abd3514cb2993f03dec6e9d1de~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ2h1Y2sxc24=:q75.awebp?rk3s=f64ab15b&x-expires=1772590076&x-signature=%2BHdY4PKXlKnBDM9yoOYOj%2FPwneo%3D) ![slogan\_long\_2.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/9d0671bbacf44d7d9389937114f4d46c~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ2h1Y2sxc24=:q75.awebp?rk3s=f64ab15b&x-expires=1772590076&x-signature=m3DZk9bQe%2FL2pMwgQdke2FbLvd4%3D) ## 前言万语俗话说二楼必须修在一楼上面，喝 Java 咖啡必须要配元组蛋糕。今天我们就从数据库查询开始讲起。 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/8b22f5f6b1ac4a58874f0acd1e03a745~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ2h1Y2sxc24=:q75.awebp?rk3s=f64ab15b&x-expires=1772590076&x-signature=LiGaLGR%2BlT%2BWB5cvwag3ClMKlVY%3D) ## `List` 与类型安全 🤔 `userDao.queryByLikeWith()` 是一个数据库查询接口，我们通过这个接口能获得一个 `List` 类型的数据。 > 大家可以想想，有哪些框架的默认行为，会在 dao 查询中返回一个 `List | ` 结构呢？ ```java List userListMap = userDao.queryByLikeWith("someKey"); Long idUser1 = (Long) userListMap.get(0).get("id"); String usernameUser1 = (String) userListMap.get(0).get("username"); Integer ageUser2 = (Integer) userListMap.get(1).get("age"); ``` 这样的查询方式有下面几个问题： 1. userListMap 的长度未知。 2. userMap 的 key 未知。 3. 强制类型转换的类型安全隐患。要解决上面的问题，创建一个 `User Class` 就可以了。 ```java class User { private Long id; private String username; private Integer age; } List userList = userDao.queryUserByLikeWith("someKey"); Integer userAge = userList.get(0).getAge(); Long userId = userList.get(0).getId(); String username = userList.get(1).getUsername(); ``` 虽然 user 的数量还是未知的，但至少 key 变成已知了，我们可以放心大胆的访问想要的属性。像这样的方式我们称为为查询结果封装一个 DTO。 > DTO 是一种数据封装对象，他没有业务逻辑，只承担数据封装的功能。现在我有一个问题，你认为 DTO 可变不可变？可在评论区讨论。有一天新的需求来了。新功能依然需要查询 User 领域相关内容，但需要追加返回 address phone 字段并不再允许返回 id 字段（这是敏感字段）。现在的我们不能再去修改 User 类，因为这会影响既存接口破坏系统稳定性。怎么办呢？好办，再创建一个 `User Dto` 不就行了。 ```java class UserDetail { private String username; private Integer age; private String address; private String phone; } List userList = userDao.queryUserDetailByLikeWith("someKey"); Integer userAge = userList.get(0).getAge(); String username = userList.get(1).getUsername(); String address = userList.get(0).getAddress(); ``` 这样问题就解决了。 ## 时光飞逝 😇 时光飞逝，项目新增功能越来越多，你也创建了更多返回特定字段的 DTO 对象。你可能觉得这很正常——项目越大类文件不就越多吗？很不幸，项目越大类文件越多的定义不包括 DTO 类型的文件。我们有一种专业术语来形容项目中存在过量的 DTO 文件，叫做 **DTO 爆炸**。 ```java class UserDto1 { } class UserDto2 { } class UserDto3 { } class UserDto4 { } class UserDto5 { } ``` 说到这里你可能会问：使用一个 DTO 对象来全量返回所有字段可行吗？这显然不可行，因为以下几个原因： * 敏感字段不可以让别的模块或用户获取。 * 不同权限的调用返回不同的字段。 * 大型系统冗余返回造成的性能开销问题（尤其针对某些 blob 或者 text 字段） ## DTO 爆炸 💥 我们上面说过，DTO 是一种数据传输对象，它不包含业务功能，只用来承载数据。言下之意，这是一种「低价值对象」。但又偏偏要用一个文件来创建。如果你的项目中充数着大量的低价值对象，你就会遇到下面这两个经典问题： * 这个接口应该用哪个 DTO 对象来返回数据？ * 这个接口的 DTO 对象应该如何命名？编程 10 分钟，命名就花了 8 分钟。除了老板大家都笑了。 ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/516c82ca295c4f82b36e0a14b09be37a~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ2h1Y2sxc24=:q75.awebp?rk3s=f64ab15b&x-expires=1772590076&x-signature=%2B9c11o4nwmYxweNbUwT8ftbEf9I%3D) 说了这么多，能不能不创建 DTO 呢？之前提到的 `List` 似乎能承担这个功能，但又有致命缺点：它是类型不安全的。那给 Map 加上泛型行不行呢？ ```java // 我们期待 queryByLikeWith 返回两个字段：username 和 age 的值。 List> userListMap = userDao.queryByLikeWith("someKey"); // 通过 String usernameUser1 = userListMap.get(0).get("username"); // 报错 Integer ageUser2 = userListMap.get(1).get("age"); ``` ageUser2 字段报错了。因为从数据库中查询出的字段类型可能有多种，但泛型表示的类型是固定的。那有没有一种数据类型，可以表示多种不同的类型呢？有的，这就是元组。 ## 元组 🎯 元祖是一种数据结构，他看起来就像是数组，但他的长度和元素的类型是固定的。 ```typescript let ourTuple: [number, boolean, string]; ourTuple = [5, false, 'Coding God was here']; ``` 上面的 ourTuple 就是一个元组。他包含且三个元素且元素类型和顺序必须是 `number boolean string`。尝试给它赋值其他类型的数据会报错： ```typescript // initialized incorrectly which throws an error ourTuple = [false, 'Coding God was mistaken', 5]; ``` 获取这个元组中的元素的方式和数组一样，都是通过索引来获取： ```typescript let ourTuple: [number, boolean, string]; ourTuple = [5, false, 'Coding God was here']; let firstElement: number = ourTuple[0]; let secondElement: boolean = ourTuple[1]; let thirdElement: string = ourTuple[2]; ``` 试想，如果把数据库中查询出的字段封装到一个元组上面，是不是就可以节省了创建 DTO 的开销了呢？说不如做，让我们试试看。 ## JOOQ 中的元组支持 💫 由于 Java 没有原生的元组类型，所以我们使用 JOOQ 这个库为我们封装的元组对象。这个对象曾经在我们的[之前的文章](https://juejin.cn/post/7437023118151450639)中提到过，它叫做 `Record` ![image.png](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/6f91ea6d5a4c418daf18f02298d97130~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ2h1Y2sxc24=:q75.awebp?rk3s=f64ab15b&x-expires=1772590076&x-signature=f50cO5Ws4lb5LGF5fD1izMxN6GQ%3D) 下面的代码中，`getUserTuple` 方法返回了 `Record2` 这个对象……等等，为什么是 `Record2`？这样的命名方式很少见！这里的 2 表示的是元组中有两个元素——回顾上面的内容，明确表示集合中元素的数量，是元组的职责范围之一。 ```java void createOrderAndNotifyAdmin() { Record2 testUserA = getUserTuple(); String username = testUserA.value1(); Long userId = testUserA.value2(); orderService.createOrderBy(userId); notifyService.notifyAdminBy(username); } private Record2 getUserTuple() { return dsl.select(USER.USERNAME, USER.ID).from(USER).where(USER.USERNAME.eq("uniqueUserName")).fetchOne(); } ``` 那既然这样是不是还有 `Record3` 呢？当然有，`Record1..22` JOOQ 提供了这样长度的预定义元组对象供你使用，你想用哪个就用哪个。 ```java private Record3 getUserByUserNameEq(String username) { return dsl.select(USER.USERNAME, USER.ID, USER.PASSWORD).from(USER).where(USER.USERNAME.eq(username)).fetchOne(); } ``` 由于这次你查询了两个字段，所以使用 `Record2` 来表示这次的查询结果。再通过 `testUserA.value1() testUserA.value2()` 就能通过类型安全的方式访问到对应的值，然后传递给需要的业务方法。 **附上 Record 类型的结构设计** ```java public interface Record extends Fields, Attachable, Comparable, Formattable { @NotNull Row valuesRow(); } public interface Record2 extends Record { @NotNull Field field1(); @NotNull Field field2(); } final class RecordImpl2 extends AbstractRecord implements InternalRecord, Record2 { RecordImpl2(AbstractRow row) { super(row); } @Override public RowImpl2 fieldsRow() { return new RowImpl2(field1(), field2()); } ``` 讲到这里你应该能明白 JOOQ 中 `Record` 对象的大体设计思路了吧？为什么 JOOQ 不直接返回一个 `Map` 来表示查询结果而是专门设计了 `Record..N`这样的类型？因为 JOOQ 希望利用提前设计的 `Record` 类型，尽可能在框架层面确保开发者在 CRUD 的过程中随时都获得**类型安全**的保护；尽量减少开发者为了**编译时安全**这个重要特性去做的手工操作（比如创建一个 DTO）；也一定程度上避免了 **DTO 爆炸**所带来的隐患。 ## 还有更多吗❓ 到这里你可能还有一些疑问，比如： 1. 有没有可运行的代码示例？ 2. 元组看起来不错，但相比 `Map` 看起来元组失去了通过 key 来访问 value 的特性。 3. 还有没有更多的场景能够利用元组来进一步降低 DTO 爆炸的风险？ 4. JOOQ 的 Record 还有没有更多的杀手锏功能？关于代码示例，我做了一个开箱即用的仓库供大家取用如果你不要忘记给它一个 Star，便可得好运相随。剩下的问题，如果大家的 Star 给力，我就在后面的章节中一一为大家解答。 ## 写在最后 * 我是 Chuck1sn，一个长期致力于现代 Jvm 生态推广的开发者。 * 您的回帖、点赞、收藏、就是我持续更新的动力。 * 关注我的账号，第一时间收到文章推送。