yangys
2025-06-27 26f07223e1b33a8eb5ee184041575e9b204cfebe
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
/**
 * BladeX Commercial License Agreement
 * Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
 * <p>
 * Use of this software is governed by the Commercial License Agreement
 * obtained after purchasing a license from BladeX.
 * <p>
 * 1. This software is for development use only under a valid license
 * from BladeX.
 * <p>
 * 2. Redistribution of this software's source code to any third party
 * without a commercial license is strictly prohibited.
 * <p>
 * 3. Licensees may copyright their own code but cannot use segments
 * from this software for such purposes. Copyright of this software
 * remains with BladeX.
 * <p>
 * Using this software signifies agreement to this License, and the software
 * must not be used for illegal purposes.
 * <p>
 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
 * not liable for any claims arising from secondary or illegal development.
 * <p>
 * Author: Chill Zhuang (bladejava@qq.com)
 */
package org.springblade.flow.engine.controller;
 
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
import io.swagger.v3.oas.annotations.Hidden;
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.springblade.core.mp.support.Condition;
import org.springblade.core.mp.support.Query;
import org.springblade.core.secure.annotation.IsAdministrator;
import org.springblade.core.tenant.annotation.NonDS;
import org.springblade.core.tool.api.R;
import org.springblade.core.tool.support.Kv;
import org.springblade.core.tool.utils.Func;
import org.springblade.flow.engine.constant.FlowEngineConstant;
import org.springblade.flow.engine.entity.FlowProcess;
import org.springblade.flow.engine.service.FlowEngineService;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
 
import java.util.List;
import java.util.Objects;
 
/**
 * 流程管理接口
 *
 * @author Chill
 */
@NonDS
@RestController
@RequestMapping("/manager")
@AllArgsConstructor
@Tag(name = "流程管理接口", description = "流程管理接口")
@IsAdministrator
@Hidden
public class FlowManagerController {
 
    private final FlowEngineService flowEngineService;
 
    /**
     * 分页
     */
    @GetMapping("list")
    @ApiOperationSupport(order = 1)
    @Operation(summary = "分页", description = "传入流程类型")
    public R<IPage<FlowProcess>> list(@Parameter(description = "流程类型") String category, Query query, @RequestParam(required = false, defaultValue = "1") Integer mode) {
        IPage<FlowProcess> pages = flowEngineService.selectProcessPage(Condition.getPage(query), category, mode);
        return R.data(pages);
    }
 
    /**
     * 变更流程状态
     *
     * @param state     状态
     * @param processId 流程id
     */
    @PostMapping("change-state")
    @ApiOperationSupport(order = 2)
    @Operation(summary = "变更流程状态", description = "传入state,processId")
    public R changeState(@RequestParam String state, @RequestParam String processId) {
        String msg = flowEngineService.changeState(state, processId);
        return R.success(msg);
    }
 
    /**
     * 删除部署流程
     *
     * @param deploymentIds 部署流程id集合
     */
    @PostMapping("delete-deployment")
    @ApiOperationSupport(order = 3)
    @Operation(summary = "删除部署流程", description = "部署流程id集合")
    public R deleteDeployment(String deploymentIds) {
        return R.status(flowEngineService.deleteDeployment(deploymentIds));
    }
 
    /**
     * 检查流程文件格式
     *
     * @param file 流程文件
     */
    @PostMapping("check-upload")
    @ApiOperationSupport(order = 4)
    @Operation(summary = "上传部署流程文件", description = "传入文件")
    public R checkUpload(@RequestParam MultipartFile file) {
        boolean temp = Objects.requireNonNull(file.getOriginalFilename()).endsWith(FlowEngineConstant.SUFFIX);
        return R.data(Kv.create().set("name", file.getOriginalFilename()).set("success", temp));
    }
 
    /**
     * 上传部署流程文件
     *
     * @param files    流程文件
     * @param category 类型
     */
    @PostMapping("deploy-upload")
    @ApiOperationSupport(order = 5)
    @Operation(summary = "上传部署流程文件", description = "传入文件")
    public R deployUpload(@RequestParam List<MultipartFile> files,
                          @RequestParam String category,
                          @RequestParam(required = false, defaultValue = "") String tenantIds) {
        return R.status(flowEngineService.deployUpload(files, category, Func.toStrList(tenantIds)));
    }
 
}