Java/Kotlin双语革命性ORM框架Jimmer（一）——介绍与简单使用

devtools/2025/2/8 17:24:07/

概览

Jimmer是一个Java/Kotlin双语框架

  • 包含一个革命性的ORM

  • 以此ORM为基础打造了一套综合性方案解决方案，包括

    • DTO语言

    • 更全面更强大的缓存机制，以及高度自动化的缓存一致性

    • 更强大客户端文档和代码生成能力，包括Jimmer独创的远程异常

    • 快速创建GraphQL服务

    • 跨越微服务的远程实体关联

ORM部分

当前技术生态下，访问关系型数据库技术体系存在很大缺陷，请看下图。
在这里插入图片描述

1. 以JPA为代表的静态语言ORM

优点

便捷，代码安全(本身基于强类型语言，大部分代码是安全的。如果结合QueryDSL使用，则可以保证所有代码都是安全的)

缺点

缺乏灵活性

即使JPA从2.1开始支持EntityGraph，控制被查询数据格式的灵活性仍然非常有限。该方案粒度仍然太粗，控制能力远没GraphQL这类技术的细腻。

保存对象时，细节行为受普通属性的insertable、updateable和关联属性的cascade配置的控制，这类配置在实体类型中被硬编码固化，被保存的数据结构的格式是固定的，没有灵活性。

如果要发挥ORM的优势，就必须查询对象的大部分非关联属性 (少数@Basic(fetch = FetchType.Lazy)属性除外，它们多为lob设计)；如果只想查询一部分属性，就必须放弃对象查询，转而使用这些属性的多列查询，丧失ORM本该有的便捷性和核心价值。

3. 以为ActiveRecord (Ruby) 为代表的动态语言ORM

优点

基于动态语言的ORM，只需将动态语言对象结构的灵活性和ORM的实现结合起来，就能兼顾便捷和灵活。

缺点

动态语言虽然既便捷又灵活，但是代码缺乏可维护性且不利于多人协同开发是众所周知的缺点。

现代软件往往是复杂的，需要团队协作来完成，是否利于团队成员之间协同，远比个人对编程的认知重要。

这里，不想过多地讨论动静之争，但是有一点需要指出：既然选择了静态语言Java/Kotlin，就应该以静态语言的方式使用它， 而不能使用以jFinal为代表的将静态语言当成动态语言用的方案，更不能在应用中频繁地使用java.util.Map来代替数据对象。 这类做法违背了选择Java/Kotlin的初衷，如果一定要怎么做，为什么不直接选动态语言呢？

4. 以MyBatis为代表的轻量级SQL Builder/Mapper

优点

直接编写SQL，随意且灵活；本身是强类型框架，具有代码安全性 (MyBatis生态也有强类型SQL DSL扩展，可以解决原生SQL字符串导致的代码不安全问题)

缺点

便捷性的严重缺失，重复劳动量极大。

MyBatis没有统一实体的概念，而是面对具体业务场景DTO，实现ResultSet和这些DTO的映射。由于业务场景多，各DTO类型之间相似却不同，冗余度很高，导致重复劳动量极高。

除了以孤单对象为载体的CRUD外，对多个对象彼此关联而成的复杂数据结构的支持较弱，缺乏必要抽象，导致太多繁重的低级任务被推卸给开发人员 (不少开发人员长期被这类繁重的任务所累，但自己一直没察觉)。

原生SQL真的是最好方案吗？
这个派别最引以为豪的观点是：“直接书写SQL会带来更直接的控制力，这种直接控制力优于任何ORM”。在这个领域长期的技术停滞中，不少开发人员对此深信不疑。

根本原因

上文中，我们阐述了关系型数据库领域的三种常见方案，但无论如何选择，我们都无法兼顾便捷性、灵活性和代码安全性。为什么会导致这样呢？

就JVM生态而言，POJO是导致这个问题的根本原因。

POJO*(也可以叫结构体)*缺乏必要的灵活性和表达力，却几乎被所有的JVM框架作为数据模型和核心，严重限制了JVM生态的技术创新。

因此，在Jimmer中，ORM实体对象并非POJO。而是另外一种独特的万能数据对象*(后文会介绍)*，这种独特的实体对象撑起了Jimmer所有上层重大的变革，是整个框架的基石。

