【JPA 注解整理】一直在用myBatis,虽然有Generator,但还是觉得写SQL是一件很麻烦的事情。而且从实践来看,我们总是习惯于,直接按照接口所需格式,去编写SQL。这样搞的后端很没有存在感,仿佛就是前端的数据库代理工具而已。加之三层架构,Transaction script式的代码,后端名副其实的搬砖,名副其实的CRUD,何来的业务思考。
我选择JPA,是想换思路。当拿到一个需求时,不是先考虑其数据库该如何设计,而是如何使用代码能够准确表达业务意图,最终再转化为数据库设计。说到底,数据库只是一种存储方案。面对业务时,我们或许应该忽略底层存储如何,配合JPA,我们更能方便选择存储方案,关系型数据库或者是非关系型数据库。并且同时不用去修改DAO层代码。这一点,是myBatis所不能的。
本文没有深入介绍JPA原理,或者是Hibernate原理。只是我这一段时间使用JPA遇到的问题和JPA的解决方式。
一些有趣的配置
enable_lazy_load_no_trans
某次当我使用Springboot的异步任务时( @Async 标记的方法),获取某个实体的children,或者直接使用 JpaRepository 进行操作,程序总是抛出异常,具体是哪个异常我记不清了。大概的意思就是无法从当前session中获取到有效数据库连接,也有可能是当前线程的hibernate session 无效之类的提示吧。解决这个问题也很简单,添加一个配置spring.jpa.properties.hibernate.enable_lazy_load_no_trans=true
default_constraint_mode
默认情况下,JPA创建数据库表,表之间的约束它都会创建一个外键。这其实没错儿,但有时候涉及到表结构变更,或者数据不完整的时候,就很让人烦躁。有没有什么办法可以只建立逻辑外键呢?据说有两种方式
第一种方式
@JoinColumn 注解 foreignKey 设置 ConstraintMode=NO_CONSTRAINT
但是需要每处都显式设置,太麻烦;
b. 第二种方式,全局配置。但好像对JPA版本有要求,最低支持到哪个版本没细究,个人项目Springboot版本是2.4.3spring.jpa.properties.hibernate.hbm2ddl.default_constraint_mode=NO_CONSTRAINT
一些有趣的注解
@LazyCollection
比如我有个订单业务,前端显示的时候需要显示订单所含商品数量。我该怎么办? 两种办法:
直接把所有订单商品查到一个集合中,然后计算集合的size。缺点就是得查一次所有商品;@LazyCollection(LazyCollectionOption.EXTRA)
用这个注解标记在实体关系中Set属性上@Formula("select count(*)")
,这个注解到某个方法上,但是我没有成功;没时间细究,就选择了第二种方式
@DynamicInsert & @DynamicUpdate
@DynamicInsert
属性:设置为true,表示insert对象的时候,生成动态的insert语句,如果这个字段的值是null就不会加入到insert语句中,默认false。比如希望数据库插入日期或时间戳字段时,在对象字段为空定的情况下,表字段能自动填写当前的sysdate。
@DynamicUpdate
属性:设置为true,表示update对象的时候,生成动态的update语句,如果这个字段的值是null就不会被加入到update语句中,默认false。比如只想更新某个属性,但是却把整个属性都更改了,这并不是我们希望的结果,我们希望的结果是:我更改了哪写字段,只要更新我修改的字段就够了。
@Formula
有时候需要计算总价这里的数据,比如某个商品实体,有单价,有数量;但它的总价我并不想存入到数据库中,而是倾向基于单价*数量的方式动态计算。
一种常见的方式是,提供一个getter方法,方法返回计算结果。一种推荐的方式,则是通过@Formula注解实现
private long grossIncome;
private int taxInPercents;
@Formula("grossIncome * taxInPercents / 100")
private long tax;
@Formula 还可以子查询、调用数据库函数、存储过程等。如果我们写JQL,Hibernate能够帮助我们转换成SQL,从而实现定义SQL查询结果。
@Where 如果需要对某个实体全局过滤,比如假设在一个逻辑删除业务背景下,如果只想查询那些被标记为’deleted‘ 的数据,@Where可以全局过滤,标记在Entity Class上即可。如果对于某个OneToMany集合要过滤,也可以使用@Where 标记。但是@Where局限性是,条件是固定的,当需要动态执行条件筛选时,则需要借助@Filter。
@Any & @AnyMetaDef 相对于@ManyToOne、@OneToOne,@Any表示属性对应的类型是任意的,这是从字面的理解。
想想一个场景,假设我有个审批记录,这条审批记录可能来自于A、B、C三个不同的实体,但我又只想用一张表来保存审批记录,同时能够保证每条审批记录能找到其对应的A、或B、或C。 见以下代码
@AnyMetaDef(name = "InOutBoundSourceObjectDef", metaType = "string", idType = "int",
metaValues = {
@MetaValue(value = "https://www.it610.com/article/PURCHASE", targetEntity = A.class),
@MetaValue(value = "https://www.it610.com/article/ALLOCATION", targetEntity = B.class),
@MetaValue(value = "https://www.it610.com/article/OTHER", targetEntity = C.class),
})
@Entity
public class InOutBoundApprove extends BaseEntity {
//对应到数据库,sourceObjectType 存储的值,A、B、C,具体哪个值,取决于sourceObject的类型
@Column(name = "source_object_type", insertable = false, updatable = false)
private String sourceObjectType;
//对应到数据库,存储的是外键id,即A、B、C的id。
//同时要指定Def,是@AnyMetaDef的name
//@metaColumn 指定通过哪个字段来判断sourceObject的class类型
@Any(fetch = FetchType.LAZY, metaDef = "InOutBoundSourceObjectDef", metaColumn = @Column(name = "source_object_type"))
@JoinColumn(name = "source_object_id")
private BaseEntity sourceObject;
// BaseEntity.java
public class BaseEntity {
private Integer id;
//...other properties
}