orm扩展包使用技巧

[!IMPORTANT] 1、组件本身提供常见并且基础的api，如果满足不了需求，可以使用orm自身的api

1、mybatis-plus

获取组件中的mapper，使用mybaits-plus的自带方法

// 第一种方式
@Resource
private FlowTaskMapper taskMapper;

// 第二种方式
FlowTaskMapper taskMapper = FrameInvoker.getBean(FlowTaskMapper.class);

2、JPA

注入 unitName=warm-flow-jpa EntityManager entityManager 对象

@PersistenceContext(unitName = "warm-flow-jpa")
protected EntityManager entityManager;

通过上述注解获取工作流组件内各Entity访问能力

<persistence-unit name="warm-flow-jpa" transaction-type="RESOURCE_LOCAL">
    <class>org.dromara.warm.flow.orm.entity.FlowDefinition</class>
    <class>org.dromara.warm.flow.orm.entity.FlowHisTask</class>
    <class>org.dromara.warm.flow.orm.entity.FlowInstance</class>
    <class>org.dromara.warm.flow.orm.entity.FlowNode</class>
    <class>org.dromara.warm.flow.orm.entity.FlowSkip</class>
    <class>org.dromara.warm.flow.orm.entity.FlowTask</class>
    <class>org.dromara.warm.flow.orm.entity.FlowUser</class>
</persistence-unit>

以下为主要接口示例，更多接口请参考 EntityManager 接口

@PersistenceContext(unitName = "warm-flow-jpa")
protected EntityManager entityManager;

FlowDefinition entity = dao.newEntity();
// entity 字段填充
// 持久化保存数据
entityManager.persist(entity); 

// 通过主键查找数据
FlowDefinition existEntity = entityManager.find(FlowDefinition.class, 1l);

// 复杂查询语句通过 CriteriaQuery<T> criteriaQuery 
CriteriaQuery<T> criteriaQuery = ...
// select语句获取结果
entityManager.createQuery(criteriaQuery).getResultList();

// 更新操作使用 CriteriaUpdate<T> criteriaUpdate 
CriteriaUpdate<T> criteriaUpdate = ...
entityManager.createQuery(criteriaUpdate).executeUpdate()

JPA注意事项 JPA涉及持久化操作必须开启事务 @Transactional(spring) @Tran(solon)

3、mybatis-flex

获取组件中的mapper，使用mybaits-flex的自带方法

// 第一种方式
@Resource
private FlowTaskMapper taskMapper;

// 第二种方式
FlowDefinitionMapper definitionMapper = FrameInvoker.getBean(FlowDefinitionMapper.class);