事实上，Jimmer实体对象不仅可以应用在ORM领域，它几乎可以用在任何以结构化数据维护为目的的场景，并提升各种技术栈的表达力。

目前，Jimmer实体仅在关系型数据库访问领域发挥出作用，只是因为精力不够所致。

完整的功能

在本文开头我们提到了，革命性的ORM只是Jimmer的一部分，Jimmer实际的能力范围早已超越了一个ORM。

现在，我们给出Jimmer的功能示意图，并逐个讲解
在这里插入图片描述

Business Model

在信息类系统中，存在两种对象。

实体：实体对象是全局统一的，对象之间的存在丰富彼此关联。

实体对象往往和数据库非常接近，具备极高的稳定性。

DTO：针对特定业务的输入/输出对象，通常是从全局实体关系网上撕下来的一个局部碎片，该碎片的大小和形状非常灵活。

DTO类型数量庞大，每一个业务接口对DTO对象的格式都有独特的需求，彼此可能相似但又不同，具备明显的。而且易受到需求变化的影响，不稳定。

Entity类型是全局统一数据存储模型，不易被需求变更影响，相对稳定，被视为高价值类型。

DTO类型作为每个业务输入/输出，相对随意，容易因需求变动而不稳定，被视为低价值类型。

Jimmer主张开发人员把精力集中在高价值的实体模式的设计上；对于低价值的DTO类型，有的时候并不需要，有的时候需要。
即使需要，也可以用极其廉价的方式自动生成。因此，基于Jimmer构建的项目具备优秀的抗需求变动的能力。

Jimmer Entity

Jimmer实体定义和JPA实体很接近。

之前讨论过，Jimmer实体并非POJO，所以，被声明为interface，而非class。

那么，谁负责实现此接口呢？是上图中的Jimmer Precompiler (对于Java而言，就是APT； 对于Kotlin而言，就是KSP)

Jimmer实体支持两个重要特征，动态性和不可变性

动态性

Jimmer对象在静态语言和动态语言之间寻求最佳平衡，把二者的优点结合起来：

  • 静态语言数据对象具有高性能、拼写安全、类型安全、甚至空安全*(如果使用Kotlin的话)*的优点，Jimmer实体吸收了这些优点。
  • 动态语言数据对象具有高度的灵活性，Jimmer实体吸收了这个优点，每个属性都可以缺失*(但是不能如同动态语言一样增加属性，因为这必然会破坏静态语言的特性，Jimmer也不需要此能力)*

对Jimmer而言，对象缺少某个属性 (其值未知) 和 对象的某个属性为null (其值已知) 是完全不同的两回事。

这种平衡设计，可以在享受静态语言好处的同时，为数据结构赋予。

这种绝对的灵活性，既可用于表达查询业务的输出格式，也可用于表达保存业务的输入格式。

这导致Jimmer拥有了崭新的定位：一个为任意形状数据结构设计的ORM。其所有功能都是为了操作任意形状的数据结构，而非一个个简单的实体对象。

不可变性

Jimmer对象是不可变对象。不可变对象的好处是多方面的

Jimmer选择不可变对象是为了让数据结构绝不包含循环引用。

这可以保证由Jimmer实体及彼此关联组合而成的数据结构一定能够被直接Jackson序列化，并不需要使用诡异的序列化技巧为JSON植入任何特殊的额外信息，任何编程语言都可以轻松理解。

然而，不可变对象也存在缺点。比如，现有一个很深的数据结构，那么基于它按照一些修改的愿望创建出新的数据结构会很困难，难度随着深度的变大急剧增加。

ORM和很深的数据结构打交道，而Java的record和Kotlin的data class不适合处理很深数据结构。

既对Java和Kotlin进行双语支持，又善于基于现有深层次数据结构按照一些修改的愿望创建出新的不可变数据结构的方案，目前的JVM生态没有。

幸运的是，JavaScript/TypeScript领域存在一个足够强大的方案: immer，可以完美解决这个问题。该方案工作方式如下

基于现有不可变数据结构开启一个临时作用域。

在这个作用域内，开发人员可得到一个draft数据结构，该数据结构的形状和初始值和原数据结构完全一致，且可以被随意修改，包括修改任意深的子对象。

