Package com.bytedesk.ticket.process

Class ProcessRestService

java.lang.Object

com.bytedesk.core.base.BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

com.bytedesk.ticket.process.ProcessRestService

@Service
public class ProcessRestService
extends BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

Field Summary

Fields

Modifier and Type	Field	Description
private final AuthService	authService
private final org.modelmapper.ModelMapper	modelMapper
private final ProcessRepository	processRepository
private final org.flowable.engine.RepositoryService	repositoryService
private final org.springframework.core.io.ResourceLoader	resourceLoader
private final UidUtils	uidUtils

Constructor Summary

Constructors

Constructor	Description
ProcessRestService()

Method Summary

Modifier and Type	Method	Description
private ProcessRequest	buildDefaultProcessRequest(String uid, String orgUid, String schema, ProcessTypeEnum type, String processName)
private ProcessDefinitionResponse	buildProcessDefinitionResponse(org.flowable.engine.repository.ProcessDefinition processDefinition)
ProcessResponse	convertToResponse(ProcessEntity entity)
ProcessResponse	create(ProcessRequest request)
protected org.springframework.data.jpa.domain.Specification<ProcessEntity>	createSpecification(ProcessRequest request)	创建Specification对象，子类必须实现 用于queryByOrg的通用实现
void	delete(ProcessRequest request)
void	deleteByUid(String uid)
ProcessDefinitionResponse	deployProcess(String processUid)	部署流程 - 用户手动触发（不检查已存在部署，会创建新版本）
ProcessDefinitionResponse	deployProcess(String processUid, boolean checkExisting)	部署流程 - 统一部署入口，供 ProcessService 和内部初始化使用 使用 ProcessEntity 中存储的 schema 进行部署
private void	deployProcessByType(String orgUid, String processUid, String processPath)	初始化部署流程（从模板文件加载） 直接使用 processUid 作为 deploymentName，确保唯一性
protected ProcessEntity	doSave(ProcessEntity entity)	子类实现具体的保存逻辑
protected org.springframework.data.domain.Page<ProcessEntity>	executePageQuery(org.springframework.data.jpa.domain.Specification<ProcessEntity> specification, org.springframework.data.domain.Pageable pageable)	执行分页查询，子类必须实现 用于queryByOrg的通用实现
Optional<ProcessEntity>	findByUid(String uid)
ProcessEntity	handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e, ProcessEntity entity)
private void	initItSupportProcess(String orgUid)	初始化IT支持流程
private void	initLeaveApprovalProcess(String orgUid)	初始化请假审批流程
void	initProcess(String orgUid)
void	initProcessDemos(String orgUid)	初始化演示流程模板 用于展示工单系统的流程能力
private void	initReimbursementApprovalProcess(String orgUid)	初始化报销审批流程
void	initThreadProcess(String orgUid)
private String	loadDefaultProcessSchema()
private String	loadDefaultThreadProcessSchema()
private String	loadDemoProcessSchema(String processPath)	加载演示流程模板文件
private void	markProcessAsDeployed(String processUid, String deploymentId)
org.springframework.data.domain.Page<ProcessResponse>	queryByOrg(ProcessRequest request)	通用的queryByOrg实现 子类如果有特殊逻辑可以重写此方法
org.springframework.data.domain.Page<ProcessResponse>	queryByUser(ProcessRequest request)	通用的queryByUser实现 子类如果有特殊逻辑可以重写此方法
List<ProcessDefinitionResponse>	queryDeployedProcessDefinitions(ProcessRequest request)	查询已部署的流程定义列表（Flowable ProcessDefinition）
ProcessResponse	resetProcess(ProcessRequest request)	重置流程为默认初始化内容
private String	rewriteBpmnProcessId(String bpmnXml, String originalProcessKey, String newProcessKey)
List<ProcessDefinitionResponse>	undeployProcess(String processUid)	取消部署流程
ProcessResponse	update(ProcessRequest request)

Methods inherited from class com.bytedesk.core.base.BaseRestService

deleteByOrgUid, findByOrgUid, getUidFromRequest, queryByUid, recover, save, setUserUidToRequest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

processRepository

private final ProcessRepository processRepository

modelMapper

private final org.modelmapper.ModelMapper modelMapper

uidUtils

private final UidUtils uidUtils

authService

private final AuthService authService

repositoryService

private final org.flowable.engine.RepositoryService repositoryService

resourceLoader

private final org.springframework.core.io.ResourceLoader resourceLoader

Constructor Details

ProcessRestService

public ProcessRestService()

Method Details

queryByOrg

public org.springframework.data.domain.Page<ProcessResponse> queryByOrg(ProcessRequest request)

Description copied from class: BaseRestService

通用的queryByOrg实现 子类如果有特殊逻辑可以重写此方法

Overrides:

queryByOrg in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

queryByUser

