蓝凌EKP产品:Hibernate懒加载检测与开发助手
本系列文章将分篇展开《EKP 性能开发最佳实践》中的重要技术点,帮助开发者快速了解和实施EKP性能优化方案。本章讲 Hibernate懒加载检测与开发助手。
在使用 Hibernate 管理对象时,默认的懒加载(lazy loading)行为虽然提高了初始化性能,但在实际开发中却容易引发 N+1 查询、空指针异常等问题。为此,EKP 提供了 HibernateUtil 工具类,辅助判断和调试集合或属性是否已经初始化,从而让懒加载的控制更加清晰。
一、问题产生的原因
当使用 Hibernate 的懒加载(Lazy Loading)机制时,如果在主查询中获取了多个实体,而每个实体又关联其他实体,当访问这些关联实体时,Hibernate 会触发额外的 SQL 查询。例如:
// 主查询:获取所有订单
List<Order> orders = session.createQuery("FROM Order", Order.class).list();// 遍历订单并访问每个订单的用户(触发 N 次查询)
for (Order order : orders) {User user = order.getUser(); // 每次访问都会触发一次 SQL 查询System.out.println("Order: " + order.getId() + ", User: " + user.getName());
}
这里主查询获取了 N 个订单,然后在遍历订单时,每个订单的用户信息都需要单独查询,导致总共执行了 1+N 次查询。
二、关键方法说明
1. 判断集合是否已加载
public static boolean wasInitialed(Collection collection){boolean wasInitialed = false;if(collection instanceof AbstractPersistentCollection){wasInitialed = AbstractPersistentCollection.class.cast(collection).wasInitialized();}else{wasInitialed = true;}return wasInitialed;}
2. 判断集合是否已加载使用场景
// 先判断是否已经加载过,如果传入的参数已经是加载过的,那就直接用(既原来的checkUserModels)
// 否则采用绕过的hibernate的方式处理
if(HibernateUtil.wasInitialed(elements)){return checkUserModels(elements);
}//下面逻辑是采取绕过去方式判断逻辑
boolean hasData = authField.hasData(modelId, modelName);
if(!hasData){return false;
}
boolean contains = false;
// 内部人员在判断权限时,加上everyone
List orgIds = getKMSSUser().getUserAuthInfo().getAuthOrgIds();
if (!BooleanUtils.isTrue(getKMSSUser().getFdIsExternal())) {orgIds.add(SysOrgConstant.ORG_PERSON_EVERYONE_ID);
}
contains = authField.contains(modelId, modelName, orgIds);//涉及elements的循环,如果集合已经加载过,这里就不会触发N+1操作。
public static boolean checkUserModels(List<?> elements) {if (CollectionUtils.isEmpty(elements)) {return false;}List<String> ids = new ArrayList<String>();for (int i = 0; i < elements.size(); i++) {ids.add(((ISysOrgElement) elements.get(i)).getFdId());}// 内部人员在判断权限时,加上everyoneList orgIds = getKMSSUser().getUserAuthInfo().getAuthOrgIds();if (!BooleanUtils.isTrue(getKMSSUser().getFdIsExternal())) {orgIds.add(SysOrgConstant.ORG_PERSON_EVERYONE_ID);}return ArrayUtil.isListIntersect(ids, orgIds);
}
4. 判断对象属性是否已加载
/*** 判断model的某个属性是否被加载* @param model* @param propertyName* @return*/public static boolean isPropertyInitialed(Object model,String propertyName){return Hibernate.isPropertyInitialized(model,propertyName);}
5. 判断对象属性是否已加载
用于检测某个对象的具体属性是否已加载:
if (HibernateUtil.isPropertyInitialed(model, "docCreator")) {// docCreator 已加载直接使用docCreator的逻辑,不会产生查询
}// docCreator 未加载,使用绕过去逻辑,否则每次去拿docCreator,都会产生一次查询。
三、SQL调试工具
1. 输出SQL并打印栈信息
runSqlWithDebugger(sql, "日志信息", ps -> ps.executeQuery(), preparedStatement);
可用于包裹原生SQL执行过程,在 Hibernate 设置为 debug 时自动输出 SQL 和调用堆栈,便于排查性能瓶颈。
2. 输出完整SQL执行信息
showSqlAndStack(statement, cost, desc);
可手动输出当前 SQL 的执行耗时及调用来源。
四、实际应用场景
- 调试N+1问题:通过判断属性是否初始化来避免在循环中无意触发多次数据库查询。
- 性能诊断:借助 SQL 调试器快速定位慢查询及其调用堆栈。
- 防御性编码:避免未初始化对象引起的 LazyInitializationException。
通过以上方法,开发者可以更灵活、清晰地控制和调试 Hibernate 的懒加载行为,进一步减少隐藏的性能问题。