作用域结束后，draft数据结构会利用收集到的修改行为创建另外一个新的数据结构。其中，未被修改的局部会被优化处理，复用以前的旧对象。

Immer完美结合了不可变对象和可变对象的优点，代码简单、功能强大、性能卓越。因此，Jimmer选择为JVM生态移植了immer，项目名称也是对其致敬。

Generated DTO Type

前文谈到，Jimmer实体在静态语言数据对象和动态语言数据对象之间寻找最佳平衡，其中动态性带来了极大的灵活性，并以此决定了整个框架的定位。

Jimmer对象允许某些属性缺失，对象缺少某个属性 (其值未知) 和 对象的某个属性为null (其值已知) 是完全不同的两回事。

  • 对于Jackson序列化而言，缺失的属性会被自动忽略，就如同我们之前展示的那样。

    如果服务端自己并不使用查询得到的实体对象，而是直接写入到Http Response中。对于这种情况，无需DTO，直接使用实体对象很方便。

  • 如果直接用Java/Kotlin代码访问不存在的属性，会导致异常。

这并非由Jimmer制造的新问题，而是一个在静态语言ORM生态中早已存在和被接受的问题。然而，不可否认这的确对静态语言的安全性形成了破坏。

如果要追求100%的静态语言安全性，使用DTO对象是唯一的方法。然而，目前JVM生态的DTO映射技术存在很大缺陷。

  • 要么显式地映射属性*(例如纯手工映射和转化)*，这种做法工作量巨大，枯燥且容易出错。
  • 要么隐式地映射属性*(例如采用BeanUtils技术)*，这种做法会引入新的不安全问题，即，无法在编译发现的问题。

即使你使用强大的mapstruct，你所能做的也只是在这两个极端之间作出选择而已。

因此，Jimmer提供了DTO语言，用户使用该语言编写非常简单的代码，编译项目即可自动生成各种丰富的DTO类型定义。

DTO语言的设计目的，在于

让生成DTO类型的过程足够简单，从而让DTO类型足够廉价。

100%符合静态语言安全性，在编译时发现所有问题并报错。

理论概念先到这里

简单使用

我们做一个简单的查询demo，创建Springboot项目

引入依赖

java"><dependency><groupId>org.babyfish.jimmer</groupId><artifactId>jimmer-spring-boot-starter</artifactId><version>0.8.51</version></dependency>

编写Model

用户

java">@Entity
@Table(name = "User")
public interface User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)int id();String name();@NullableInteger age();@OneToMany(mappedBy = "user")List<UserDetail> details();
}

用户详情，一对多

java">@Entity
@Table(name = "user_detail")
public interface UserDetail {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)int id();@Key // 自己的核心数据自然就是第二个业务键String detail();@Key // 父级自然是一个业务键@OnDissociate(DissociateAction.DELETE) // 如果脱钩了，就把自身删除@ManyToOne@JoinColumn(name = "user_id",foreignKeyType = ForeignKeyType.FAKE)@NullableUser user();@IdView("user")Integer userId();}

配置数据库链接

applicantion.yml

java">spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://myhost:3306/my_jimmerusername: rootpassword: rootjimmer:dialect: org.babyfish.jimmer.sql.dialect.MySqlDialectshow-sql: onpretty-sql: truedatabase-validation:schema: my_jimmer

构建

Maven build

查询

java">@RestController
@RequestMapping("/test")
public class TestController {@Autowiredprivate JSqlClient sqlClient;@RequestMapping("/user")public List<User> find(@RequestBody UserSpecification specification){UserTable userTable = UserTable.$;return sqlClient.createQuery(userTable).select(userTable).execute();}
}

超级查询

使用specification，可以提供灵活的复杂查询

定义dto

java">export com.example.myjimmer.entity.User-> package com.example.myjimmer.dto/*UserView {#allScalars(User)details {#allScalars(UserDetail)}
}*/specification UserSpecification {eq(name) as namelike(name) as likename
}

构建

Maven build

使用specification查询

java">@RestController
@RequestMapping("/test")
public class TestController {@Autowiredprivate JSqlClient sqlClient;@RequestMapping("/user")public List<User> find(@RequestBody UserSpecification specification){UserTable userTable = UserTable.$;return sqlClient.createQuery(userTable).where(specification).select(userTable).execute();}
}