public org.springframework.data.domain.Page<ProcessResponse> queryByUser(ProcessRequest request)

Description copied from class: BaseRestService

通用的queryByUser实现 子类如果有特殊逻辑可以重写此方法

Overrides:

queryByUser in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

findByUid

@Cacheable(value="process",
           key="#uid",
           unless="#result==null")
public Optional<ProcessEntity> findByUid(String uid)

Specified by:

findByUid in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

create

public ProcessResponse create(ProcessRequest request)

Specified by:

create in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

update

public ProcessResponse update(ProcessRequest request)

Specified by:

update in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

doSave

protected ProcessEntity doSave(ProcessEntity entity)

Description copied from class: BaseRestService

子类实现具体的保存逻辑

Specified by:

doSave in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

handleOptimisticLockingFailureException

public ProcessEntity handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e,
 ProcessEntity entity)

Specified by:

handleOptimisticLockingFailureException in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

deleteByUid

public void deleteByUid(String uid)

Specified by:

deleteByUid in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

delete

public void delete(ProcessRequest request)

Specified by:

delete in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

createSpecification

protected org.springframework.data.jpa.domain.Specification<ProcessEntity> createSpecification(ProcessRequest request)

Description copied from class: BaseRestService

创建Specification对象，子类必须实现 用于queryByOrg的通用实现

Specified by:

createSpecification in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

executePageQuery

protected org.springframework.data.domain.Page<ProcessEntity> executePageQuery(org.springframework.data.jpa.domain.Specification<ProcessEntity> specification,
 org.springframework.data.domain.Pageable pageable)

Description copied from class: BaseRestService

执行分页查询，子类必须实现 用于queryByOrg的通用实现

Specified by:

executePageQuery in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

convertToResponse

public ProcessResponse convertToResponse(ProcessEntity entity)

Specified by:

convertToResponse in class BaseRestService<ProcessEntity,ProcessRequest,ProcessResponse>

initProcess

public void initProcess(String orgUid)

initThreadProcess

public void initThreadProcess(String orgUid)

deployProcessByType

private void deployProcessByType(String orgUid,
 String processUid,
 String processPath)
                          throws IOException

初始化部署流程（从模板文件加载） 直接使用 processUid 作为 deploymentName，确保唯一性

Throws:

IOException

rewriteBpmnProcessId

private String rewriteBpmnProcessId(String bpmnXml,
 String originalProcessKey,
 String newProcessKey)

loadDefaultThreadProcessSchema

private String loadDefaultThreadProcessSchema()
                                       throws IOException

Throws:

IOException

buildDefaultProcessRequest

private ProcessRequest buildDefaultProcessRequest(String uid,
 String orgUid,
 String schema,
 ProcessTypeEnum type,
 String processName)

markProcessAsDeployed

private void markProcessAsDeployed(String processUid,
 String deploymentId)

deployProcess

public ProcessDefinitionResponse deployProcess(String processUid,
 boolean checkExisting)

部署流程 - 统一部署入口，供 ProcessService 和内部初始化使用 使用 ProcessEntity 中存储的 schema 进行部署

Parameters:

processUid - 流程定义 UID

checkExisting - 是否检查已存在的部署（true: 初始化场景，false: 用户手动部署）

Returns:

ProcessDefinitionResponse 部署结果

deployProcess

public ProcessDefinitionResponse deployProcess(String processUid)

部署流程 - 用户手动触发（不检查已存在部署，会创建新版本）

queryDeployedProcessDefinitions

public List<ProcessDefinitionResponse> queryDeployedProcessDefinitions(ProcessRequest request)

查询已部署的流程定义列表（Flowable ProcessDefinition）

undeployProcess

public List<ProcessDefinitionResponse> undeployProcess(String processUid)

取消部署流程

buildProcessDefinitionResponse

private ProcessDefinitionResponse buildProcessDefinitionResponse(org.flowable.engine.repository.ProcessDefinition processDefinition)

loadDefaultProcessSchema

private String loadDefaultProcessSchema()
                                 throws IOException

Throws:

IOException

resetProcess

public ProcessResponse resetProcess(ProcessRequest request)

重置流程为默认初始化内容

initProcessDemos

public void initProcessDemos(String orgUid)

初始化演示流程模板 用于展示工单系统的流程能力

initLeaveApprovalProcess

private void initLeaveApprovalProcess(String orgUid)
                               throws IOException

初始化请假审批流程

Throws:

IOException

initReimbursementApprovalProcess

private void initReimbursementApprovalProcess(String orgUid)
                                       throws IOException

初始化报销审批流程

Throws:

IOException

initItSupportProcess

private void initItSupportProcess(String orgUid)
                           throws IOException

初始化IT支持流程

Throws:

IOException

loadDemoProcessSchema

private String loadDemoProcessSchema(String processPath)
                              throws IOException

加载演示流程模板文件

Throws:

IOException