/** * BladeX Commercial License Agreement * Copyright (c) 2018-2099, https://bladex.cn. All rights reserved. *

* Use of this software is governed by the Commercial License Agreement * obtained after purchasing a license from BladeX. *

* 1. This software is for development use only under a valid license * from BladeX. *

* 2. Redistribution of this software's source code to any third party * without a commercial license is strictly prohibited. *

* 3. Licensees may copyright their own code but cannot use segments * from this software for such purposes. Copyright of this software * remains with BladeX. *

* Using this software signifies agreement to this License, and the software * must not be used for illegal purposes. *

* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is * not liable for any claims arising from secondary or illegal development. *

* Author: Chill Zhuang (bladejava@qq.com) */ package org.springblade.flow.business.controller; import com.baomidou.mybatisplus.core.metadata.IPage; import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.Parameter; import io.swagger.v3.oas.annotations.tags.Tag; import lombok.AllArgsConstructor; import org.flowable.engine.TaskService; import org.springblade.core.launch.constant.AppConstant; import org.springblade.core.mp.support.Condition; import org.springblade.core.mp.support.Query; import org.springblade.core.tool.api.R; import org.springblade.flow.business.service.FlowBusinessService; import org.springblade.flow.core.pojo.entity.BladeFlow; import org.springblade.flow.core.utils.TaskUtil; import org.springblade.flow.engine.entity.FlowProcess; import org.springblade.flow.engine.service.FlowEngineService; import org.springframework.web.bind.annotation.*; /** * 流程事务通用接口 * * @author Chill */ @RestController @AllArgsConstructor @RequestMapping("/work") @Tag(name = "流程事务通用接口", description = "流程事务通用接口") public class WorkController { private final TaskService taskService; private final FlowEngineService flowEngineService; private final FlowBusinessService flowBusinessService; /** * 发起事务列表页 */ @GetMapping("start-list") @ApiOperationSupport(order = 1) @Operation(summary = "发起事务列表页", description = "传入流程类型") public R> startList(@Parameter(description = "流程类型") String category, Query query, @RequestParam(required = false, defaultValue = "1") Integer mode) { IPage pages = flowEngineService.selectProcessPage(Condition.getPage(query), category, mode); return R.data(pages); } /** * 待签事务列表页 */ @GetMapping("claim-list") @ApiOperationSupport(order = 2) @Operation(summary = "待签事务列表页", description = "传入流程信息") public R> claimList(@Parameter(description = "流程信息") BladeFlow bladeFlow, Query query) { IPage pages = flowBusinessService.selectClaimPage(Condition.getPage(query), bladeFlow); return R.data(pages); } /** * 待办事务列表页 */ @GetMapping("todo-list") @ApiOperationSupport(order = 3) @Operation(summary = "待办事务列表页", description = "传入流程信息") public R> todoList(@Parameter(description = "流程信息") BladeFlow bladeFlow, Query query) { IPage pages = flowBusinessService.selectTodoPage(Condition.getPage(query), bladeFlow); return R.data(pages); } /** * 已发事务列表页 */ @GetMapping("send-list") @ApiOperationSupport(order = 4) @Operation(summary = "已发事务列表页", description = "传入流程信息") public R> sendList(@Parameter(description = "流程信息") BladeFlow bladeFlow, Query query) { IPage pages = flowBusinessService.selectSendPage(Condition.getPage(query), bladeFlow); return R.data(pages); } /** * 办结事务列表页 */ @GetMapping("done-list") @ApiOperationSupport(order = 5) @Operation(summary = "办结事务列表页", description = "传入流程信息") public R> doneList(@Parameter(description = "流程信息") BladeFlow bladeFlow, Query query) { IPage pages = flowBusinessService.selectDonePage(Condition.getPage(query), bladeFlow); return R.data(pages); } /** * 签收事务 * * @param taskId 任务id */ @PostMapping("claim-task") @ApiOperationSupport(order = 6) @Operation(summary = "签收事务", description = "传入流程信息") public R claimTask(@Parameter(description = "任务id") String taskId) { taskService.claim(taskId, TaskUtil.getTaskUser()); return R.success("签收事务成功"); } /** * 完成任务 * * @param flow 请假信息 */ @PostMapping("complete-task") @ApiOperationSupport(order = 7) @Operation(summary = "完成任务", description = "传入流程信息") public R completeTask(@Parameter(description = "任务信息") @RequestBody BladeFlow flow) { return R.status(flowBusinessService.completeTask(flow)); } /** * 删除任务 * * @param taskId 任务id * @param reason 删除原因 */ @PostMapping("delete-task") @ApiOperationSupport(order = 8) @Operation(summary = "删除任务", description = "传入流程信息") public R deleteTask(@Parameter(description = "任务id") String taskId, @Parameter(description = "删除原因") String reason) { taskService.deleteTask(taskId, reason); return R.success("删除任务成功"); } }