http://www.ppmy.cn/devtools/157137.html

相关文章

尚硅谷spring框架视频教程——学习笔记二（数据库、事务、webflux）

尚硅谷spring框架视频教程——学习笔记二（数据库、事务、webflux）

目录 一、数据库操作二、事务操作1. 事务的四个特性2. 事务的底层逻辑3. 注意事项4. 启动事务操作5. 事务传播行为&#xff08;propagation&#xff09;6. 事务隔离级别7. 其他配置 三、Spring5新功能——webflux 一、数据库操作 spring框架使用JDBCTemplate对JDBC&#xff08…
阅读更多...
华为支付-免密支付接入免密代扣说明

华为支付-免密支付接入免密代扣说明

免密代扣包括支付并签约以及签约代扣场景。 开发者接入免密支付前需先申请开通签约代扣产品&#xff08;即申请配置免密代扣模板及协议模板ID&#xff09;。 华为支付以模板维度管理每一个代扣扣费服务&#xff0c;主要组成要素如下&#xff1a; 接入免密支付需注意&#x…
阅读更多...
SQL条件分支中的大讲究

SQL条件分支中的大讲究

在SQL中&#xff0c;条件分支用于根据不同的条件执行不同的操作&#xff0c;适用于数据查询、数据更新以及存储过程等场景。合理使用SQL条件分支&#xff0c;可以优化数据操作流程&#xff0c;提高代码的可读性和可维护性。 目录 1. 逻辑判断的基本概念 2. CASE 语句&#xf…
阅读更多...
Visual Studio（VS）没有显示垂直滚轮or垂直滚轮异常显示

Visual Studio（VS）没有显示垂直滚轮or垂直滚轮异常显示

前言&#xff1a; 前段时间&#xff0c;我换上了新电脑。满心欢喜地安装好 VS&#xff0c;准备大干一场时&#xff0c;却发现了一个小麻烦 —— 垂直滚轮显示异常&#xff08;如图 1&#xff09;。这种显示方式实在让我难以适应&#xff0c;每一次操作都觉得别扭。 于是&#…
阅读更多...
Redis进阶

Redis进阶

Redis持久化&#xff1a; 前面我们讲到mysql事务有四个比较核心的特性&#xff1a; 原子性&#xff1a;保证多个操作打包成一个。一致性&#xff1a;A给B100&#xff0c;A少一百&#xff0c;B必须多一百。持久性&#xff1a;针对事务操作必须要持久生效&#xff0c;不管是重启…
阅读更多...
【算法篇】贪心算法

【算法篇】贪心算法

目录 贪心算法 贪心算法实际应用 一&#xff0c;零钱找回问题 二&#xff0c;活动选择问题 三&#xff0c;分数背包问题 将数组和减半的最小操作次数 最大数 贪心算法 贪心算法&#xff0c;是一种在每一步选择中都采取当前状态下的最优策略&#xff0c;期望得到全局最优…
阅读更多...
Java项目: 基于SpringBoot+mybatis+maven+mysql实现的装饰工程管理系统(含源码+数据库+毕业论文)

Java项目: 基于SpringBoot+mybatis+maven+mysql实现的装饰工程管理系统(含源码+数据库+毕业论文)

一、项目简介 本项目是一套基于SpringBootmybatismavenmysql实现的装饰工程管理系统 包含&#xff1a;项目源码、数据库脚本等&#xff0c;该项目附带全部源码可作为毕设使用。 项目都经过严格调试&#xff0c;eclipse或者idea 确保可以运行&#xff01; 该系统功能完善、界面…
阅读更多...
三维粒子滤波（Particle Filter）MATLAB例程，估计三维空间中匀速运动目标的位置（x, y, z），提供下载链接

三维粒子滤波（Particle Filter）MATLAB例程，估计三维空间中匀速运动目标的位置（x, y, z），提供下载链接

三维粒子滤波（Particle Filter）MATLAB例程，估计三维空间中匀速运动目标的位置（x, y, z） 文章目录 介绍功能运行结果代码介绍 本 MATLAB 代码实现了三维粒子滤波（ P a r t i c l e F i l t e
阅读更多...
最新文章

Copyright @ 2022~2023